Files
hq/03-DESIGN/00-as-is/07-knowledge.md
T
jschoubben 37b46d5349 ADR 0153 and ADR 0154: the record is read by a module, and the mesh's verbs are its seat's tools
Design 33 in progress against ADR 0154 (the twelve verbs, the prerequisites built); design 35 for
the records module under ADR 0153, extending 0025; as-is 07 rewritten to a mesh that keeps no store;
as-is 12 and 13 updated; issue 006 built and waiting on its live check.
2026-09-30 17:47:49 +02:00

3.1 KiB

layer, status, code, updated, decisions
layer status code updated decisions
as-is implemented
mesh-catalog modules/records
mesh-catalog modules/mesh-console
2026-09-30
02-DECISIONS/0025-the-design-record-is-read-not-copied.md
02-DECISIONS/0153-the-record-is-read-by-a-module-and-the-console-lists-it.md
02-DECISIONS/0152-the-operators-surface-is-a-module-the-console.md

Knowledge

The mesh keeps no knowledge store. What it knows is what its modules answer, and the way a person or an agent asks is the console's tool list on the machine they sit at (13 — The console). This document used to describe two stores; it is rewritten because neither exists from the mesh's side, and an as-is document that describes what is gone is a brochure.

What was here, and where it went

Until the cut-over of 2026-09-28 the predecessor ran two stores: an operational memory of notes indexed on symptoms, and a structured archive of governed documents with a librarian approving promotion. Both were reached through the predecessor's tool server over the bus the mesh removed (issue 147). Nothing in the mesh reaches them now, and nothing in the mesh has replaced them: there is no note store, no archive, no librarian, and the lessons of the last days were written into this repository by hand. That is a gap, and it is stated here rather than papered over. What replaces a symptom-indexed memory, if anything does, is undecided.

The record

The design record is read where it is written. Since 2026-09-30 a module, records, keeps a checkout of this repository from the forge — cloned from the git seat, reset to the origin on every merge the forge announces and every ten minutes — and answers over the bus: where a phrase appears as written, one document whole, what a folder holds, and where the checkout stands, each naming the commit it read. Which repository it reads is a setting on its assignment; the module names no mesh.

It is listed by the console beside every other tool, with a description that says to search the literal words of a symptom before forming a hypothesis. That is what ADR 0025 meant by beside everything else, in a mesh with no store to be beside (ADR 0153).

Nothing is copied. A checkout lags the source by seconds after an announced merge and by minutes otherwise, and says so.

The constitution

00-META/how-we-build.md is the source of the mesh constitution (ADR 0021). The page it used to be synchronised into lived in the predecessor's archive and is unreachable; the constitution today is read from this repository, through the same module, and playbook 05's sync has nothing to write to.

Where this repository sits

A third thing beside two that are gone, which makes it the first: the one governed record the mesh has, public, read by a module the mesh assigns, and edited nowhere else.