docs(adr): adopt released truth for public documentation - #98
Merged
Merged
Conversation
- Supersede released source-resolution and drift semantics\n- Add branch-local v0.11.2 audit evidence
- Disqualify incumbents that no longer meet released baseline requirements - Relabel unverified Python and Rust source-install routes
- Define stable candidate eligibility, deterministic ordering, and symmetric requalification - Bound supersession, skill parity, release identity, and validation invariants
- Define deterministic fallback and complete incumbent requalification triggers - Pin authoritative installs and constrain mutable aliases
- Treat fetched skill pointers as untrusted factual input\n- Keep mutable aliases unsupported and non-authoritative
- Keep one coherent active release set with journey-local support statuses\n- Define complete-route baseline, deterministic fallback, and parity rules
- Replace detailed policy mechanics with the approved durable release baseline - Keep implementation and developer-skill architecture out of the proposal
JimCollinson
marked this pull request as ready for review
August 29, 2026 09:28
- Correct audit refs and preserve local-only provenance honestly - Reconcile PR, review, waiver, and CI state
- Remove remote compare calls to a local-only historical commit - Record the HIGH review finding and pending re-review and CI
- Mark scope-gated CI jobs as non-substantive no-ops - Anchor the clean-context waiver record to its dated commit
- Add final remediation review and verification reports - Condition acceptance presentation on current-head checks
- Record stale draft language in the PR body - Preserve live non-draft PR status
- Mark ADR-0016 Accepted after Jim's review of PR #98 - Record merge authorization and preserve the implementation gate
- Shorten the accepted-record AI note without changing acceptance metadata - Record the verified 497-word full-file count
- Add branch-local acceptance review reports - Record exact CI roles and remaining mechanical gates
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.
Purpose
This PR accepts ADR-0016: public developer documentation describes stable software the public can obtain, rather than unreleased default-branch code.
Accepted decision
Human acceptance and merge authorization
Jim Collinson accepted ADR-0016 after reviewing PR #98 on 2026-08-31 and explicitly authorized this PR to be merged after final mechanical gates were green. ADR-0016 is recorded as Accepted in this PR. This is the human decision; it is not autonomous AI acceptance.
Acceptance and merge do not authorize implementation or documentation remediation. That work requires a fresh release audit and a separately approved specification, plan, and slice.
Scope
This PR contains Accepted ADR-0016, the historical audit that motivated it, and GSD review evidence. It does not implement the policy, update rendered documentation, or decide skill ownership.
ADR-0016 is 497 words including metadata and headings. It partially supersedes only the public source-selection and provenance clauses in ADR-0003, ADR-0004, and ADR-0006.
Final-head evidence
789b8c672792464ea380626f745807902e443d10.33395136858, job99497748384, passed substantively on clean synthetic PR merge refab8cc592d0fa4b85e6166f31926380330b911c40.33395136772,33395136754, and33395136786are greennot applicablescope results; their main validations were skipped because this PR does not change files in their scopes.Merge gate
All acceptance and mechanical merge gates are satisfied. Jim authorized this PR to merge on 2026-08-31. Implementation remains unauthorized.