fix(projman): add new command verification step to sprint-close

Addresses issue #278 - sprint-diagram command not discoverable after Sprint 4.

Root cause: Claude Code discovers skills at session start. Commands added
during a session are NOT discoverable until restart.

Prevention: Added step 7 "New Command Verification" to sprint-close workflow:
- Reminds about session restart requirement
- Creates follow-up verification task
- Explains why this happens

Lesson learned created: lessons/patterns/sprint-4---new-commands-not-discoverable-until-session-restart

Closes #278

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-01-28 15:36:11 -05:00
parent cde5c67134
commit 611b50b150

View File

@@ -54,23 +54,32 @@ The orchestrator agent will guide you through:
- If partial: Keep status as "In Progress", note completed implementations - If partial: Keep status as "In Progress", note completed implementations
- Add summary of what was accomplished - Add summary of what was accomplished
7. **Update CHANGELOG** (MANDATORY) 7. **New Command Verification** (if applicable)
- Check if this sprint added new commands or skills
- **IMPORTANT:** New commands are NOT discoverable until session restart
- If new commands were added:
- List them in sprint close notes
- Remind user: "New commands require session restart to test"
- Create verification task in next sprint or backlog
- **WHY:** Claude Code discovers skills at session start; commands added during a session won't work until restart
8. **Update CHANGELOG** (MANDATORY)
- Add all sprint changes to `[Unreleased]` section in CHANGELOG.md - Add all sprint changes to `[Unreleased]` section in CHANGELOG.md
- Categorize: Added, Changed, Fixed, Removed, Deprecated - Categorize: Added, Changed, Fixed, Removed, Deprecated
- Include plugin prefix (e.g., `- **projman:** New feature`) - Include plugin prefix (e.g., `- **projman:** New feature`)
8. **Version Check** 9. **Version Check**
- Run `/suggest-version` to analyze changes and recommend version bump - Run `/suggest-version` to analyze changes and recommend version bump
- If release warranted: run `./scripts/release.sh X.Y.Z` - If release warranted: run `./scripts/release.sh X.Y.Z`
- Ensures version numbers stay in sync across files - Ensures version numbers stay in sync across files
9. **Git Operations** 10. **Git Operations**
- Commit any remaining work (including CHANGELOG updates) - Commit any remaining work (including CHANGELOG updates)
- Merge feature branches if needed - Merge feature branches if needed
- Clean up merged branches - Clean up merged branches
- Tag sprint completion (if release created) - Tag sprint completion (if release created)
10. **Close Milestone** 11. **Close Milestone**
- Use `update_milestone` to close the sprint milestone - Use `update_milestone` to close the sprint milestone
- Document final completion status - Document final completion status