Repository navigation
docs: state the one-home rule as a principle - #1243
Merged
Merged
Conversation
The 2026-10-27 ruling that every claim in the record has one home was kept only as a decision line. It now has a principle stating the rule and its bounds (a one-line pointer, a generated copy with a matching check and history kept in git are not second homes; code primitives stay under one canonical primitive), the decision keeps the dated event and the brief's specific answers and points to the principle, and the OPINIONS rules domain names it. Assisted-by: Claude:claude-opus-5-5
Say what the 2026-10-26 consistency pass compared (the brief and the intents, each against the rest) and what it found, rather than claiming its findings were paraphrased command pages and ADRs; narrow the drift claim to markdown links, since a bare path in a rules domain is checked by nothing; bring the intents, ADRs, decisions and docs/ inside the rule, with dated records counted as history; add the promotion rung; and keep the glossary among the answers the ruling settled. Assisted-by: Claude:claude-opus-5-5
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.
The 2026-10-27 ruling that every claim in the record has one home was recorded only as a decision line. This makes it a principle and points the decision at it.
.abcd/development/principles/every-claim-has-one-home.mdstates the rule, why restated claims drift (with the 2026-10-26 consistency pass's counts), and its bounds:It also says the rule is unenforced and what a lint would need to check to promote it.
Reviewed by an Opus and a Sonnet reviewer. One major finding (the evidence misdescribed what the consistency pass compared) and four minor ones were fixed, and the re-review closed all six. Records only, with no code change. The one behavioural difference is that the OPINIONS domain injects one more line when it matches.
Commits:
Assisted-by: Claude:claude-opus-5-5