flow.implement

Critical Rules

1. NEVER edit tasks.md directly to mark tasks complete - use specflow mark T###
2. NEVER edit .specflow/orchestration-state.json directly - use specflow state set
3. TDD by default: Write tests first, then implement (use --no-tdd to skip)
4. Use specflow directly, NOT npx specflow - It's a local CLI, not an npm package

User Input

$ARGUMENTS

Arguments

Argument	Description
(empty)	Execute all tasks with TDD workflow
--no-tdd	Skip test-first approach (not recommended)
continue	Resume from last incomplete task

Prerequisites

Requirement	Check Command	If Missing
Design gate passed	specflow check --gate design	Run /flow.design
tasks.md exists	specflow status --json → context.hasTasks	Run /flow.design
Constitution	.specify/memory/constitution.md	Run /flow.init
Git branch	git branch --show-current	Should be on phase branch

Execution

1. Initialize

Create todo list immediately (use TodoWrite):

1. [IMPL] INITIALIZE - Verify design gate and load context
2. [IMPL] EXECUTE - Implement all tasks from tasks.md
3. [IMPL] COMPLETE - Verify implementation gate

Set [IMPL] INITIALIZE to in_progress.

specflow status --json

Parse response:

• context.featureDir → FEATURE_DIR (abort if null)
• context.hasTasks → must be true
• progress.tasksTotal → verify tasks exist

specflow check --gate design

Abort if gate fails - instruct user to run /flow.design first.

Update state (respecting orchestrate ownership):

CURRENT_STEP=$(specflow state get orchestration.step.current 2>/dev/null)

# Only set step.current if not already set (standalone mode)
# Orchestrate owns step transitions - sub-commands only update status
if [[ -z "$CURRENT_STEP" || "$CURRENT_STEP" == "null" ]]; then
  specflow state set orchestration.step.current=implement orchestration.step.index=2
fi

specflow state set orchestration.step.status=in_progress

# Initialize implementation domain (for progress tracking/compaction recovery)
specflow state set orchestration.implement.started_at=$(date -Iseconds)
specflow state set orchestration.implement.current_section=""