Architecture Decision Records

Each ADR records one decision in Context / Decision / Consequences form; the change checklist in CONTRIBUTING says when to add one.

ADR	Title	Status
0001	Capability tiers, not model names	Accepted
0002	Fan-out reduces via an LLM state, not built-in aggregators	Accepted
0003	Provider-agnostic: no provider/model pinning in a .mk	Accepted
0004	LLM as runtime; gates as the reliability mechanism	Accepted
0005	Reasoning is first-class and traced	Accepted
0006	Code-hook gates alongside LLM-judged gates	Accepted
0007	Resumable runs via loop-top checkpoints	Accepted
0008	Human-in-the-loop: escalate gates that suspend	Accepted
0009	Conformance suite as the language contract	Accepted
0010	LLM-assisted lint (mklang lint --llm)	Accepted
0011	An MCP server surface: machines as commissioned sub-tasks	Accepted
0012	A stdlib of general-purpose architecture machines	Accepted
0013	MCP surface completion: discovery, check, durable resume	Accepted
0014	Structured list outputs: parse: list and raw input resolution	Accepted
0015	mklang console: an agent-first operational TUI whose brain is a machine	Accepted (M1–M3 shipped)
0016	Host web-search tool: optional real binding, offline stub default	Accepted (tools block deferred)
0017	Context & content management: host budgets first, language zones later	Accepted (Layer 0–1; Layer 2 deferred)
0018	Output truncation detection and host recovery policies	Accepted (continue deferred)
0019	Live engine events on the MCP transport	Accepted
0020	Host tool stub architecture	Accepted
0021	Filesystem layout, config resolution, and local installation	Accepted (phases 1–3 shipped)
0022	Human-first CLI presentation and responsive console workspace	Accepted
0023	Global vs local configuration separation	Accepted
0024	Filesystem data tools with a coding-tool workspace model	Accepted