Role
Turns loose notes into addressable knowledge that agents can route, validate, and connect.
Component / Structure
Schema & frontmatter
The typed shape of the vault: metadata, entity fields, topics, status, source links, project slugs, dates, and classification rules.
Contains
- Frontmatter on notes
- system/contracts/life-os-schema.yaml
- Topics, entities, source IDs, project slugs
- Canonical naming and field conventions
Interfaces
- Validation scripts enforce it
- Capture flows write into it
- Index/read models depend on it
Maintenance rule
When a type of note repeats, give it predictable metadata instead of relying on prose conventions.
Proof signal
Agents can filter, validate, and route records without guessing the entity, status, project, or source.
Failure mode: Without schema, the vault becomes a pile of Markdown instead of a knowledge system.