Merge decisions.md into README.md as Decisions section

Context and Problem Statement

Earlier ADRs (0002-combine-zen-spec-adrs-in-readme and 0003-adrs-as-single-growing-entry-list) established decisions.md as a separate file from README.md to avoid polluting the durable spec with the chronological log. In practice the two files were read together, and maintaining two root-level vault-meta files added discoverability cost.

Considered Options

• Merge decisions.md into README.md as a ## Decisions section.
• Keep them separate (status quo).
• Move both into a Meta/ folder.
• Use a Quartz/Obsidian transclude (![[decisions]]) inside README.

Decision Outcome

Chosen option: “Merge into README.md as ## Decisions section”, because reduces vault-root file count from 4 to 3, the ## Decisions heading + section anchor ([[README#decisions|Decisions]]) preserves linkability, and ADR ordering (reverse chronological) keeps the most recent decisions immediately visible at the anchor.

Supersedes the location aspect of 0002-combine-zen-spec-adrs-in-readme and 0003-adrs-as-single-growing-entry-list — those decisions remain valid in spirit (zen+spec combined for same audience; ADRs grow as a single section until volume forces split), only the location of the ADR collection moves.

Status update — superseded

Superseded by 0018-move-adrs-to-madr-files. By April 2026 the ADR section had grown to ~3k words inside README.md (out of ~4k total), bloating the spec file and exceeding the “growing list until volume forces split” threshold from 0003-adrs-as-single-growing-entry-list. ADRs moved out to per-file MADR records under Atlas/References/ADR/.

Pros and Cons of the Options

Merge into README

• Good, because reduces root-level file count.
• Good, because preserves linkability via section anchor.
• Bad, because the ADR log eventually bloats the file (manifested by April 2026).

Keep separate

• Bad, because two-file ceremony for one logical artifact.

Move both into Meta/

• Bad, because 0001-add-meta-as-top-level-folder was already superseded.

Transclude

• Bad, because transcludes don’t render uniformly across viewers (Quartz vs Obsidian vs raw GitHub).