Agent skill

sprint

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

View SKILL.md on GitHub Repository
Stars 6
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/cruzanstx/daplug/tree/main/skills/sprint

SKILL.md

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/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

bash
# 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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

cruzanstx/daplug

at-prompt-runner

Orchestrate multi-prompt execution with phase groups, optional auto-deps, and model-tiered agent roles.

6 0
Explore
cruzanstx/daplug

prompt-finder

Find and resolve prompt files in ./prompts/ directory. Use when user asks to find a prompt, list available prompts, locate prompt by number or name, or check what prompts exist.

6 0
Explore
cruzanstx/daplug

at-prompt-creator

Create agent-team orchestrated prompt bundles (orchestrator + sub-prompts) and store them through prompt-manager.

6 0
Explore
cruzanstx/daplug

cli-detector

Detect installed AI coding CLIs and local model providers; outputs a cached JSON inventory for routing (/detect-clis).

6 0
Explore
cruzanstx/daplug

prompt-executor

Execute prompts from ./prompts/ directory with various AI models. Use when user asks to run a prompt, execute a task, delegate work to an AI model, run prompts in worktrees/tmux, or run prompts with verification loops.

6 0
Explore
cruzanstx/daplug

ai-usage

Check AI CLI usage/quota for Claude Code, OpenAI Codex, Google Gemini CLI, and Z.AI. Use when user asks about remaining quota, usage limits, rate limits, or wants to check how much capacity is left.

6 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results