Maintains accurate changelog following Keep a Changelog format.
Used by /ctxk:proj:migrate command to track file changes and preserve user customizations.
════════════════════════════════════════════════════════════════════════════════
║ 🤖 EXECUTION FLOW - CHANGELOG MAINTENANCE
════════════════════════════════════════════════════════════════════════════════
║
║ ## When to Add Entries
║
║ Add entries for ANY file changes in the ContextKit repository:
║ - New files created
║ - Existing files modified (content, structure, format changes)
║ - Files moved or renamed
║ - Files deleted
║ - Directory structure changes
║
║ ## Entry Format Rules
║
║ Always use full file paths from repository root:
║ - ✅ Templates/Commands/proj/init.md
║ - ❌ init.md or proj/init.md
║
║ Include brief description of what changed and short commit SHA:
║ - ✅ Templates/Scripts/AutoFormat.sh - Added Swift 6 compatibility (a1b2c3d)
║ - ❌ Templates/Scripts/AutoFormat.sh - Updated
║
║ Commit SHA format:
║ - Use short 7-character SHA: (a1b2c3d)
║ - Get with: git rev-parse --short HEAD
║ - Enables /migrate command to examine exact git changes
║
║ ## Migration Markers
║
║ Use [M] prefix for changes that affect existing user projects:
║ - [M] Template files that users customize (commands, agents, hooks)
║ - [M] File moves/renames that require path updates
║ - [M] File deletions that need cleanup
║ - [M] Configuration changes that affect user settings
║
║ No marker for safe changes:
║ - Documentation updates (README.md, CLAUDE.md)
║ - New optional files users can adopt gradually
║ - Repository infrastructure that doesn't affect deployed projects
║
║ ## Changelog Sections
║
║ Use standard Keep a Changelog format:
║ - Added: New files and features
║ - Changed: Modifications to existing files
║ - Deprecated: Soon-to-be removed features (with timeline)
║ - Removed: Files and features removed in this version
║ - Fixed: Bug fixes
║ - Security: Security improvements
║
║ ## Release Process
║
║ When making a release:
║ 1. Update first line: Current Version: X.X.X to new version number
║ 2. Change [Unreleased] to [Version] - YYYY-MM-DD
║ 3. Remove empty sections from the released version
║ 4. Create new [Unreleased] section above it with all sections showing "N/A"
║
║ Example after release:
║ Current Version: 1.0.0
║
║ # ContextKit Changelog
║ [system instructions...]
║
║ ## [Unreleased]
║ ### Added
║ N/A
║ ### Changed
║ N/A
║ [etc. - all sections with N/A]
║
║ ## [1.0.0] - 2025-01-15
║ ### Added
║ - file.md - Description (a1b2c3d)
║ ### Changed
║ - [M] file.md - Description (e4f5g6h)
║ [Only sections with actual content]
════════════════════════════════════════════════════════════════════════════════
N/A
N/A
N/A
N/A
N/A
N/A
- Quick planning workflow for smaller tasks (
/ctxk:plan:quick) - Developer customization sections in all command and agent templates
[M] Templates/Commands/plan/2-research-tech.md- Streamlined to single-run workflow integrating research into Tech.md[M] Templates/Features/Tech.md- Combined research and architecture phases into single template[M] Templates/Commands/impl/start-working.md- Updated to work with integrated Tech.md[M] Templates/Commands/proj/init.md- Improved submodule handling and guideline detection[M] Templates/Guidelines/Swift.md- Added logger and String-Data conversion preferences[M] Templates/Commands/plan/1-spec.md- Enhanced clarification requirement validation[M] Templates/Commands/plan/3-steps.md- Better agent usage documentation
Templates/Features/Research.md- Merged into Tech.md for streamlined workflow
Initial release with complete ContextKit workflow system.