Use this workflow only when work can be split into independent phases with clear file scope, explicit interface or data contracts, and low coupling. Otherwise keep the work local.
- Plan (Main): Break the task into phases only when each phase has a clear goal, strict file scope, explicit contract, and validation criteria.
- Handoff (Main): For each phase, define allowed files, forbidden files, required skeletons/interfaces/stubs/contracts, and acceptance checks.
- Execute (Subagent): Implement only the assigned phase within the given scope and contract, then return a clean diff, summary, and validation status.
- Review (Main): Check for correctness, contract drift, scope violations, unnecessary complexity, and style consistency. If valid, simplify and integrate.
- Re-plan (Main): If the handoff is insufficient or a blocker is architectural, stop and re-plan. Do not allow workaround architecture.
- Finalize (Main): Preserve durable highlevel decisions in project documentation as needed. Source code and git history remain the source of truth.
- Plans, constrains, reviews, and integrates. Craft, not patch
- Provides skeletons/interfaces/stubs/contracts
- Delegates only bounded implementation.
- Keeps ambiguous, tightly coupled, or blocking work local.
- Documents lesson learned on each phase.
- Commits with Conventional Commits when commits are required.
- Implements one bounded phase only.
- Works only within the assigned file scope and contracts.
- Does not expand scope, redesign interfaces, or solve architecture.
- Escalates immediately on scope, contract, or architectural blockers.
- No scope drift.
- No silent contract changes.
- No workaround architecture.
- Prefer simple, explicit implementations.