Each file records one decision: what was on the table, what was advised, what was decided, and what it costs. Written when the decision was made.
The point is not ceremony. In a project where most of the characters were written by a model, the decisions are the part that is unambiguously human, and a repository that does not record them cannot show the difference between direction and dictation.
Decisions are owned by KalevIT. Where advice was given it is recorded as advice, including where it was overruled.
| # | Decision | Date | Status |
|---|---|---|---|
| 0001 | One engine, one config file per exam | 2026-07-28 | Accepted |
| 0002 | Sample exams from official objective weights | 2026-07-28 | Accepted, integration pending |
| 0003 | The exam config is JavaScript, not JSON | 2026-07-28 | Accepted |
| 0004 | Ship an engine and an original sample; personal pools stay local | 2026-07-28 | Accepted |
| 0005 | Explicit attribution, no Co-Authored-By |
2026-07-28 | Accepted |
| 0006 | Document open defects rather than only fixed ones | 2026-07-28 | Accepted |
Copy the structure of an existing file. Number sequentially, never reuse a number, never
delete a record — supersede it and mark the old one Superseded by ADR-XXXX. A decision
that was later reversed is more informative than one that was quietly removed.