subagent-dev

Execute a plan using subagent-driven development for: $ARGUMENTS

Iron Law

The controller coordinates. Subagents implement. Never mix roles.

The controller agent (you) MUST NOT write production code directly. You dispatch subagents for each task, review their work, and coordinate the overall plan.

Architecture

Controller (you)
  ├── Read the plan
  ├── For each task:
  │   ├── Dispatch Implementer subagent (fresh context)
  │   ├── Dispatch Spec Reviewer subagent
  │   ├── Dispatch Quality Reviewer subagent
  │   └── Handle status (DONE / CONCERNS / BLOCKED)
  └── Verify all tests pass at the end

Steps

1. Load the Plan

Read task_plan.md or the user's task list. Extract all tasks with:

• Task description
• Files involved
• Dependencies (what must complete first)
• Acceptance criteria

2. Execute Each Task

For each task (respecting dependency order):

A. Dispatch Implementer

Launch a subagent with Agent tool:

Prompt: "Implement [task description].
Files to modify: [list]
Pattern to follow: [reference file]
Acceptance criteria: [criteria]
Run tests after implementation."

Use model: "sonnet" for mechanical tasks, model: "opus" for complex architecture.

B. Check Implementer Status

The implementer should report one of:

C. Two-Stage Review

Stage 1 — Spec Compliance (must pass first):

• Does the implementation match the task description?
• Are all acceptance criteria met?
• Were the correct files modified?

Stage 2 — Code Quality (only after Stage 1 passes):

• Does it follow existing codebase patterns?
• Are there security issues?
• Is the code clean and maintainable?

If either review fails, send feedback to a new implementer subagent for fixes.

3. Verify Everything

After all tasks are done:

# Run full test suite
[test command]

# Check for uncommitted changes
git status

4. Report

## Subagent Execution Report

### Tasks Completed: X/Y
| Task | Status | Implementer | Review |
|------|--------|-------------|--------|
| [task] | DONE | Pass | Pass |

### Files Changed
- [file list]

### Concerns Raised
- [any DONE_WITH_CONCERNS items]

### Blocked Items
- [any BLOCKED items with reasons]

Anti-Rationalization