Architecture decision records

Generated section

Generated by scripts/gen_docs.py from docs/adr/. Do not edit it by hand: change the source, then run uv run python scripts/gen_docs.py.

Each ADR records one decision: its context, the decision, the consequences, and what would make the team reverse it. The originals live in docs/adr/.

ADR	Decision	Status	Date
0001	Build Ratchet	accepted	2026-10-16
0002	Capture via an inference proxy	accepted	2026-10-16
0003	Hold the agent's model tier constant across replay	accepted	2026-10-16
0004	Git main/candidate as the skill version store	accepted	2026-10-16
0005	Cassettes for side-effecting tools	accepted	2026-10-16
0006	Level 0 deterministic check before any model	accepted	2026-10-16
0007	Agreement rules	accepted	2026-10-16
0008	Drift is a first-class pair outcome	accepted	2026-10-16
0009	Personal AI track	accepted	2026-10-16
0010	OpenShell primary, Docker fallback	accepted	2026-10-16
0011	Serverless Jobs for replays; VM for the control plane	accepted	2026-10-16
0012	MinimalRunner fallback harness	accepted	2026-10-16
0013	Feature freeze	accepted	2026-10-16
0014	No paper prose before Nov 1	accepted	2026-10-16
0015	Dark-first UI with word-plus-color chips	accepted	2026-10-16
0016	Anonymous first-party demo analytics only	accepted	2026-10-16
0017	Process sandbox for development	accepted	2026-10-15
0018	Offline simulator upstream	accepted	2026-10-15
0019	API prefix	accepted	2026-10-15
0020	Ultra confirms cascade blocks; changed args are not new calls	accepted	2026-10-15
0021	A merge never ships an earlier held edit	accepted	2026-10-15
0022	Hardening after the 2026-10-16 security and spec review	accepted	2026-10-16
0023	Control replays settle contested pairs	accepted	2026-10-16
ADR 0024	Level 0 gates the Nano-only pass	—	—