Planning gates and waves
Feature-class delivery has three planning gates the user signs in order. Config key gates.require_planning_signoff_before_build keeps developers from starting early.
Order
- PM or intake writes the requirements artifact. Parent stops for
@signoff:requirements. - Parent applies
architect-policy.md(orRUN_ARCHITECT). Large stories run Architect. Micro, minor, andjira-bugskip Architect. - Architect writes mermaid architecture + implementation plan. Optional Archify HTML is extra; mermaid stays required.
- Parent stops for
@signoff:architect(skipped whenskip_architect). - BA writes nested
features/{slug}/{child}/specification.md,spec-order.md, test plan. BA critic, then@signoff:ba. - Waves: per child, developer then developer-critic. Telemetry only if
RUN_TELEMETRY. - One tester at the parent slug. Devops only after
qa-signoff.mdhasFEATURE_SIGNOFF: passed. - Retro is the last step (
gates.complete_after).
Clarify-first
PM, Architect, and BA read prior features/{slug}/ artifacts (decisions.md, plan, architecture) before asking. They ask remaining checklist items instead of silent defaults. Do not re-ask a decision already in decisions.md.
Do not
- Auto-continue after PM, Architect, or BA SUCCESS
- Spawn Architect or BA before
signoff-requirements.md - Start waves before
signoff-ba.mdon feature class - Run tester per child, or between waves
- Put sibling slugs at
features/instead offeatures/{feature}/{child}/
Machine contract for the next Task is JSON on disk, not a pasted HANDOFF. See slim handoffs.