sprint

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

# 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

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/sprint/scripts/sprint.py resume
python3 skills/sprint/scripts/sprint.py cancel --yes
python3 skills/sprint/scripts/sprint.py history

Notes:

• Sub-commands operate on .sprint-state.json in the current directory unless --state-file is provided.
• cancel is destructive for sprint-created worktrees (it removes worktree directories/branches recorded in state).

Examples

# Analyze all prompts in prompts/
python3 skills/sprint/scripts/sprint.py --from-existing --dry-run

# Only specific prompts
python3 skills/sprint/scripts/sprint.py --from-existing --prompts 001-005,010 --dry-run

# Only prompts in a subfolder
python3 skills/sprint/scripts/sprint.py --from-existing --folder providers/ --dry-run

# Exclude certain prompts
python3 skills/sprint/scripts/sprint.py --from-existing --exclude 003,007 --dry-run

# Combine with execution options
python3 skills/sprint/scripts/sprint.py --from-existing --worktree --loop --auto-execute