Skip to content

Commit bf42d26

Browse files
committed
commands(fix[changelog]) Enforce section order and use What's new heading
1 parent 27c5d88 commit bf42d26

1 file changed

Lines changed: 11 additions & 9 deletions

File tree

.claude/commands/changelog.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ Parse the commit type from the `Component(type[sub])` convention in commit subje
6969

7070
| Commit type | CHANGES section | Notes |
7171
|---|---|---|
72-
| `feat` | Features / New features | New functionality |
72+
| `feat` | What's new | New functionality (formerly "Features" / "New features") |
7373
| `fix` | Bug fixes | Bug fixes |
7474
| `docs` | Documentation | Doc changes |
7575
| `test` | Tests | Test additions/changes |
@@ -101,13 +101,15 @@ A structured list of entries grouped by section, each with:
101101

102102
1. **Section headings**: Use `### Section Name` (e.g., `### Bug fixes`, `### Features`)
103103

104-
2. **Section order** (only include sections that have entries):
105-
- Breaking changes
106-
- Features / New features
107-
- Bug fixes
108-
- Documentation
109-
- Tests
110-
- Development
104+
2. **Section order** (only include sections that have entries — this order is mandatory, never reorder):
105+
1. Breaking changes
106+
2. What's new
107+
3. Bug fixes
108+
4. Documentation
109+
5. Tests
110+
6. Development
111+
112+
**IMPORTANT**: Always use the exact heading names above. In particular, use `### What's new` (not "Features" or "New features") — this matches the project's established convention in recent releases.
111113

112114
3. **Simple entries** — single bullet:
113115
```markdown
@@ -133,7 +135,7 @@ A structured list of entries grouped by section, each with:
133135

134136
6. **Match existing style**:
135137
- Check whether the project uses "Bug fixes" or "Bug Fixes" (match existing capitalization)
136-
- Check whether "Features" or "New features" is used
138+
- This project uses "What's new" (not "Features" or "New features")
137139
- Preserve the project's conventions
138140

139141
### Entry writing guidelines

0 commit comments

Comments
 (0)