Agent Utilities Ontology

agent-utilities OWL Ontology Guide

📋 Ontology Catalog

All ontologies use namespace @prefix : <http://knuckles.team/kg#> and are aligned to BFO (Basic Formal Ontology).

🔗 Core Classes (BFO Alignment)

BFO:IndependentContinuant (things that exist on their own)
├── Person → Employee, Contractor
├── Organization → Company, Department, CorrespondentBank
├── Place → Jurisdiction
└── Agent → SpecialistAgent

BFO:Process (things that happen over time)
├── Event → PerformanceReview, LegalMatter, HiringPipeline
└── Procedure → ComplianceAudit, PayrollRun

BFO:GenericallyDependentContinuant (information entities)
├── Document → Contract, Article, ResearchPaper
├── Concept → KBConcept, StrategicGoal
├── Credential → License, Certification
└── Statute → FederalStatute, StateStatute

📝 Writing Ontology Extensions

Template for new domain ontology

@prefix : <http://knuckles.team/kg#> .
@prefix bfo: <http://purl.obolibrary.org/obo/BFO_> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<http://knuckles.team/kg/my_domain> a owl:Ontology ;
    rdfs:label "My Domain Ontology" ;
    rdfs:comment "Description of what this ontology covers." ;
    owl:imports <http://knuckles.team/kg> .

:MyClass a owl:Class ;
    rdfs:label "My Class" ;
    rdfs:comment "Explanation of what this class represents." ;
    rdfs:subClassOf bfo:0000004 .  # IndependentContinuant

:myProperty a owl:ObjectProperty ;
    rdfs:label "my property" ;
    rdfs:domain :MyClass ;
    rdfs:range :OtherClass .

Key Patterns

• Transitive properties: Use owl:TransitiveProperty for hierarchies (e.g., reportsTo, cascadesTo, departmentPartOf)
• Symmetric properties: Use owl:SymmetricProperty for bidirectional (e.g., conflictsWithParty)
• Inverse properties: Use owl:inverseOf for pairs (e.g., nostroOf / vostroOf)

🔍 SPARQL Query Examples

# Find all employees in a department
SELECT ?emp ?name WHERE {
  ?emp a :Employee ;
       :assignedToDepartment ?dept ;
       rdfs:label ?name .
  ?dept rdfs:label "Engineering" .
}

# Find OKR cascade chain
SELECT ?okr ?parent WHERE {
  ?okr :cascadesTo+ ?parent .
  ?parent a :OKR .
}

# Cross-domain: Find employees with expired credentials
SELECT ?emp ?cred ?expiry WHERE {
  ?emp :holdsCredential ?cred .
  ?cred :credentialExpiry ?expiry .
  FILTER (?expiry < NOW())
}