Feature-Build Workflow

Architecture-first sliced delivery for new capabilities.

~20+ phasesFEATURE_SHIPPED--pr supported

Pipeline

Per-Slice Loop

Each slice goes through its own five-phase cycle before all slices converge in INTEGRATION.

Phase Summary

Hover over any phase name to see what it does in detail.

#PhasePurposeKey Output
1INTAKECollect feature request, parse ticketINTAKE.md
2TICKET_GATEValidate Jira ticket and linked story maturityTICKET_GATE.md
3FIGMA_CONTEXTFetch design context (non-blocking)FIGMA_CONTEXT.md
4LANDSCAPEMap surrounding system where feature will liveLANDSCAPE.md
5RECALLPattern match from knowledge baseRECALL.md
6API_SURVEYIdentify all external APIs and dependenciesAPI_SURVEY.md
7CODE_TRACETrace integration points in existing codeCODE_TRACE.md
8BLAST_RADIUS_MAPMap all areas affected by the new featureBLAST_RADIUS_MAP.md
9REQUIREMENTSDefine acceptance criteria for complete featureREQUIREMENTS.md
10TEST_INVENTORYDocument existing tests in the feature areaTEST_INVENTORY.md
11DEPENDENCY_GATEEvaluate each dependency: READY / MOCKED / BLOCKEDDEPENDENCY_GATE.md
12ARCHITECTUREFull system architecture designARCHITECTURE.md
13SLICE_PLANBreak feature into independently deliverable slicesSLICE_PLAN.md
14SCAFFOLDCreate file structure and stubs for slicePer-slice
15BASELINERun tests before slice implementationPer-slice
16TEST_GENWrite tests for slice behavior (Category A)Per-slice
17IMPLEMENTBuild slice, feature flag gatedPer-slice
18VERIFY_SLICEConfirm slice works in isolationPer-slice
19INTEGRATIONVerify all slices work togetherINTEGRATION.md
20VERIFY_ALLFull test suite with flag ON and OFFVERIFY_ALL.md
21BLAST_RADIUS_RUNFull regression suiteBLAST_RADIUS_RUN.md
22CLOSESummarize, update Jira, create QE sub-task, PR if --prCLOSE.md
23LEARNUpdate knowledge storesLEARN.md

Key Processes

Dependency Gate

Every external dependency gets one of three statuses:

StatusMeaningAction
READYAvailable and testedUse directly
MOCKEDNot availableCreate mock, track with TODO
BLOCKEDCannot proceed, cannot mockAdd to BLOCKERS.md

Ticket Gate

TICKET_GATE validates 8 required fields + 5 recommended. Fetches linked stories to check dependency maturity, interface contracts, and transitive blockers. Use /feature-build PROJ-123 --jira-check to run this check without starting the workflow — it drafts concrete fixes for each gap and can update the ticket for you.

Per-Slice Iteration

Each slice follows SCAFFOLD → BASELINE → TEST_GEN → IMPLEMENT → VERIFY_SLICE. Slices are independently deliverable vertical cuts.

Integration Testing

After all slices, INTEGRATION verifies cross-slice interactions. VERIFY_ALL runs full suite with feature flag ON and OFF.

Feature Flags

ALL new code must be behind a feature flag (default OFF). Both ON and OFF states tested in VERIFY_ALL.

Dual Loopbacks

REARCHITECT (from VERIFY_ALL) loops back to ARCHITECTURE. RESLICE (from INTEGRATION) loops back to SLICE_PLAN.

Signal Flow

SignalTypeMeaning
PHASE_COMPLETEadvancePhase done, advance
BLOCKED_NEEDS_HUMANblockCannot proceed
SCOPE_ESCALATIONblockScope larger than expected
DEPENDENCY_BLOCKEDblockExternal dependency unavailable
REARCHITECTloopbackArchitecture invalid, back to ARCHITECTURE
RESLICEloopbackSlice plan needs restructuring
FEATURE_SHIPPEDterminalWorkflow complete

Loopback Paths

REARCHITECT

RESLICE