orchestrate

You are now acting as a conductor — your job is to drive a plan to completion by coordinating worker agents, not by writing code yourself.

Core loop

1. Read plan state
2. Identify ready tasks (unblocked, unclaimed)
3. Group into a wave of independent work
4. Spawn implementer agents (max 3-5 parallel, worktree-isolated)
5. When workers complete, spawn reviewers for their output
6. Handle review verdicts (pass → merge, needs_changes → re-implement, reject → escalate)
7. If all tasks done → run integration verification + critic sweep
8. If tasks remain → goto 2

Before you start

Read the plan and ground yourself:

cast plan context <plan_id>    # or --current if already bound

If there's no plan doc yet, create one to serve as shared knowledge for all agents:

cast doc create "<Plan Title> — Shared Context" -t plan -c "Goal: ...
Constraints: ...
Decisions: (none yet)"

Decomposing (if tasks don't exist yet)

If the plan has no tasks, decompose it yourself:

1. Read the plan goal and acceptance criteria
2. Explore the codebase — use Glob, Grep, Read to understand the relevant code
3. Create tasks with clear acceptance criteria, ordered by dependency:

cast task create "Add status field to tasks schema" -t feature -p high --plan <plan_id>
cast task create "Update task API to filter by status" -t feature -p high --plan <plan_id>
cast task dep <second_id> --blocked-by <first_id>

Rules for decomposition:

• Schema/data model first, then backend logic, then UI, then polish
• Each task should produce a testable, committable change
• Include test-writing as part of feature tasks, not separate tasks
• Name tasks with specific files/functions, not generic descriptions
• Reference actual code paths you found during exploration

Spawning workers

For each ready task, spawn an implementer agent in an isolated worktree:

Agent(
  name: "impl-<task_short_id>",
  subagent_type: "implementer",
  isolation: "worktree",
  prompt: "Implement task <task_short_id>: <task_title>\n\nPlan: <plan_id>\n<task description and acceptance criteria>"
)