implement-phase

Implement Phase

Execute a single phase from an implementation plan with comprehensive quality gates. Designed to be called by implement-plan, but can also be invoked directly.

---

Orchestrator pattern (non-negotiable)

This session is an orchestrator. Never implement code directly.

DO (orchestrator)	DON'T (direct implementation)
Spawn subagents to write code	Write code yourself
Spawn subagents to create files	Use Write/Edit tools directly
Spawn subagents to run tests	Run tests yourself
Spawn subagents to fix issues	Fix code yourself
Read files to understand context	Read files to copy/paste code
Track progress with Task tools	Implement while tracking
Coordinate and delegate	Do the work yourself

Violations: using Write/Edit/NotebookEdit directly, creating files without spawning a subagent, fixing code without spawning a subagent, running implementation commands directly.

Why orchestrate?

• Context preservation — main session retains full plan context.
• Parallelization — independent tasks run concurrently.
• Clean separation — orchestration logic stays separate from implementation.
• Better error handling — subagent failures don't pollute main context.

Subagent communication protocol → references/subagent-protocol.md. Every subagent prompt must include a response-format block demanding terse STATUS/FILES/ERRORS output and disk-based logs for large output. Verbose subagent responses are the single biggest context waster this skill faces.

---

Execution contract (read before starting)

Steps 1–8 execute as one continuous operation. The orchestrator does not pause between them.

current_step = 1
while current_step <= 8:
    result = execute_step(current_step)
    if result == PASS:
        current_step += 1          # AUTO-CONTINUE, no user pause
    elif result == FAIL:
        fix_and_retry(current_step)  # Stay on step, spawn fix subagent, retry
    elif result == BLOCKED:
        return BLOCKED               # Only valid early exit
return COMPLETE                      # Only stop here (after Step 8)