Skip to content

docs: record the ADR for one home of behaviour, and file the brief rewrite - #1249

Merged
REPPL merged 5 commits into
mainfrom
docs/brief-single-home
Oct 30, 2026
Merged

REPPL merged 5 commits into
mainfrom
docs/brief-single-home

Conversation

@REPPL

@REPPL REPPL commented Oct 30, 2026

Copy link
Copy Markdown
Collaborator

Brings the brief single-home records into the record, checked against the one-home principle (#1243) so the two don't restate each other.

  • adr-2610290238168123: each command's behaviour lives once, in its command page, which the documentation-fidelity check reads. The brief states the design and why, as the target design, with a status tag where a part is built. It supersedes adr-2609231028044006, whose shape rule it carries forward. Its first decision now names the principle instead of restating it. The ADR index is regenerated.
  • The brief-size study of 2026-10-25 is in the research notes as the ADR's evidence.
  • itd-2610290239150589, a draft intent for the brief rewrite itself, which the deferred consistency majors wait on.
  • dcn-2610271112331508 keeps its dated event and now points to the principle for the rule, and to the intent's scope for what the ruling means for the brief.
  • Corrections: the ADR and the intent both said most of the 2026-10-26 consistency pass's records came from the command chapters' second copy. That pass compared the brief and the intents and read no command page. Both now say what its summary supports: 1,080 of its 1,307 findings had a passage of the brief at one end. A quoted phrase in the ADR's rejected alternatives is reworded.
  • iss-2610300120250873 (minor): a rules domain names its home with a bare path that nothing resolves, so a renamed principle leaves a dead pointer the loader keeps injecting while every check stays green.

Records only, with no code change.

Commits:

  • docs: record the ADR for one home of behaviour, and file the brief rewrite
  • docs: say what the consistency pass compared, in the ADR and the rewrite intent
  • docs: file the rules-domain paths that nothing resolves
  • docs: point the one-home ruling and the ADR at their homes instead of restating them

Refs: iss-2610300120250873
Assisted-by: Claude:claude-opus-5-5

REPPL added 5 commits October 30, 2026 01:19
…write

The product thinker's rulings of 2026-10-27 (dcn-2610271112331508,
dcn-2610271112339516, dcn-2610271112330235) reverse two accepted rules,
and they are one coupled change, so one ADR records both:

- adr-2610290238168123: each command's behaviour lives once, in its
  command page, which the documentation-fidelity check reads; the brief
  states the design and why, as the target design with a status tag
  where built. It supersedes adr-2609231028044006, whose shape rule (the
  generated appendix, prose that states no flag or sub-verb) it carries
  forward unchanged.
- The brief-size study of 2026-10-25 moves into the research notes as
  the ADR's evidence, with the outcome of its three rulings.
- itd-2610290239150589 is the draft intent for the rewrite itself, which
  the 45 consistency majors deferred past v0.15.1 wait on. The filing
  match proposed refines links to two unrelated records; both were
  removed.

The ADR index is regenerated.

Assisted-by: Claude:claude-opus-5-5
…ite intent

Both said most of the pass's 1,301 records came from the command chapters'
second copy. The pass read the brief and the intents against each other and
compared no command page; what its summary supports is that 1,080 of its
1,307 findings had a passage of the brief at one end. The ADR's rejected
alternative also cited the ruling in a quoted phrase; it now names the
ruling's first point instead.

Assisted-by: Claude:claude-opus-5-5
A rules domain names its home with a bare path, and the link check reads
markdown links only, so a renamed principle leaves a dead pointer that the
loader keeps injecting while every check stays green.

Refs: iss-2610300120250873
Assisted-by: Claude:claude-opus-5-5
… restating them

The decision kept the brief-specific answers of the ruling because the
rewrite intent that carries them was not yet in the record; it now is, so
the decision points to the intent's scope and to the study, and keeps the
dated event. The ADR's first decision restated the rule the principle
holds, and now names the principle.

Assisted-by: Claude:claude-opus-5-5
@REPPL
REPPL enabled auto-merge October 30, 2026 04:40
@REPPL
REPPL added this pull request to the merge queue Oct 30, 2026
Merged via the queue into main with commit 945f10b Oct 30, 2026
14 checks passed
@REPPL
REPPL deleted the docs/brief-single-home branch October 30, 2026 05:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant