fix(projman): add mandatory CHANGELOG and versioning to sprint-close workflow
Problem: Version workflow was documented but not enforced in sprint-close. After completing sprints, CHANGELOG wasn't updated and releases weren't created. Solution: - Add "Update CHANGELOG" as mandatory step 7 in sprint-close - Add "Version Check" as step 8 with /suggest-version and release.sh - Update orchestrator agent with CHANGELOG and version reminders - Add V04.1.0 wiki workflow changes to CHANGELOG [Unreleased] - Document MCP bug #160 in Known Issues This ensures versioning workflow is part of the sprint close process, not just documented in CLAUDE.md. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -465,7 +465,44 @@ update_wiki_page(
|
||||
)
|
||||
```
|
||||
|
||||
**G. Git Operations**
|
||||
**G. Update CHANGELOG (MANDATORY)**
|
||||
|
||||
Add all sprint changes to `[Unreleased]` section:
|
||||
```markdown
|
||||
## [Unreleased]
|
||||
|
||||
### Added
|
||||
- **projman:** New feature description
|
||||
- **plugin-name:** Another feature
|
||||
|
||||
### Changed
|
||||
- **projman:** Modified behavior
|
||||
|
||||
### Fixed
|
||||
- **plugin-name:** Bug fix description
|
||||
```
|
||||
|
||||
**IMPORTANT:** Never skip this step. Every sprint must update CHANGELOG.
|
||||
|
||||
**H. Version Check**
|
||||
|
||||
Run `/suggest-version` to analyze CHANGELOG and recommend version bump:
|
||||
```
|
||||
/suggest-version
|
||||
```
|
||||
|
||||
If release is warranted:
|
||||
```bash
|
||||
./scripts/release.sh X.Y.Z
|
||||
```
|
||||
|
||||
This ensures version numbers stay in sync:
|
||||
- README.md title
|
||||
- .claude-plugin/marketplace.json
|
||||
- Git tags
|
||||
- CHANGELOG.md section header
|
||||
|
||||
**I. Git Operations**
|
||||
|
||||
Offer to handle git cleanup:
|
||||
```
|
||||
@@ -541,6 +578,8 @@ Would you like me to handle git operations?
|
||||
10. **Capture lessons** - At sprint close, interview thoroughly
|
||||
11. **Update wiki status** - At sprint close, update implementation and proposal pages
|
||||
12. **Link lessons to wiki** - Include lesson links in implementation completion summary
|
||||
13. **Update CHANGELOG** - MANDATORY at sprint close, never skip
|
||||
14. **Run suggest-version** - Check if release is needed after CHANGELOG update
|
||||
|
||||
## Your Mission
|
||||
|
||||
|
||||
@@ -54,13 +54,23 @@ The orchestrator agent will guide you through:
|
||||
- If partial: Keep status as "In Progress", note completed implementations
|
||||
- Add summary of what was accomplished
|
||||
|
||||
7. **Git Operations**
|
||||
- Commit any remaining work
|
||||
7. **Update CHANGELOG** (MANDATORY)
|
||||
- Add all sprint changes to `[Unreleased]` section in CHANGELOG.md
|
||||
- Categorize: Added, Changed, Fixed, Removed, Deprecated
|
||||
- Include plugin prefix (e.g., `- **projman:** New feature`)
|
||||
|
||||
8. **Version Check**
|
||||
- Run `/suggest-version` to analyze changes and recommend version bump
|
||||
- If release warranted: run `./scripts/release.sh X.Y.Z`
|
||||
- Ensures version numbers stay in sync across files
|
||||
|
||||
9. **Git Operations**
|
||||
- Commit any remaining work (including CHANGELOG updates)
|
||||
- Merge feature branches if needed
|
||||
- Clean up merged branches
|
||||
- Tag sprint completion
|
||||
- Tag sprint completion (if release created)
|
||||
|
||||
8. **Close Milestone**
|
||||
10. **Close Milestone**
|
||||
- Use `update_milestone` to close the sprint milestone
|
||||
- Document final completion status
|
||||
|
||||
|
||||
Reference in New Issue
Block a user