Skip to content

Schema — node types in this map

Two types. When practice and this file disagree, reconcile the same day.

type: object — a noun

Lives at objects/<cluster>/<slug>.md. Clusters are closed: storage, containers, automation, host.

Frontmatter: type, cluster, universe (live | leftover | ghost), status (stub | verified | stale), verified (YYYY-MM-DD, required when status is verified), entity (the owning file on the server).

Sections, in order: one-sentence summary · Why this shape · Shape (with citations path:line or the owning file) · Connected to (owns / owned-by / joins / looks-like-but-is-not) · If you change this (Hits / Does not hit, first-order only) · Surfaces (who reads/writes) · See (source paths; at most one prose page).

type: process — a verb that actually runs or is actually followed

Lives at processes/<slug>.md. Only real movements: something a timer, cron, or the operator triggers. Never an aspiration.

Frontmatter: type, status, verified, schedule (cron/timer string or manual), consumes / produces (relative links to object cards).

Sections: one-sentence movement · Input → Movement → Output · Why this shape · Steps (numbered, cited) · If you change this (Hits / Does not hit) · Surfaces · See.

Naming

kebab-case slugs. Cluster folders are plain nouns. _meta/, _templates/ sort to the top and are about the map, not the server. objects/_index.md, AGENTS.md, routing.md are generated by _meta/build-index.sh — never hand-edited.