jschoubben
c0b35652d0
papa-hq reads 01 research -> 03 decision -> 02 design. The order is a scar, not a choice: 02-DESIGN existed from its initial commit, and when adr/ was finally promoted on 2026-07-13 it took the next free number rather than its place in the sequence. By then design was too settled to renumber. hal-hq was three commits old, so it is not. adr/ becomes 02-DECISIONS and 02-DESIGN becomes 03-DESIGN, and following the folder numbers now walks the process in the order it happens: research produces a decision, the decision authorises a design. 00-GENESIS becomes 00-META, matching papa's rename from the same restructure. Every path reference rewritten across documents, frontmatter, playbooks and skills. All links resolve; all 58 frontmatter blocks parse and their path fields still point at files that exist.
3.2 KiB
status, updated
| status | updated |
|---|---|
| canonical | 2026-08-22 |
Mission
Vision
A mesh that controls itself.
An agent states an intent — in words, from wherever they already are — and the mesh carries it out. It takes the request in, works out what it means, does the work across whichever nodes it needs, and returns a result. No console to open, no runbook to follow, no remembering which node holds which thing.
Not automation, which does what it was told to do in advance. Self-control: the mesh holds the context, decides how, and acts.
Mission
Build the layer that turns a set of nodes into one self-controlling mesh.
- Intake, process, deliver. A request arrives, is understood, becomes work, and returns an answer. That loop is the product; everything else exists to make it possible.
- Agents inhabit the mesh. They are not scripts that run and exit. They hold identity, memory and skills, run on whichever node has room, and act continuously.
- The mesh brokers everything the work needs. Storage, credentials, compute, knowledge, delivery — requested by capability, resolved by the mesh, never by the requester knowing where things are.
Agents, some of whom are human
There is one kind of participant: the agent. Some agents are human and some are not, and the mesh does not treat that as a category difference. Both hold identity, both hold credentials, both act, remember and coordinate. What differs is modality — how an agent acts:
- a non-human agent acts through a spawned session and the record
- a human agent acts through a shell, a desktop, a message from a phone
That is why a desktop environment is as much a core concern as a knowledge store. One is how some agents remember; the other is how some agents act. Neither is a courtesy extended to a user outside the system.
What belongs in the mesh's own domain
A core module supports an agent's participation — acting, remembering, coordinating, or interfacing with the mesh.
A media server supports a human, but not their participation. It is therefore not a core module. It is still a perfectly valid HAL module — the mesh installs it, provisions for it, brokers its capabilities and ships it through the same pipeline. Entirely legitimate as a module, and no part of the mesh's own domain.
The distinction is core module versus module the mesh runs, not module versus not-a-module. Both use the same manifest, the same pipeline, the same provisioning — which is exactly what makes the mesh's own components no more privileged than anything else it carries.
Core values
- Evidence over assertion. A claim that cannot be checked will quietly stop being true. Say what was measured.
- Failure must be loud. The expensive faults are always the silent ones — work that reported success and did nothing. Prefer failing to lying.
- The mesh owns the truth. State lives in the mesh and is derived onto nodes. A file edited on a node is a bug with a delay on it.
- Sovereignty. The mesh runs on nodes it owns. External dependencies are deliberate and few.
- Dogfood everything. The mesh's own components ship through the same machinery as anything else it runs. If they need an exception, the machinery is not finished.