Sprint

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

1. Parse $ARGUMENTS as feature description
2. Generate epic prefix from description
3. Create/update prd.json with new sprint
4. 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
5. Report sprint summary

Advancing (sprint next)

1. Read prd.json
2. Mark current sprint as "done"
3. Find next unscheduled roadmap epic(s)
4. Create new sprint with stories from those epics
5. Update prd.json

Auto-Archive Check

Before creating a new sprint, check if prd.json needs archiving:

# Count completed sprints. Object.values() handles stories as the id-keyed OBJECT
# core documents as well as an array — .every on an object threw, the catch ate it,
# and this printed nothing at all.
# "complete" = no agent-actionable story left (prd-states.js isActionable): needs-setup is blocked on a HUMAN, not on this sprint's engineering, and archive-prd's keep-list retains those stories — so one credential-blocked leftover must not stop the archive suggestion from ever firing.
node -e "try{const p=require('./prd.json');const sprints=p.sprints||[];const done=sprints.filter(s=>{const st=Object.values(s.stories||{});return s.passes===true||(st.length>0&&st.every(x=>x.passes===true||x.passes==='deferred'||x.passes==='needs-setup'))});console.log('completed:',done.length,'total:',sprints.length,'lines:',JSON.stringify(p).split(',').length)}catch(e){console.log(e.code==='MODULE_NOT_FOUND'?'no prd.json yet - nothing to archive':'archive check failed: '+e.message)}"

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