Combine zen + spec + ADRs in README.md
Context and Problem Statement
Three distinct content genres for vault metadata: zen (durable principles), spec (current folder rules), and ADRs (chronological decision log). Each has a different lifecycle. Question: where to put them.
Considered Options
- Combine all three in
README.md(zen + spec at top, ADRs in## Decisionssection). - All three in one file with mixed structure (no clear separation).
- Three separate files.
- Two files: zen + spec in
README.md, ADRs in separatedecisions.md.
Decision Outcome
Chosen option: “Combine all three in README.md”, because the same audience (me at moment of need) reads them together, section anchors preserve linkability, and root-level file count stays low.
Originally chose the two-file split (zen + spec in README, ADRs in decisions.md); merged into one file by 0015-merge-decisions-into-readme.
Status update — superseded (location aspect)
Superseded by 0018-move-adrs-to-madr-files, which moves ADRs out of README.md into Atlas/References/ADR/NNNN-title-in-dashes.md. The original spirit (zen + spec + ADRs are tracked) is preserved — only ADR location changed, driven by README bloat (~3k of ~4k words were ADR log).