docs(adr): adopt released truth for public documentation - #98
Open
JimCollinson wants to merge 49 commits into
Open
docs(adr): adopt released truth for public documentation#98JimCollinson wants to merge 49 commits into
JimCollinson wants to merge 49 commits into
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
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.
Summary
Proposes ADR-0016: public developer documentation should describe stable software the public can obtain, rather than unreleased default-branch code. A release is the explicit, auditable stake against which public claims are written and verified.
Decision
Scope
This PR contains Proposed ADR-0016, the historical audit that motivated it, and GSD review evidence. It does not implement the policy, update rendered documentation, decide skill ownership, accept the ADR, or authorize a merge.
The ADR is 481 words including metadata and headings. It partially supersedes only the public source-selection and provenance clauses in ADR-0003, ADR-0004, and ADR-0006.
Evidence
b0d01f41cc1a688699a3614ab4f3243362542a4fare green. ADR Governance executed on clean synthetic PR merge ref45f26b3feaff644a6aaa000f51d4702b610d7443; checkout, all 20 regression tests, and governance validation passed.not applicablescope results; their main validations were skipped because this PR does not change files in their scopes.Current gate
ADR-0016 remains Proposed and is ready for explicit human acceptance or rejection. The clean-context waiver does not authorize acceptance, merge, implementation, or publication. A fresh release audit is required before implementation. No merge or implementation action is authorized by this PR.