implement

Start Execution

You are starting the task execution loop.

Determine Active Feature

1. Read .specify/.current-feature to get active feature (format: <id>-<name>)
2. If file missing or empty: error "No active feature. Run /speckit:start first."

Validate Prerequisites

1. Check .specify/specs/$feature/ directory exists
2. Check .specify/specs/$feature/tasks.md exists. If not: error "Tasks not found. Run /speckit:tasks first."

Parse Arguments

From $ARGUMENTS:

• --max-task-iterations: Max retries per task (default: 5)
• --recovery-mode: Enable iterative failure recovery (default: false). When enabled, failed tasks trigger automatic fix task generation instead of stopping.

Commit Uncommitted Spec Files

Before starting execution, check if spec files are uncommitted:

git status --porcelain .specify/specs/$feature/

If uncommitted files exist, commit them:

git add .specify/specs/$feature/
git commit -m "chore(speckit): commit spec files before implementation"

This ensures spec files are tracked before task execution begins.

Initialize Execution State

1. Count total tasks in tasks.md (lines matching - [ ] or - [x])
2. Count already completed tasks (lines matching - [x])
3. Set taskIndex to first incomplete task
4. Read featureId and name from feature directory name (format: <id>-<name>)

Write .specify/specs/$feature/.speckit-state.json:

{
  "featureId": "<3-digit id>",
  "name": "<feature-name>",
  "basePath": ".specify/specs/<id>-<name>",
  "phase": "execution",
  "taskIndex": <first incomplete>,
  "totalTasks": <count>,
  "taskIteration": 1,
  "maxTaskIterations": <parsed from --max-task-iterations or default 5>,
  "globalIteration": 1,
  "maxGlobalIterations": 100,
  "awaitingApproval": false,
  "recoveryMode": <true if --recovery-mode flag present, false otherwise>,
  "maxFixTasksPerOriginal": 3,
  "fixTaskMap": {}
}

Start Execution

After writing the state file, output the coordinator prompt below. This starts the execution loop. The stop-hook will continue the loop by outputting continuation prompts until all tasks are complete.