ontology

• Je wilt dat een agent gestructureerde informatie onthoudt tussen sessies (bijv. "Onthoud dat Alice eigenaar is van Project X").
• Je moet gerelateerde objecten koppelen en die koppelingen later doorlopen (bijv. "Toon alle taken voor project Z", "Wat is afhankelijk van X?").
• Meerdere skills moeten toestand delen zonder ruwe tekst door te geven — één skill schrijft een Commitment, een andere leest die als een Task.
• Je bent meerstaps werk aan het plannen en wilt elke stap gemodelleerd hebben als een gevalideerde graaftransformatie met terugdraaiing bij een constraint-overtreding.

• Je hebt alleen tijdelijke, enkelvoudige context nodig en hebt geen behoefte aan persistentie tussen agent-runs.
• Je data is puur ongestructureerd (vrije-vorm proza) zonder betekenisvolle entiteitsrelaties om te modelleren.
• Je hebt een productieklare grafdatabase nodig met hoge gelijktijdigheid — voor grote of complexe grafen raadt de SKILL.md zelf aan om te migreren naar SQLite.

Wordt geleverd met een uitgebreide set vooraf gedefinieerde typen voor agenten (Person, Organization), werk (Project, Task, Goal), tijd en plaats (Event, Location), informatie (Document, Message, Note) en resources (Account, Device, Credential). Elk type bevat getypeerde eigenschappen en optionele velden, zodat je de echte wereld kunt modelleren zonder vanaf nul schema's te hoeven bedenken.

Elke mutatie wordt gevalideerd aan de hand van regels die zijn gedefinieerd in memory/ontology/schema.yaml voordat deze wordt doorgevoerd. Beperkingen omvatten verplichte velden, enum-waarden, verboden eigenschappen (bijv. het blokkeren van onbewerkte geheimen op Credential), type- en kardinaliteitsregels voor relaties, acycliciteitscontroles en temporele integriteitschecks zoals end >= start op Event.

De graaf wordt opgeslagen als een append-only memory/ontology/graph.jsonl-bestand — elke aanmaak-, update- en relateeroperatie is een nieuwe regel, waardoor de volledige geschiedenis bewaard blijft. Voor complexe grafen raadt de SKILL.md aan om te migreren naar SQLite, met behoud van dezelfde interface.

Een scripts/ontology.py CLI biedt opdrachten voor alle kernbewerkingen: create, query, get, related, relate, validate en schema-append. Hierdoor is het scriptbaar vanuit elke shellstap of agentactie, zonder dat er aangepaste grafiekcode hoeft te worden geschreven.

Skills kunnen een ontology-contract declareren in hun eigen SKILL.md, waarin ze specificeren welke typen ze reads en writes, inclusief pre- en postcondities. Dit maakt onderlinge gegevensafhankelijkheden tussen skills expliciet en controleerbaar, waardoor de ontology fungeert als een getypeerde berichtenbus tussen capabilities.

Meerstappige plannen kunnen worden gemodelleerd als geordende reeksen van graafbewerkingen (CREATE → RELATE → CREATE …). Elke stap wordt gevalideerd vóór uitvoering en het volledige plan kan worden teruggedraaid bij een constraintschending, wat agenten een gestructureerde, inspecteerbare planningslaag biedt.

Een agent maakt Person- en Project-entiteiten aan de eerste keer dat ze worden genoemd, en koppelt ze vervolgens met has_owner- of has_member-relaties. Bij toekomstige beurten doorzoekt de vraag "Wat weet ik over Alice?" de graph om alle gerelateerde projecten, taken en gebeurtenissen naar boven te brengen, zonder afhankelijk te zijn van de gespreksgeschiedenis.

Een e-mailleesvaardigheid haalt een toezegging uit een bericht en schrijft een Commitment-entiteit naar de ontology. Een afzonderlijke taakbeheervaardigheid bevraagt periodiek openstaande Commitment-objecten en maakt automatisch gekoppelde Task-entiteiten aan — zonder directe koppeling tussen de twee vaardigheden.

Een planningsagent modelleert een project als een reeks Task-entiteiten met blocks-relaties. De acycliciteitsbeperking voorkomt dat circulaire afhankelijkheden worden vastgelegd, en een related-query toont onmiddellijk wat voltooid moet zijn voordat een bepaalde taak kan beginnen.

Voordat een complexe workflow wordt uitgevoerd (bijv. "Plan teamvergadering en wijs vervolgacties toe"), converteert de agent elke stap naar een gevalideerde grafiekoperatie. Als een stap een beperking schendt, wordt de volledige reeks teruggedraaid, wat zorgt voor een veilig en inspecteerbaaruitvoeringslogboek via het Action-type log.