Build: Made the prompts coming from the product builder to the async subagent more clear to avoid issues in the future

2026-04-13 16:14:24 -04:00
parent c5820266fd
commit c5afe1f3a7
1 changed files with 5 additions and 1 deletions
@@ -165,14 +165,18 @@ Invoke `product-verifier` to get a baseline assessment of how complete the produ

 ### Step 6: Launch All Supervisors

-Launch each supervisor via the async-agent-manager. Each supervisor's prompt must include:
+Launch all supervisor in a single batch and in parallel via the `async-agent-manager` subagent. Each supervisor's prompt must include:

 - Repository owner/name, credentials, and git identity
 - Worker count (for pool supervisors)
 - The customized briefing prepared in Step 4
+- the name of the supervisor to be launched asynchronously (you can use the `agent-type-info` subagent if you need to get a list of all supervisots)
+- the tag the supervisor should use to identify itself, which always starts with "AUTO-" (you can use `agent-prefix-info` subagent to get this information)

 The PR review pool supervisor is special: it receives the **reviewer credentials** (`FORGEJO_REVIEWER_PAT`, `FORGEJO_REVIEWER_USERNAME`, `FORGEJO_REVIEWER_PASSWORD`) instead of the primary bot credentials.

+**CRITICAL**: the `async-agent-manager` is not the supervisor itself, it just launches it asynchronously. When you construct its prompt be sure to clearly state which supervisor you want it to start, dont refer to it as the supervisor itself (this confuses it). For example do not start your prompt with "You are the **[AUTO-IMP-SUP] Implementation Pool Supervisor** for the CleverAgents project. Your session tag is `[AUTO-IMP-SUP]`." Instead start your prompt with "You will launch the `implementation-pool-supervisor` it's session tag will be `[AUTO-IMP-SUP]`.
+
 ### Step 7: Verify All Supervisors Running

 Immediately after launching, check each supervisor by searching for its tag. Every supervisor must exist and be in a busy state. If any failed to launch, retry them.