Do

Dispatch the implementation supervisor for a bead task. Handles supervisor resolution, branch management, and dispatch with full investigation context.

If bead ID provided: use it directly.

If no bead ID provided:

1. Run bd ready --json to get unblocked tasks
2. Present the list showing: ID, title, priority, and labels
3. Pick by order and priority; if unclear, ask the user</on-init>

Ask: "Do you want to run /investigate {BEAD_ID} first, or proceed without investigation?"

• If user wants investigation → stop and recommend /investigate
• If user proceeds → continue to dispatch</on-check-fail>

Step 1: Read Full Bead Context

1. Parse bead JSON. Extract: description, acceptance, design, notes, status, parent, labels
2. If bead is an epic child (BEAD_ID contains a dot):
   • Extract EPIC_ID, read the epic, extract design doc path
   • Read the design doc content — this is the implementation contract
3. Store all context for the dispatch prompt

Step 2: Resolve Supervisor

1. Read the assignee field from the bead JSON — this contains the supervisor name (e.g., rust-supervisor)
2. If assignee is set and non-empty:
   • Verify the agent file exists: .claude/agents/{assignee}.md
   • If found → supervisor resolved
   • If NOT found → warn user, fall through to manual selection
3. If assignee is empty or unset:
   • List available supervisors: find all *-supervisor.md in .claude/agents/
   • Present the list
   • Inform: "If the supervisor you need is not listed, create one with /add-supervisor {technology}."
   • Ask: "Which supervisor should handle this task?"
   • If user wants to create → stop and suggest /add-supervisor, then re-run /do

Step 3: Check Branch State

git branch -a | grep {BEAD_ID}

If branch exists:

• Inform user: "A branch already exists: {branch-name}. This may be from a previous implementation attempt."
• Ask: "Continue on the existing branch, or create a fresh branch?"
• Include context in dispatch prompt

If no branch exists:

• Ask: "Which branch should I base from? (default: main)"
• Store as {BASE_BRANCH}

Step 4: Dispatch Implementation Supervisor

1. Announce before dispatching:

   Dispatching {resolved-supervisor} for {BEAD_ID}: "{bead title}"

2. Dispatch using exactly these parameters — no more, no less:

   Agent(
       subagent_type="{resolved-supervisor}",
       prompt="Implement BEAD {BEAD_ID}. [Include EPIC_ID if epic child]. Base branch: {BASE_BRANCH} — run `git checkout {BASE_BRANCH}` before creating your feature branch. Read the bead (bd show {BEAD_ID}) and comments (bd comments {BEAD_ID}) for full context — description, acceptance criteria, design notes, and investigation findings."
   )

   Do NOT add extra parameters unless the user explicitly requests it.
3. The PreToolUse hook automatically injects the discipline reminder because the agent name ends in -supervisor.

1. Headline: "{bead title} — implementation complete" in plain language
2. What was done: 1-2 sentences summarizing what the supervisor built — translate the COMPLETED bead comment into natural language, don't paste raw
3. Branch and PR: show branch name and PR URL (look for PR: in the completion report or bead comments)
4. Decisions/Deviations: if the supervisor logged DECISION or DEVIATION comments, explain each in plain language — what choice was made, why, and what the alternative was
5. Next step: recommend /review {BEAD_ID}
6. Technical details: raw COMPLETED comment and file list in a <details> block</on-complete>