| name | changelog-engine |
| description | Batch engineering changelog. Append entries during work, cut on demand or auto-threshold, draft release post, pair with version bump. |
Changelog Engine
Active period file: plans/_archive/changelogs/<since>--present.md
Closed period: plans/_archive/changelogs/<since>--<until>-<sha>-<slug>.md
Operations
- add →
scripts/changelog-add.sh --tag T --title T --body B
- cut →
scripts/changelog-cut.sh
- Read present.md, count by tag
- Auto-bump: any
breaking→major, any feat→minor, else patch
- Generate slug + short_id
- Rename present.md → closed filename
- Bootstrap fresh
<today>--present.md
- Draft release post (haiku) from cut file →
references/release-post-draft.md
- Invoke version-bump.py with computed type
- Optional: publish to configured release_post_target
Config
plans/_dashboard/changelog.json per references/cut-workflow.md.
Auto-triggers
PostToolUse(git commit) hook calls changelog-add.sh if auto_add_on_commit: true.
Auto-cut: manual | weekly | N_entries | before_deploy.