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.
| # | 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 | proposed |
| 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 | proposed |
| 0006 | License Apache-2.0 with a DCO and develop in a single monorepo | proposed |
| 0007 | Isolate integrations as optional adapters and build only against public surfaces | proposed |
| 0008 | Migrate MADR corpora in place and treat all other imports as one-way with a re-import diff | proposed |
| 0009 | Pin affects resolution semantics and bind entity refs to pluggable catalogs | proposed |
| 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 |
See the ADR template for the copy-ready starting point.