Govreview 2a — the causal clusters stop contradicting their own entries - #281
Merged
Merged
Conversation
…ey group
Phase 2a of the governance consistency review — 8 findings, 5 of the review's 9
contradictions, all in one document and all one root cause.
The register's Register Conventions section calls its cluster list "the single
authority" on grouping. Five of its twelve clusters named entries as OPEN whose own
headers say RESOLVED:
immutability enforcement C-66
the freeze as a root cause C-57, C-66
summarize-estimator coherence C-57
verification-completeness C-74, C-79, C-80
unchecked completeness claims C-85, C-77, C-80
doc<->code topology drift C-86
**C-74 is the one that matters.** It resolved on 2026-07-31, seventeen days BEFORE the
clusters' own stated review date of 2026-08-17 — so the last manual cluster review did
not catch an entry that had already been closed for over two weeks. Manual review of a
self-describing list is not a control.
**The preamble committed the failure it warns about, in the same sentence.** It read
"that list is the single authority and this preamble deliberately does not restate it
(it drifted when it did)" — and then restated it in the next clause, listing C-57,
C-66, C-74 and C-75 as open. All four are resolved. The abridged copy is deleted
rather than corrected, because correcting it rebuilds the thing that drifted.
**Check 14** now holds cluster membership against entry status. To let it stay simple,
the brace convention is normalised: `= {open ids; + resolved ids}`, or
`= {all resolved: ids}` when nothing in the cluster is open. Five different brace forms
were in use across twelve clusters, which is why nothing had ever checked this.
Mutation-tested four ways, all firing: a resolved entry moved into an open position; a
fully-resolved cluster losing its marker; **an open entry resolving without its cluster
being updated** — the real-world case, which happened five times; and a register with no
clusters at all.
**The Source vocabulary was fiction.** The conventions listed ten permitted `Source:`
values. Six appeared in no entry at all, while six of the most-used real sources —
`code-review`, `expert-code-review`, `review-base-docs`, `review-diff`,
`expert-method-review`, `tech-debt-cleanup` — were absent from the list. A convention
describing a practice nobody followed. It now lists what is actually used.
Register: 95 entries, 10 open, 85 resolved. Still 0 actionable.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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
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.
Phase 2a of the governance consistency review. 8 findings, 5 of the review's 9 contradictions — all in one document, all one root cause.
The finding
The register's conventions call the cluster list "the single authority" on grouping. Five of twelve clusters listed entries as open whose own headers say RESOLVED:
C-74 is the damning one. It resolved 2026-07-31 — seventeen days before the clusters' own stated review date of 2026-08-17. The last manual review didn't catch an entry closed a fortnight earlier. Manual review of a self-describing list is not a control.
The preamble committed the failure it warns about
…then restated it in the next clause, listing C-57, C-66, C-74 and C-75 as open. All four resolved.
The copy is deleted, not corrected — correcting it rebuilds the thing that drifted.
Check 14
Holds cluster membership against entry status. Brace convention normalised so the check can stay simple — five different forms were in use across twelve clusters, which is why nothing had ever checked this.
Mutation-tested four ways, all firing. The one that matters: an open entry resolving without its cluster being updated — the real-world case, five times over.
The
Source:vocabulary was fictionTen permitted values were listed. Six appeared in no entry at all. Six of the most-used real sources weren't in the list. A convention describing a practice nobody followed; it now lists what is used.
🤖 Generated with Claude Code