ontology

# Ontology A typed vocabulary + constraint system for representing knowledge as a verifiable graph. ## Core Concept Everything is an **entity** with a **type**, **properties**, and **relations** to other entities. Every mutation is validated against type constraints before committing. ``` Entity: { id, type, properties, relations, created, updated } Relation: { from_id, relation_type, to_id, properties } ``` ## When to Use | Trigger | Action | |---------|--------| | "Remember that..." | Create/update entity | | "What do I know about X?" | Query graph | | "Link X to Y" | Create relation | | "Show all tasks for project Z" | Graph traversal | | "What depends on X?" | Dependency query | | Planning multi-step work | Model as graph transformations | | Skill needs shared state | Read/write ontology objects | ## Core Types ```yaml # Agents & People Person: { name, email?, phone?, notes? } Organization: { name, type?, members[] } # Work Project: { name, status, goals[], owner? } Task: { title, status, due?, priority?, assignee?, blockers[] } Goal: { description, target_date?, metrics[] } # Time & Place Event: { title, start, end?, location?, attendees[], recurrence? } Location: { name, address?, coordinates? } # Information Document: { title, path?, url?, summary? } Message: { content, sender, recipients[], thread? } Thread: { subject, participants[], messages[] } Note: { content, tags[], refs[] } # Resources Account: { service, username, credential_ref? } Device: { name, ...