Skip to content

Posture was stated twice and had already drifted — collapse to one home - #139

Merged
Polichinel merged 1 commit into
developmentfrom
fix/posture-stated-twice
Aug 13, 2026
Merged

Posture was stated twice and had already drifted — collapse to one home#139
Polichinel merged 1 commit into
developmentfrom
fix/posture-stated-twice

Conversation

@Polichinel

Copy link
Copy Markdown
Contributor

Found by /review-rr prioritize while checking whether anything was owed before shutdown. Created by me today, splitting the roadmap out of README.md.

Both files carried "Current posture", and they already disagreed

File Said
README.md "Six other repositories … by URL at a pinned tag"
docs/roadmap_shared_client.md "Five other repos … by URL at a pinned commit"

Two drifts. The count was corrected in the README (R8) and not in the copy. The mechanism was never corrected in either — "pinned commit" predates §10.1 and the edition floor, so the roadmap handed readers advice the contract no longer gives.

Why it is worth a commit rather than a quiet edit

C-53's shape — two statements of one fact, nothing checking they agree — produced while relocating a document, in the same sprint that registered C-76 for unverified claims, hours after writing a cluster about facts drifting unobserved.

Relocation is where this class is born. Splitting a file duplicates whatever sat at the boundary, and the duplicate looks correct on the day.

Fixed by deletion, not synchronisation

Posture is about what the repo is — the README's job. The roadmap points at it, keeps a one-line summary so the page reads standalone, and records the drift rather than tidying it away.

Gates: validate_docs.sh green (9 checks) · pytest 10 red / 24 passed / 2 xfailed.

🤖 Generated with Claude Code

…e to one home

Found by /review-rr prioritize, checking whether anything was owed before shutdown.
Created by me, today, while relocating the roadmap out of README.md.

BOTH FILES CARRIED A "Current posture" SECTION, and within hours they disagreed:

  README.md                    "Six other repositories ... by URL at a pinned tag"
  roadmap_shared_client.md     "Five other repos ... by URL at a pinned commit"

Two drifts, not one. The COUNT was corrected in the README (R8, counted rather than
recalled) and not in the copy. The MECHANISM was never corrected in either direction --
"pinned commit" predates §10.1 and the edition floor, so the roadmap was handing a
reader advice the contract no longer gives.

C-53's shape exactly: two statements of one fact, nothing checking that they agree. What
makes it worth a commit rather than a quiet edit is WHEN it happened -- produced while
RELOCATING a document, in the same sprint that registered C-76 for unverified claims,
hours after writing a cluster about facts drifting unobserved.

Relocation is where this class is born. Splitting a file duplicates whatever sat at the
boundary, and the duplicate looks correct on the day.

Fixed by deletion rather than synchronisation: posture is about what the repo IS, which
is the README's job. The roadmap now points at it, keeps a one-line summary so the page
reads standalone, and records the drift rather than tidying it away.

Gates: validate_docs green (9 checks), pytest 10 red / 24 passed / 2 xfailed.

Refs C-53, C-76

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@Polichinel
Polichinel merged commit d71f887 into development Aug 13, 2026
4 checks passed
@Polichinel
Polichinel deleted the fix/posture-stated-twice branch August 13, 2026 21:54
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