The numbering is the flow: decisions are 02, design is 03
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.
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
---
|
||||
status: canonical
|
||||
updated: 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.
|
||||
Reference in New Issue
Block a user