changelog-weaver
Purpose
Build draft release notes from local git history without hand-sorting every commit.
Runbook
- Run the script inside a git repository and optionally provide a start and end ref.
- Let
scripts/build.pygroup commits by conventional prefixes such as feat, fix, docs, perf, and chore. - Review the generated markdown and edit wording for externally facing release notes.
- Use the draft as a starting point, not as an automated public announcement.
Stop conditions
- Abort if the repository history is shallow or missing the comparison refs you need.
- Abort before publishing notes without checking whether internal-only commits should be omitted.
- Abort if the current variant is marked unsupported.
Output format
- Markdown changelog grouped by release-note category
- Commit range metadata
- Catch-all section for uncategorized commits
Example invocations
python3 skills/changelog-weaver/scripts/build.pypython3 skills/changelog-weaver/scripts/build.py --from v1.2.0 --to HEAD