Adopts changelog fragments - #23
Merged
Merged
Conversation
Sets changelog.mode to fragments (dir changelog.d) in .claude/wurk.json and adds changelog.d/README.md, adapted from statifier-ex's: the why-fragments rationale, the when-a-fragment-is-warranted test, the format rules, and the at-release assembly step. The statifier-ex-only v2-rewrite and SHA-pinning clauses are deliberately not carried over. Un-ignores changelog.d/ in .gitignore, since a global *.d rule (C/C++ dependency files) would otherwise hide the fragments. Replaces the "Changelog: none" section of .claude/wurk/commit.md with the fragment step: the mode switch lands ahead of sui-n0r's at-first-release timing, per the fleet-wide adoption decision of 2026-08-21; 0.1.0's changelog section is still written in one pass at release. Refs: sui-6vy
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Operator decision 2026-08-21: adopt changelog fragments fleet-wide. This
repo runs worktree-per-issue, so several branches are usually open at
once; if each appended to
## [Unreleased]inCHANGELOG.md, nearlyevery request would conflict with every other one. A fragment is named
after its bead, so the conflict cannot happen. The point is that the
convention exists before parallel work starts, not after the first
conflict.
What
.claude/wurk.json:changelog.modetofragments,changelog.dirto
changelog.d.changelog.d/README.md: adapted from statifier-ex's - thewhy-fragments rationale, the when-a-fragment-is-warranted test, the
format rules and naming convention, and the at-release assembly step.
The statifier-ex-only v2-rewrite and SHA-pinning clauses are
deliberately not carried over.
.gitignore: un-ignoreschangelog.d/- a common global*.drule(C/C++ dependency files) would otherwise hide the fragments, same fix
statifier-ex carries.
.claude/wurk/commit.md: the "Changelog: none" section is replacedwith the fragment step, so the extension no longer contradicts the
manifest.
Notes
at-first-release timing, per the fleet-wide decision. sui-n0r's
remaining scope is unchanged: 0.1.0's changelog section is still
written in one pass from git history at release, and
CHANGELOG.mdis not created here.
gate.build_pathsorgate.also_gated_paths, so no quality gate was applicable.Closes sui-6vy