Skip to content

docs: ADR-0031 capability graduation + local artifact snapshots - #153

Merged
pacphi merged 2 commits into
developfrom
docs/graduation-adr-and-explainers
Aug 16, 2026
Merged

docs: ADR-0031 capability graduation + local artifact snapshots#153
pacphi merged 2 commits into
developfrom
docs/graduation-adr-and-explainers

Conversation

@pacphi

@pacphi pacphi commented Aug 16, 2026

Copy link
Copy Markdown
Owner

Ratifies the graduation model and lands the explainer docs locally.

  • ADR-0031 (Accepted, governance; implementation staged) — external adapters reach full parity by earning capabilities through tiered conformance + an explicit maintainer grant, never by self-declaring them (that block stays permanent — the ADR-0029 safety invariant, which this amends). Records the two graduation destinations, the contributor→built-in lifecycle, and the upstream capability-request path (some ceilings are agentic-qe's closed provider enum or ruflo's ENABLE_* model, not ak's to grant). Carries a dated Working/Proposed self-grade — the machinery is staged, not built. ADR-0029 amended with a pointer.
  • Three local doc snapshots in docs/, each with an origin banner to its live Claude artifact: the host-extensibility explainer, the adapter-contract dossier, and the host/provider consistency master doc.

Full gate green (1,682 tests). Flows into the open #151 (develop→main).

🤖 Generated with Claude Code

pacphi added 2 commits August 16, 2026 07:57
…eam request path

Accepts, as a governance decision, that external host adapters reach full
parity by EARNING capabilities through tiered conformance plus an explicit
maintainer grant — never by self-declaring them (that block stays permanent,
the safety invariant from ADR-0029, which this amends). Records the two
graduation destinations (blessed external, promoted built-in), the
contributor-to-built-in lifecycle, and the upstream capability-request path:
some ceilings aren't ak's to lift (AQE provider-type identity is agentic-qe's
closed enum; native ruflo backend is ruflo's ENABLE_* model), so those become
tracked requests with honest interim behavior. Carries a dated Working/Proposed
self-grade — the machinery (trust CLI, external execution, tiered conformance,
grant store) is staged, not built. ADR-0029 gets a matching amendment note.
…its origin

The host-extensibility explainer (consumer + implementer walkthrough), the
adapter-contract dossier (the research synthesis behind ADR-0029/0031), and the
host/provider consistency master document now live in docs/ as self-contained
HTML, each carrying an origin banner back to its live Claude artifact so the
canonical source is one click away.
@pacphi
pacphi merged commit 9b0ff00 into develop Aug 16, 2026
11 checks passed
@pacphi
pacphi deleted the docs/graduation-adr-and-explainers branch August 16, 2026 14:59
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