document-haness/docs/_templates/root-tree.md

schemaVersion, project, sourceDocument, sourceDocumentSha256, sourceRevision, generatedAt

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

Root Tree

PROJECT

TOPIC

├── CASE │ └── ├── REFERENCE │ └── ├── OPEN QUESTION │ └── └── DECISION └──

Node Specifications

CASE —

• 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 —

• 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 —

• 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 —

• 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>