Decision records

adrkit dogfoods its own format: every decision in this project is a typed decision record in docs/adr/. These pages are generated from those source files — the records themselves are never edited to fit this site.

The same corpus is also served as a decision portal: the supersession graph, the review queue, and which decisions govern each path, built by adrkit’s own portal Action on every deploy.

#	Decision	Status
0001	Record architecture decisions as versioned markdown in git	accepted
0002	Type the frontmatter as a MADR superset with an affects matcher	accepted
0003	Ship as a Spec Kit extension plus a standalone CLI, not a competing harness	accepted
0004	Treat git as the source of truth and the database as a derived index	accepted
0005	Gate proposals with a deterministic-first evaluator and declarative escalation	superseded
0006	License Apache-2.0 with a DCO and develop in a single monorepo	accepted
0007	Isolate integrations as optional adapters and build only against public surfaces	accepted
0008	Migrate MADR corpora in place and treat all other imports as one-way with a re-import diff	accepted
0009	Pin affects resolution semantics and bind entity refs to pluggable catalogs	accepted
0010	Use Bun as the package manager and test runner while publishing Node-targeted artifacts	accepted
0011	Host the canonical JSON Schema at its $id on adrkit.dev	accepted
0012	Bind catalog entities to owned paths with an explicit annotation	accepted
0013	Reconcile adapter isolation and catalog binding with the offline snapshot generator	accepted
0014	Stage phase-landing evidence across a three-rung validation ladder	accepted
0015	Validate descriptors against Backstage field formats before canonicalizing identity	accepted
0016	Require every check to be observed failing before it counts as coverage	accepted
0017	Keep dependency audit scope explicit and release-scoped	accepted
0018	Adopt MCP SDK v2 and serve protocol revision 2026-07-28 dual-era	accepted
0019	Ship the Spec Kit extension, treating the spike’s no-go as a measurement artifact	accepted
0020	Rescope SC-010 and authorize work toward the Backstage catalog adapter	accepted
0021	Resolve inbound source annotations without changing the schema	superseded
0022	Scan inbound markers in check and CI without giving them exit-code authority	accepted
0023	Read a marker only where the format hides it: fences and markdown prose	accepted
0024	Report the measured scan extent, not the window constant	accepted
0025	Ship badges as recipes over existing output, not a new CLI surface	accepted
0026	Identify the CI comment by the strongest author evidence the token allows	accepted
0027	Ratify the deterministic evaluator and bind calibration reporting to the first probabilistic pass	accepted
0028	Ship decision memory as a portable agent plugin, and omit the MCP wiring hosts cannot honor	accepted
0029	Scope Backstage publication as a downstream consumer, tiered on the entity-ownership mapping	accepted
0030	Keep extension surfaces that carry a dependency tree outside this repository	accepted
0031	Publish a narrow consumer SDK as the contract, and document the CLI JSON as its sibling	accepted
0032	Publish one lockstep OCI image after the coordinated release succeeds	accepted
0033	Select interactive graph presentation at the CLI boundary while preserving piped DOT	accepted
0034	Extend the portable agent plugin with decision backfill	accepted
0035	Execute the gates that certify a pull request from the default branch	accepted
0036	Expose the governing-decisions Action through one root Marketplace entry point	accepted
0037	Treat generated knowledge systems as downstream read models, not decision authorities	accepted
0038	Offer the bootstrap decision record as an offer rather than a backfill candidate	accepted
0039	Derive a valid-time window from date and supersession, and resolve a git ref at the CLI boundary	accepted
0040	Keep derived surfaces in lockstep with three mechanisms matched to three classes of drift	accepted
0041	Regenerate committed artifacts on Dependabot pull requests with default-branch scripts behind a maintainer label	accepted
0042	Count a gate-change acknowledgment only when an admin or maintainer applied it	accepted
0043	Publish schema v0.2.0 with RFC 3339 seconds, retain v0.1.0, and validate every record against the current schema	accepted
0044	Ratify a proposed record with adr accept and present the queue for terminals	accepted
0045	Ship an advisory adr-review dynamic workflow in the portable agent plugin	accepted
0046	Ship a read-only decision-review canvas for the GitHub Copilot app in the portable agent plugin	accepted
0047	Show provenance, review cost, and a read-only proposal queue in the decision-review canvas	proposed
0048	Supply read-only adrkit tools to GitHub Copilot through the plugin extension instead of MCP wiring	proposed
0049	Add advisory session hooks that never block to the portable agent plugin	proposed
0050	Ship a read-only decision-board canvas that maps the corpus from adr graph and adr queue	proposed
0051	Record review state with adr approve, adr object, and adr resolve	proposed
0052	Record review from the decision board only after the host’s own confirmation	proposed
0053	Implement @adrkit/sdk over core’s kernels and accept an in-repo consumer as its real consumer	accepted
0054	Publish a static decision portal for GitHub Pages, built outside the CLI from the SDK	accepted
0055	Serve a read-only REST API over the SDK in the OCI image, and reach MCP clients through it	accepted
0056	Ship the Azure deployment surface as Terraform in a separate repository behind APIM Standard v2 with public_access	proposed
0057	Preview the decision portal locally through a preview selector in the published image, published to loopback only	accepted
0058	Project the decision corpus into a GitHub Project as a one-way derived view	accepted
0059	Aggregate decision corpora across an organization’s repositories as a pinned, read-only federation	accepted

See the ADR template for the copy-ready starting point.