Agent-Skills.md

Agent Skills: Sprint Planning + Execution

Automated sprint planning and execution from technical specifications (prompt generation, dependency planning, stateful execution)

UncategorizedID: cruzanstx/daplug/sprint

Repository

cruzanstx/daplug
cruzanstx
4

Install this agent skill to your local

pnpm dlx add-skill https://github.com/cruzanstx/daplug/tree/HEAD/skills/sprint

Skill Files

Browse the full folder contents for sprint.

Download Skill

Loading file tree…

skills/sprint/SKILL.md

Skill Metadata

Name
sprint
Description
Automated sprint planning and execution from technical specifications (prompt generation, dependency planning, stateful execution)

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

# 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