docs(adr): adopt released truth for public documentation

[JimCollinson]

Summary

Proposes ADR-0016: public developer documentation and the published developer skill should default to stable, obtainable, compatible, capability-evidenced released truth rather than moving default-branch source.

Jim selected one coherent active release set with journey-local support status: working interfaces remain documented, failed journeys are withdrawn or marked unsupported, and older release fallback is global rather than per journey.

Scope

This draft PR contains only the Proposed ADR, its dated v0.11.2 motivating audit, GSD state/checkpoint material, and branch-local review evidence. It does not implement the policy, update rendered documentation or the skill, accept the ADR, or authorize a merge.

Current evidence

• ADR governance and 20 governance tests pass locally.
• Exact-head ADR Governance and GitBook checks pass on this draft PR.
• Prose/sweep checks return success as branch-scope no-ops, not substantive coverage.
• Journey-local code review passed at b1e4846.
• Journey-local goal verification passed 10/10 at 39e2cdf.
• Review reports are committed under planning/.

Current status: NOT-READY

Adversarial review at ef646b9 found two remaining blockers:

1. A complete SDK route must preserve continuity below the top-level SDK label so incompatible bindings or transports cannot be combined.
2. ADR-0016 must precisely supersede ADR-0011’s unconditional SDK-primary stance if CLI can remain the only recommended complete route.

The review also requests a concrete, clause-derived route truth table. These findings are recorded in planning/adr-0016-adversarial-ef646b9.md.

Known limitations and next gates

• ADR-0016 remains Proposed and requires Jim Collinson’s explicit acceptance.
• A fresh release audit is required before implementation; the included v0.11.2 audit is historical evidence only.
• Craft Review and clean-context review remain pending until adversarial review passes.
• No merge or implementation action is authorized by this draft PR.