phased-implement

Coordinate multi-phase implementation across workmux worktrees. The coordinator owns the master plan, phase dispatch, merge order, ancestry checks, final integration validation, and final summary. The coordinator does not edit source files for feature work.

Do not use Claude Code built-in worktree features. Use workmux for worktree orchestration.

Operating principles

• Coordinator never writes source. All implementation happens inside spawned worktree agents through /implement.
• workmux done is not success. A phase succeeds only when its result sentinel reports status: success and the coordinator verifies it.
• Merges are serialized. At most one /merge --keep runs at a time.
• Dependents spawn only after every dependency is merged. No exceptions.
• Drain completed handles before dispatching dependents. workmux wait --any can return after one transition while sibling phases also finished.
• Use bounded waits. Avoid tight polling and inspect workmux status on timeouts.
• Preserve failed and blocked worktrees for inspection. Remove worktrees only after merge and ancestry verification succeed.
• Treat merge conflicts as merge failures for that phase, not as reasons to destroy the worktree.
• Read the master plan YAML semantically. Do not write shell parsers for YAML.
• Keep all coordinator artifacts in one shared history/<date>-phased-<slug>/ run directory so worktrees can read prompts and write sentinels.

Argument handling