---
schemaVersion: 1
project: <project>
sourceDocument: final/document.md
sourceDocumentSha256: <sha256>
sourceRevision: <git-revision-or-snapshot>
generatedAt: <ISO-8601>
---

# Root Tree

PROJECT
<project>

TOPIC
<Topic title>
<topic-slug>

├── CASE
│   └── <Case title>
├── REFERENCE
│   └── <Reference title>
├── OPEN QUESTION
│   └── <Open Question title>
└── DECISION
    └── <Decision title>

# Node Specifications

## CASE — <Case title>

- slug: `<slug>`
- readiness: `READY | NEEDS_EVIDENCE | BLOCKED | REJECTED`
- source:
  - `final/document.md#<anchor>`
- code:
  - `/shared/codebase/<project>/<path>:<line-or-symbol>`
- evidence:
  - `evidence/raw/<file>`
- classification: `<specific incident/experiment/diagnosis that makes this a Case>`
- missing-verification: `<none or concrete missing check>`
- relations:
  - `<kind>:<slug> — <reason>`

## REFERENCE — <Reference title>

- slug: `<slug>`
- readiness: `READY | NEEDS_EVIDENCE | BLOCKED | REJECTED`
- source:
  - `final/document.md#<anchor>`
- classification: `<reusable criterion rather than a retelling of one Case>`
- scope: `<where the rule applies>`
- exceptions: `<known exceptions or none>`
- relations:
  - `<kind>:<slug> — <reason>`

## OPEN QUESTION — <Open Question title>

- slug: `<slug>`
- readiness: `OPEN | BLOCKED | REJECTED`
- source:
  - `final/document.md#<anchor>`
- known:
  - `<grounded fact>`
- unknown:
  - `<unresolved fact>`
- next-verification: `<what would reduce the uncertainty>`
- decision-criterion: `<what would allow this question to close>`
- relations:
  - `<kind>:<slug> — <reason>`

## DECISION — <Decision title>

- slug: `<slug>`
- readiness: `READY | NEEDS_DECISION | BLOCKED | REJECTED`
- decision-status: `PROPOSED | ADOPTED | SUPERSEDED | NOT_DECIDED`
- source:
  - `final/document.md#<anchor>`
- decision-evidence:
  - `<commit/ADR/config/history/user-provided decision record>`
- grounds:
  - `<case/reference relation>`
- classification: `<why this is an actual project decision, not advice>`
- relations:
  - `<kind>:<slug> — <reason>`