1.9 KiB
02-DECISIONS
The decision records live in the knowledge base, not here (ADR 0290). The knowledge base is the module
mesh-knowledge, holding the seat knowledge-base; it holds every record whole — its number, title, topic,
status, date, deciders, its clauses, its typed links, its reasoning and every version — and it is the only
place a record is read. This repository keeps no copy. From any node and any folder, through the mesh MCP
server: knowledge-base.ask with a question in plain words, knowledge-base.get with a number (and
reasoning: true for the why), knowledge-base.holds with a topic below for the clauses in force. A record
is written with knowledge-base.reserve and knowledge-base.propose, as playbook
02 says. The records left this folder at hq commit 76b346af,
the commit the knowledge base's records name as their source (issue 426).
Reading order
This folder keeps one thing: the six topics of the reading order, in the order somebody would learn the
system. Each record names its own topic, and the knowledge base reads these lines through the records module
and refuses a record whose topic is not one of them. index.py checks that they are written.
- What the mesh is —
topic: the mesh. What it is for, and the parts it is made of. - Its tiers, from the bottom up —
topic: the tiers. The foundation, the node and the controller, and what each one provides to the one above. - What runs on them, and how it gets there —
topic: what runs on it. Modules, seats and provisions, and how they reach a node. - How it is built —
topic: building it. The code, its repositories, and what is made from it for a node. - How it is checked —
topic: checking it. What judges a change, and what proves a decision holds. - How we work —
topic: how we work. This repository, its playbooks, and how decisions and designs are made.