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

3.4 KiB

Raw Blame History

description, agent

description	agent
Complete sprint and capture lessons learned to Gitea Wiki	orchestrator

Close Sprint and Capture Lessons Learned

Skills Required

skills/mcp-tools-reference.md
skills/lessons-learned.md
skills/wiki-conventions.md
skills/rfc-workflow.md
skills/progress-tracking.md
skills/git-workflow.md
skills/sprint-lifecycle.md

Purpose

Complete the sprint, capture lessons learned to Gitea Wiki, and update documentation. This is critical for preventing repeated mistakes across sprints.

Invocation

Run /sprint-close when sprint work is complete.

Workflow

Execute the sprint close workflow:

Check Lifecycle State - Execute skills/sprint-lifecycle.md check protocol. Expect Sprint/Reviewing. Clear all Sprint/* labels (return to idle) at the END of close workflow, after all other steps. Warn if in wrong state (allow with --force).
Review Sprint Completion - Verify issues closed or moved to backlog
Capture Lessons Learned - Interview user about challenges and insights
Tag for Discoverability - Apply technology, component, and pattern tags
Save to Gitea Wiki - Use create_lesson with metadata and implementation link
Update Wiki Implementation Page - Change status to Implemented/Partial/Failed
Update Wiki Proposal Page - Update overall status if all implementations complete
Update RFC Status (if applicable) - See RFC Update section below
New Command Verification - Remind user new commands require session restart
Update CHANGELOG (MANDATORY) - Add changes to [Unreleased] section
Version Check - Run /suggest-version to recommend version bump
Git Operations - Commit, merge, tag, clean up branches
Close Milestone - Update milestone state to closed

RFC Status Update (Step 7)

If the sprint was linked to an RFC:

Check Sprint Completion Status:
- All issues completed → RFC status = Implemented
- Partial completion → RFC status stays Implementing (note progress)
- Blocked/Failed → RFC status reverts to Draft (with notes)

Update RFC Page (if Implemented):

Change status: Implementing → Implemented
Add Completion section with date and release version
Link to lessons learned page

update_wiki_page(
    page_name="RFC-NNNN:-Title",
    content="[content with Implemented status and completion details]",
    repo="org/repo"
)

Update RFC-Index:
- Remove from "## Implementing" section
- Add to "## Implemented" section with completion date and release
Handle Partial Completion:
- Keep RFC in Implementing status
- Add progress notes to Implementation section
- Next sprint can continue the work

Don't skip lessons learned! Future sprints will benefit from captured insights.

Visual Output

╔══════════════════════════════════════════════════════════════════╗
║  📋 PROJMAN                                                      ║
║  🏁 CLOSING                                                      ║
║  [Sprint Name]                                                   ║
╚══════════════════════════════════════════════════════════════════╝

3.4 KiB Raw Blame History