| name | sprint |
| description | Creates or advances sprints in prd.json. Use when starting new work cycles or closing completed sprints. |
| triggers | ["sprint"] |
| allowed-tools | Read, Write, Edit, TaskCreate, TaskUpdate, TaskList |
| model | opus |
| user-invocable | true |
| argument-hint | [new|advance|close] |
Sprint
Create a new sprint or advance to the next one.
Usage
sprint [description] - Create new sprint from feature description
sprint next - Advance to next sprint from roadmap
Creating from Description
- Parse $ARGUMENTS as feature description
- Generate epic prefix from description
- Create/update prd.json with new sprint
- Generate 10-20 stories via TaskCreate with full metadata (see core skill for schema):
TaskCreate({
subject: "[verb] [specific deliverable]",
description: "## What\n[Exactly what to build]\n\n## Acceptance Criteria\n- [ ] [Testable outcome]\n- [ ] Build passes\n- [ ] No type errors\n\n## Files\n- `src/path/file.ts` - [what to change]",
activeForm: "[Building|Adding] [short desc]",
metadata: {
sid: "[PREFIX]-[NNN]",
sprint: currentSprint,
epic: "[epic name]",
priority: [1-3],
category: "[auth|ui|perf|security|qa|infra]",
type: "feature",
passes: null,
verified: null
}
})
- Include file paths, patterns to follow
- Set dependencies between stories
- Report sprint summary
Advancing (sprint next)
- Read prd.json
- Mark current sprint as "done"
- Find next unscheduled roadmap epic(s)
- Create new sprint with stories from those epics
- Update prd.json
Auto-Archive Check
Before creating a new sprint, check if prd.json needs archiving:
node -e "try{const p=require('./prd.json');const sprints=p.sprints||[];const done=sprints.filter(s=>s.passes===true||s.stories?.every(st=>st.passes===true||st.passes==='deferred'));console.log('completed:',done.length,'total:',sprints.length,'lines:',JSON.stringify(p).split(',').length)}catch{}"
| Condition | Action |
|---|
| 3+ completed sprints in prd.json | Suggest archive before creating new sprint |
| prd.json > 500 lines | Warn: "prd.json is large, consider archive first" |
Large prd.json wastes tokens on every request. Run the check.
Rules
- HARD CAP: 20 stories per sprint
- Stories must be detailed enough to implement without guessing
- Every story must be testable
- If user asks to "expand", explain roadmap and offer
sprint next