Reference
Reference
The decisions, and the house style.
Decision records
Twenty-one ADRs. The handbook says what is true; these say why.
Conventions
Naming, layout, comments, and the gates.
The doc taxonomy
Five documents, five different jobs. Putting the wrong content in one of them is how a set of docs starts contradicting itself.
| File | Job | Tense |
|---|---|---|
docs/lifeos-finloop-spec.md | the binding contract | future / imperative |
docs/architecture.md | what is true today | present |
docs/adr/ | why a decision was made, and what it cost | past |
docs/run-log.md | what happened on each build run | past |
AGENTS.md | how to work in here without breaking the house | imperative |
This handbook is the reading surface over them. Where it disagrees with the spec, the spec wins.