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 ## Decisions section).
  • All three in one file with mixed structure (no clear separation).
  • Three separate files.
  • Two files: zen + spec in README.md, ADRs in separate decisions.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).