Agent Ontology

Create, update, and query typed entities and relations like Person, Project, and Task in a verifiable knowledge graph with validation.

Ontology Skill

Core Concept

A typed vocabulary + constraint system for representing knowledge as a verifiable graph.

When to Use

• "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

Storage

memory/ontology/graph.jsonl - append-only JSONL format

Core Types

• Person: name (required), email?, phone?, notes?
• Project: name (required), status?, goals[], description?
• Task: title (required), status (required), due?, priority?, assignee?

Relations

Relation	From	To
has_owner	Project, Task	Person
assigned_to	Task	Person
belongs_to	Task	Project
blocks	Task	Task (acyclic)

CLI Commands

python3 scripts/ontology.py create --type Person --props '{"name":"Alice"}'
python3 scripts/ontology.py list --type Person
python3 scripts/ontology.py query --type Task --where '{"status":"open"}'
python3 scripts/ontology.py get --id p_001
python3 scripts/ontology.py relate --from proj_001 --rel has_owner --to p_001

Validation

• Required properties must exist
• Enum values from predefined sets
• No circular dependencies for acyclic relations