sprint

# Sprint Planning + Execution

This skill turns a technical specification into:
- Prompt files (ready for `/run-prompt`)
- A dependency-aware execution plan (`sprint-plan.md`)
- A persistent state file (`.sprint-state.json`) for long-running execution

## CLI

### Main command

```bash
# From a spec (generates new prompts)
python3 skills/sprint/scripts/sprint.py <spec-file-or-text> [options]

# From existing prompts (no spec argument)
python3 skills/sprint/scripts/sprint.py --from-existing [options]
```

Options:
- `--output-dir DIR` (default: `./prompts/`) Where to write generated prompt files
- `--plan-file FILE` (default: `./sprint-plan.md`) Where to write the plan markdown
- `--dry-run` Generate plan without creating prompt files or state
- `--from-existing` Analyze existing prompts in `--output-dir` instead of generating from a spec
- `--prompts LIST` Include only specific prompts (e.g., `001-005,010`)
- `--folder PATH` Only include prompts from this subfolder of `--output-dir` (e.g., `providers/`)
- `--exclude LIST` Exclude specific prompts (e.g., `003,007`)
- `--auto-execute` Execute phases immediately, updating `.sprint-state.json`
- `--models LIST` Comma-separated models (default: `claude,codex,gemini`)
- `--max-parallel N` Max concurrent prompts per phase (default: `5`)
- `--worktree` Use worktree isolation when auto-executing
- `--loop` Use verification loops when auto-executing
- `--max-iterations N` (default: `3`) Verification loop max iterations
- `--completion-marker TEXT` (default: `VERIFICATION_COMPLETE`) Loop completion marker
- `--state-file FILE` (default: `.sprint-state.json`) State file path
- `--json` Print JSON output (plan + state summary)

### Sub-commands

```bash
python3 skills/sprint/scripts/sprint.py status
python3 skills/sprint/scripts/sprint.py add "Implement caching layer"
python3 skills/sprint/scripts/sprint.py remove 005
python3 skills/sprint/scripts/sprint.py replan
python3 skills/sprint/scripts/sprint.py pause
python3 skills/spri