ontology

• エージェントにセッションをまたいで構造化された情報を記憶させたい場合（例：「AliceがプロジェクトXを所有していることを覚えておいて」）。
• 関連するオブジェクトをリンクし、後でそのリンクをたどる必要がある場合（例：「プロジェクトZのすべてのタスクを表示して」、「Xに依存しているものは何？」）。
• 複数のスキルが生のテキストをやり取りせずに状態を共有する必要がある場合 — あるスキルがCommitmentを書き込み、別のスキルがそれをTaskとして読み取る。
• 複数ステップの作業を計画していて、各ステップを制約違反時にロールバック可能な検証済みグラフ変換としてモデル化したい場合。

• エージェントの実行間で永続性を必要とせず、一時的なシングルターンのコンテキストのみが必要な場合。
• データが純粋に非構造化されており（自由形式の文章）、モデル化すべき意味のあるエンティティの関係がない場合。
• 高い同時実行性を持つ本番グレードのグラフデータベースが必要な場合 — 大規模または複雑なグラフに対しては、SKILL.md 自体が SQLite への移行を推奨しています。

エージェント（Person、Organization）、作業（Project、Task、Goal）、時間と場所（Event、Location）、情報（Document、Message、Note）、リソース（Account、Device、Credential）を網羅する充実した定義済み型のセットを標準搭載しています。各型には型付きプロパティとオプションフィールドが備わっており、スキーマをゼロから考案することなく現実世界をモデル化できます。

すべてのミューテーションは、コミットされる前に memory/ontology/schema.yaml で定義されたルールに対して検証されます。制約には、必須フィールド、列挙値、禁止プロパティ（例：Credential における生のシークレットのブロック）、リレーションの型／カーディナリティルール、非循環性チェック、および Event における end >= start のような時間的整合性チェックが含まれます。

グラフは追記専用の memory/ontology/graph.jsonl ファイルとして保存されます。作成・更新・関連付けの各操作はすべて新しい行として追記され、完全な履歴が保持されます。複雑なグラフの場合、SKILL.md では同じインターフェースを維持しながらSQLiteへの移行を推奨しています。

scripts/ontology.py CLIは、すべてのコア操作に対応するコマンドを提供します：create、query、get、related、relate、validate、および schema-append。これにより、カスタムグラフコードを記述することなく、任意のシェルステップやエージェントアクションからスクリプト化が可能になります。

スキルは、自身の SKILL.md において ontology コントラクトを宣言し、reads（読み取り）および writes（書き込み）する型と、事前条件・事後条件を指定できます。これにより、スキル間のデータ依存関係が明示的かつ監査可能になり、ontology はケイパビリティ間の型付きメッセージバスとして機能します。

複数ステップの計画は、グラフ操作の順序付きシーケンス（CREATE → RELATE → CREATE …）としてモデル化できます。各ステップは実行前に検証され、制約違反が発生した場合は計画全体をロールバックできるため、エージェントに対して構造化された検査可能な計画レイヤーを提供します。

エージェントは Person および Project エンティティを初めて言及された時点で作成し、その後 has_owner または has_member リレーションでそれらをリンクします。以降のターンで「Aliceについて何を知っていますか？」と照会すると、グラフを横断して関連するすべてのプロジェクト、タスク、イベントを表示します。これにより、会話履歴に依存する必要がありません。

メール読み取りスキルがメッセージからコミットメントを抽出し、Commitment エンティティをontologyに書き込みます。別のタスク管理スキルが定期的に保留中の Commitment オブジェクトをクエリし、リンクされた Task エンティティを自動的に作成します。2つのスキル間に直接的な結合は必要ありません。

計画エージェントは、blocks リレーションを持つ Task エンティティの集合としてプロジェクトをモデル化します。非循環性制約により循環依存関係のコミットが防止され、related クエリによって特定のタスクを開始する前に完了しなければならない内容を即座に把握できます。

複雑なワークフロー（例：「チームミーティングをスケジュールし、フォローアップタスクを割り当てる」）を実行する前に、エージェントは各ステップを検証済みのグラフ操作に変換します。いずれかのステップが制約に違反した場合、シーケンス全体がロールバックされ、Action タイプのログを通じて安全で検査可能な実行トレイルが提供されます。