Template

Files

lmiranda bea46d7689 feat(projman): add sprint lifecycle state machine via milestone metadata

- New skill: sprint-lifecycle.md defines states, transitions, and check protocol
- All sprint commands now check and set lifecycle state
- States tracked in milestone description metadata (Sprint/Planning, Sprint/Executing, Sprint/Reviewing)
- Out-of-order calls produce warnings with guidance
- --force override available for all lifecycle checks
- Added Sprint/* labels to label taxonomy documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-02 13:48:13 -05:00

2.3 KiB

Raw Blame History

description, agent

description	agent
Start sprint planning with AI-guided architecture analysis and issue creation	planner

Sprint Planning

Skills Required

skills/mcp-tools-reference.md
skills/branch-security.md
skills/repo-validation.md
skills/input-detection.md
skills/lessons-learned.md
skills/wiki-conventions.md
skills/task-sizing.md
skills/issue-conventions.md
skills/sprint-approval.md
skills/planning-workflow.md
skills/label-taxonomy/labels-reference.md
skills/sprint-lifecycle.md

Purpose

Initiate sprint planning session. The planner agent validates prerequisites, gathers requirements, searches lessons learned, creates wiki pages, and creates well-structured Gitea issues with proper dependencies and labels.

Invocation

Provide sprint goals as natural language input, or prepare input via:

docs/changes/*.md file with frontmatter
Existing wiki proposal page
Direct conversation

Workflow

Execute the planning workflow as defined in skills/planning-workflow.md.

Key steps: 0. Check Lifecycle State - Execute skills/sprint-lifecycle.md check protocol. Expect idle state. Set Sprint/Planning after planning completes. Warn and stop if sprint is in another active state (unless --force).

Run pre-planning validations (branch, repo org, labels)
Detect input source (file, wiki, or conversation)
Search relevant lessons learned
Create/update wiki proposal and implementation pages
Perform architecture analysis
Create Gitea issues with wiki references (respecting task sizing rules)
Set up dependencies
Create or select milestone
Request explicit sprint approval

Visual Output

╔══════════════════════════════════════════════════════════════════╗
║  📋 PROJMAN                                                      ║
║  🎯 PLANNING                                                     ║
║  [Sprint Name]                                                   ║
╚══════════════════════════════════════════════════════════════════╝

2.3 KiB Raw Blame History