@@ -16,7 +16,7 @@ This skill handles the full release cycle for the `pipelex` Python package.
1616## Files touched
1717
1818- ** ` pyproject.toml ` ** — the ` version ` field (line 3)
19- - ** ` CHANGELOG.md ` ** — promote ` [Unreleased] ` to ` [ vX.Y.Z] - YYYY-MM-DD`
19+ - ** ` CHANGELOG.md ` ** — add ` [vX.Y.Z] - YYYY-MM-DD ` entry (remove ` [Unreleased] ` if present)
2020- ** ` uv.lock ` ** — regenerated via ` make li ` (lock + install)
2121- ** ` .badges/tests.json ` ** — test count updated to match actual count
2222
@@ -46,28 +46,29 @@ failure.
4646
4747### 4. Finalize the changelog
4848
49- The ` CHANGELOG.md ` has an ` ## [Unreleased] ` section at the top with pending
50- changes.
49+ Add a new version entry at the top of the changelog for the release.
5150
52- 1 . If the ` [Unreleased] ` section is ** empty** (no bullet points), warn the user
53- and ask whether to proceed with an empty changelog entry or abort so they can
54- add notes first.
55- 2 . If the ` [Unreleased] ` section has content:
56- - Rename ` ## [Unreleased] ` to ` ## [vX.Y.Z] - YYYY-MM-DD ` (using today's
57- date).
58- - Insert a fresh empty ` ## [Unreleased] ` section above the new version
59- heading, with a blank line separating them.
60- 3 . The result should look like:
51+ 1 . If there is an ` ## [Unreleased] ` section, ** remove it** (including any blank
52+ lines that follow it) and replace it with the new version heading. Any
53+ content that was under ` [Unreleased] ` becomes the content of the new version.
54+ 2 . If there is no ` [Unreleased] ` section, insert the new version heading
55+ directly after the ` # Changelog ` title.
56+ 3 . ** Never add an ` [Unreleased] ` heading.** The changelog should only contain
57+ concrete version entries.
58+ 4 . If the release has no changelog content yet, ask the user what to include
59+ before proceeding.
60+ 5 . The result should look like:
6161
6262``` markdown
6363# Changelog
6464
65- ## [ Unreleased]
66-
6765## [ vX.Y.Z] - YYYY-MM-DD
6866
6967### Changed
7068- ...
69+
70+ ## [ vPREVIOUS] - PREVIOUS-DATE
71+ ...
7172```
7273
7374### 5. Bump the version in pyproject.toml
0 commit comments