docs: README internal-drift fix + DOC-04/05/06 done-in-tree (Refs #176, Refs #175)#315
Merged
Merged
Conversation
… Refs #175) README.adoc had two leftover lines (25, 614) calling `.machine_readable/6a2/STATE.a2ml` the authoritative status doc, which contradicts the line-10 banner pointing to CAPABILITY-MATRIX (and STATE.a2ml itself now self-declares as a mirror via its `authoritative-status-doc` + `drift-flag` keys). Both lines now point at CAPABILITY-MATRIX and label STATE.a2ml as the mirror. While here, bump TECH-DEBT DOC-04/05/06 from "open" to "DONE in tree" to match reality: the banners exist on all four target docs, the STATE.a2ml drift-flag is in place, and ROADMAP.adoc cross-links CAPABILITY-MATRIX + TECH-DEBT + ECOSYSTEM and names the INT-01..12 track. MONITOR posture (DOC-08/09) is unchanged. Refs #176, Refs #175 (epic is requirements-target — does not close here). Co-Authored-By: Claude Opus 4.7 (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
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.
Summary
README.adoc(25, 614) that calledSTATE.a2ml"authoritative" — directly contradicting the line-10 banner pointing atdocs/CAPABILITY-MATRIX.adoc, and at odds withSTATE.a2ml's ownauthoritative-status-doc+drift-flagkeys declaring it a mirror. Both lines now point atCAPABILITY-MATRIXand labelSTATE.a2mlas the mirror.docs/TECH-DEBT.adocDOC-04 / DOC-05 / DOC-06 from "open" to "DONE in tree" to match reality: banners exist on all four target docs, theSTATE.a2mldrift-flag is in place, andROADMAP.adocalready cross-linksCAPABILITY-MATRIX+TECH-DEBT+ECOSYSTEMand names the INT-01..12 track. MONITOR posture (DOC-08/09 — Hypatia/gitbot DOC-FORMAT) is unchanged; this PR demonstrates it by being the kind of small drift-correction PR that posture exists to encourage.Scope
README.adoc,docs/TECH-DEBT.adoc(+16 / -6).STATE.a2mlis a deliberate non-target — this PR doesn't make it lead, it makes the prose stop pretending it does.Not closing
Refs #176, Refs #175— neverCloses. #175 isrequirements-target(only closes on mutual agreement); #176 is the long-lived MONITOR. DOC-04 stays a live MONITOR item even though the snapshot is now clean.Test plan
gh pr diffshows exactly the two files above.grep -nE "authoritative" README.adocshows no remaining line that callsSTATE.a2mlauthoritative.docs/TECH-DEBT.adocSection A renders cleanly (asciidoctor|table not broken by the new multi-line cells — same pattern DOC-02 already uses).🤖 Generated with Claude Code