docs(knowledge): drop the unfollowable Brief attribution from the 0.12.1 entry - #2743
Merged
Conversation
…2.1 entry The shipped 0.12.1 entry credited "the Brief-captured debt" — an attribution to an authoring-time planning document that exists in no git ref and that no consumer ever receives. It is the same unresolvable-reference shape 0.12.2 removed from the skill body, left behind on the changelog surface. The debt itself is already quoted inline in the same sentence, so dropping the attribution loses no information: the entry still records what was owed and what paid it down. Prose only — no version heading changed, no behavior, schema, gate, exit code, or argument affected. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Dm3XHznFdU1M4TysnJ26gu
|
Bugbot is not enabled for your account, so this pull request was not reviewed. Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs. |
Contributor
|
Claude finished @kyle-sexton's task in 24s —— View job Code review —
|
|
Claude has reviewed this PR 1 time. The lane skips further automatic reviews after 5; deleting this comment resets the count. |
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.
What
Drops two words from the shipped
knowledge0.12.1 changelog entry: "Pays down theBrief-captureddebtmap-corpusrecorded".Why
Brief-capturedattributes the debt to an authoring-time planning document that exists in no git ref —git log --all -- docs/topics/docsite-digestis empty, and the mapper's own working slice is untracked and self-ignoring by design. A consumer reading the changelog cannot follow it, and never could.This is the same unresolvable-reference shape #2719 removed from the
map-corpusskill body one version later. #2719 scoped it out deliberately, because editing a shipped entry is a different judgment call than fixing an unreleased one. This PR makes that call explicitly rather than leaving the residue in place.Why this does not rewrite history
The debt itself is quoted inline in the same sentence — "that citation shape still needs an owner doc before a second skill emits it" — so the entry still records what was owed and what paid it down. Only the unfollowable attribution goes. No version heading is touched, no entry is added or removed, and no ordering changes.
Verification
Ran locally before pushing, all exit 0:
check-changelog-parity.sh --check— every versioned plugin has a CHANGELOG, none documents a version above its manifest.check-changelog-parity.sh --check-preserved origin/main— all 1 changed changelog preserves every version heading it carried ata326a877, 58 headings compared.check-changelog-parity.sh --check-bump origin/main— every plugin whose version changed has a matching entry (none changed here; prose only).No version bump: nothing a consumer receives changes behavior, and the changelog header's own rule ties the version to delivered change.
Related
Completes the reference-debt cleanup begun in #2719, which established that
docs/topics/docsite-digest/exists in no ref and that self-containment was therefore the only conforming outcome.No related issue: routine hygiene on a shipped surface, found by the verifier on #2719 and deferred out of that PR's scope.