Version
Current: 1.16.0
Update this version when templates change: - Major (2.0.0): Breaking changes to file structure - Minor (1.1.0): New sections, updated rules - Patch (1.0.1): Typo fixes, clarifications
Sprint Initialization Skill
Initialize a sprint with kanban-style structure for multi-agent collaboration.
Overview
This skill creates the structure only (empty backlog). Use /sprint:add-backlog to add work items.
Generated structure:
sprints/<sprint-name>/
├── BACKLOG.md # Work items (Feature → Task → Sub-task)
├── HANDOFF.md # Work Board (current status)
├── INSTRUCTION.md # Agent guidelines
├── personas/ # Agent persona files (character templates)
├── active/ # Feature-specific contexts (temporary)
└── refs/
├── designs/ # Feature design documents
├── plans/ # Task execution plans
├── decisions/ # Decisions (per-feature + _sprint.md for sprint-wide)
├── lessons/ # Lessons (per-feature + _sprint.md for sprint-wide)
└── archive/ # Completed features (moved from BACKLOG.md)Workflow
Phase 1: Gather Information
Ask the user:
- Sprint name - What should we call this sprint?
- Suggest kebab-case format (e.g., payment-system, auth-refactor)
- Location - Where should we create it?
- Default: sprints/<sprint-name>/ - Allow custom path if needed
- Team (optional) - Who will work on this?
- Persona names: #rook, #pixel, #dash, or custom names - If not specified, use default #agent
- Mode - How do you want to manage code?
- default - Sprint and code in same working directory (existing behavior) - worktree - Each Feature gets its own git worktree - Sprint files stay in main worktree (Single Source of Truth) - Code work happens in separate worktrees per Feature - If worktree selected: Add sprint path to .gitignore
- Worktree creation method (worktree mode only)
- "How should worktrees be created?" - Default: git worktree add (recommended) - Custom: User provides command template - "Where should worktrees be placed?" - Suggest: ../<project>-worktrees/ (outside main repo) - Allow custom path prefix
Phase 2: Create Structure
Create the following files from templates:
- BACKLOG.md from
assets/templates/BACKLOG-TEMPLATE.md
- Empty backlog structure - Ready for features to be added
- HANDOFF.md from
assets/templates/HANDOFF-TEMPLATE.md
- Work Board format - In Progress / In Review tables
- INSTRUCTION.md from
assets/templates/INSTRUCTION-TEMPLATE.md
- Multi-agent workflow - Session start/end procedures - If team specified, add team section
- active/ folder
- Create empty folder - Add README explaining purpose
- refs/ structure
- refs/designs/ with README - refs/plans/ with README - refs/decisions/ with README + _sprint.md (sprint-wide decisions) - refs/lessons/ with README + _sprint.md (sprint-wide lessons) - refs/archive/ with README (for completed features)
- Version file
- Create .sprint-version with current template version (from ## Version section above) - Format: just the version number (e.g., 1.0.0)
- .sprint-config
- JSON config storing sprint mode and worktree settings - Created for both modes (to make mode explicit)
- personas/ folder Default mode:
{"mode": "default"}Worktree mode:{"mode": "worktree", "sprintRoot": "<absolute-path-to-sprint-dir>", "worktree": {"command": "git worktree add {path} -b {branch}", "pathPrefix": "../<project>-worktrees"}}
- Copy all persona files from plugin assets/personas/ to sprint personas/ - These are character templates agents adopt during sessions - Users can customize or add new personas after init - worktree.command: Worktree creation command - Default: "git worktree add {path} -b {branch}" - Custom example: "./scripts/create-worktree.sh {branch} {path}" - Placeholders: {path} = worktree path, {branch} = branch name - worktree.pathPrefix: Parent path where worktrees are created - Default: "../<project>-worktrees" - Feature worktrees are created under this path
Worktree mode additional steps:
- Add sprint path to project
.gitignore - Include Sprint Root absolute path + Worktree Mode section in INSTRUCTION.md
Phase 3: Confirm
Show created structure and explain next steps:
Default mode:
Sprint created at: sprints/<sprint-name>/
Files:
- BACKLOG.md - Add work items with /sprint:add-backlog
- HANDOFF.md - Work board (current status)
- INSTRUCTION.md - Start work sessions with @INSTRUCTION.md #persona-name
Next steps:
1. Add work items: /sprint:add-backlog
2. Start working: @INSTRUCTION.md #rookWorktree mode:
Sprint created at: sprints/<sprint-name>/ (worktree mode)
Files:
- BACKLOG.md - Add work items with /sprint:add-backlog
- HANDOFF.md - Work board (current status)
- INSTRUCTION.md - Start work sessions with @INSTRUCTION.md #persona-name
- .sprint-config - Sprint configuration (mode: worktree)
Sprint path added to .gitignore (sprint files are not git-tracked).
Next steps:
1. Add work items: /sprint:add-backlog
2. Start working: @INSTRUCTION.md #rookAssets
assets/templates/BACKLOG-TEMPLATE.md- Backlog structureassets/templates/HANDOFF-TEMPLATE.md- Work Board templateassets/templates/INSTRUCTION-TEMPLATE.md- Agent guidelinesassets/templates/FEATURE-DESIGN-TEMPLATE.md- Feature design docassets/templates/TASK-PLAN-TEMPLATE.md- Task plan docassets/templates/ACTIVE-FEATURE-TEMPLATE.md- Active feature contextassets/refs/designs-README.md- README for designs folderassets/refs/plans-README.md- README for plans folderassets/refs/decisions-README.md- README for decisions folderassets/refs/lessons-README.md- README for lessons folderassets/refs/archive-README.md- README for archive folderassets/personas/rook.md- Pragmatist backend engineerassets/personas/pixel.md- Detail-obsessed frontend engineerassets/personas/dash.md- Enthusiastic fullstack prototyperassets/personas/slate.md- Conservative infrastructure engineerassets/personas/echo.md- Socratic discussion facilitatorassets/personas/thorn.md- Uncompromising code reviewer