86 lines
2.1 KiB
Markdown
86 lines
2.1 KiB
Markdown
---
|
|
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>`
|