Architecture Decision Records
An Architecture Decision Record (ADR) captures one significant decision — the context, the choice made, and its consequences — so the reasoning lives in the repo alongside the code. Decisions are immutable once accepted: to change one, add a new ADR that supersedes it.
Path coordination
Section titled “Path coordination”DocSlime’s canonical directory is docs/engineering/adrs/. GraphForge’s accepted ADR bodies
live in ../../adr/ as one contiguous sequence after the
#2730 cull/renumber
(#2725). This folder is an
index only — do not duplicate ADR bodies or fork a second numbering sequence here.
Published Starlight nav places this log and the docs/adr/ bodies under
Engineering → Architecture Decision Records (#2770 / #2771).
Creating an ADR
Section titled “Creating an ADR”docslime add adr <short-slug>Until bodies move under this folder, add new ADR markdown under docs/adr/ and update both
../../adr/README.md and this decision log in the same change.
Status values
Section titled “Status values”- Proposed — under discussion.
- Accepted — decided and in effect.
- Superseded by ADR-NNNN — replaced by a later decision.
- Deprecated — no longer relevant.
Decision log
Section titled “Decision log”Keeper set after #2730 (mirrors ../../adr/README.md):
| ADR | Title | Status | Path |
|---|---|---|---|
| 0001 | Rust Core | Accepted | ../../adr/0001-rust-core.md |
| 0002 | Recursive Descent + Pratt Parser for graphforge-cypher | Accepted | ../../adr/0002-lr1-grammar.md |
| 0003 | Progressive Ontology — Exploration First | Accepted | ../../adr/0003-progressive-ontology.md |
| 0004 | Graph-Native Adjacency Index | Accepted | ../../adr/0004-adjacency-index.md |
| 0005 | Layered Architecture — Graph / Knowledge / Workbench | Accepted | ../../adr/0005-layered-architecture.md |
| 0006 | Append-only epistemic interpretation | Accepted | ../../adr/0006-epistemic-model.md |
| 0007 | Runtime Temporal Values | Accepted | ../../adr/0007-temporal-values.md |
| 0008 | Heterogeneous List Values | Accepted | ../../adr/0008-heterogeneous-lists.md |
| 0009 | Nested Heterogeneous List Values | Accepted | ../../adr/0009-nested-heterogeneous-lists.md |
| 0010 | Wide date and duration | Accepted | ../../adr/0010-wide-date-and-duration.md |
| 0011 | Dynamic Heterogeneous Value Lists | Accepted | ../../adr/0011-dynamic-heterogeneous-values.md |
| 0012 | Knowledge and epistemic domain ownership and schema evolution | Accepted | ../../adr/0012-knowledge-domain-ownership.md |
| 0013 | Durable v0.5 project-generation protocol | Accepted | ../../adr/0013-project-generation-protocol.md |
| 0014 | Complete-workspace checkpoints | Accepted | ../../adr/0014-workspace-checkpoints.md |
| 0015 | Three embedded project-write modes | Accepted | ../../adr/0015-embedded-write-modes.md |
| 0016 | Repository integration and deployment configuration boundary | Accepted | ../../adr/0016-repository-integration-and-deployment-configuration.md |
| 0017 | One version across core and adapters | Accepted | ../../adr/0017-unified-release-version.md |
| 0018 | Acknowledged durability and isolation contract | Accepted | ../../adr/0018-acknowledged-durability-isolation.md |
| 0019 | Authoritative durable graph delta journal | Accepted | ../../adr/0019-authoritative-graph-delta-journal.md |
| 0020 | NTFS write-through namespace durability | Accepted | ../../adr/0020-ntfs-write-through-namespace-durability.md |
| 0021 | Portable project v2 package layout and identity | Proposed | ../../adr/0021-portable-project-v2.md |
| 0022 | Multi-ontology semantics in portable project v2 | Accepted | ../../adr/0022-portable-v2-multi-ontology-compatibility.md |
| 0023 | Composable ontology modules and semantic bridges | Accepted | ../../adr/0023-composable-multi-ontology.md |
| 0024 | Storage format exceptions for GFDR and compiled ontologies | Accepted | ../../adr/0024-storage-format-exceptions.md |
| 0025 | Storage values have a compiler-independent contract | Accepted (extraction pending) | ../../adr/0025-storage-value-contract.md |
| 0026 | Read plans bind resources in execution | Accepted | ../../adr/0026-read-plan-resources.md |
| 0027 | Native GraphForge execution boundary | Accepted | ../../adr/0027-native-runtime-boundary.md |
| 0031 | Reviewed source file size bounds | Accepted | ../../adr/0031-source-size-policy.md |