Knowledge Graph

---

name: knowledge-graph description: Maintain Clawdbot's compounding knowledge graph under life/areas/** by adding/superseding atomic facts (items.json), regenerating entity summaries (summary.md), and keeping IDs consistent. Use when you need deterministic updates to the knowledge graph rather than manual JSON edits.

---

Knowledge Graph (file-based)

Use the bundled Python script to safely update life/areas/**.

Commands

Add a new fact:

python3 skills/knowledge-graph/scripts/kg.py add \
  --entity people/safa \
  --category status \
  --fact "Runs Clawdbot on a Raspberry Pi" \
  --source conversation

Supersede an old fact (mark old as superseded + create new fact):

python3 skills/knowledge-graph/scripts/kg.py supersede \
  --entity people/safa \
  --old safa-002 \
  --category status \
  --fact "Moved Clawdbot from Pi to a Mac mini"

Regenerate an entity summary from active facts:

python3 skills/knowledge-graph/scripts/kg.py summarize --entity people/safa

Notes

Entities live under: life/areas///

Facts live in items.json (array). Summaries live in summary.md.

IDs auto-increment per entity: -001, -002, ...

Never delete facts; supersede them.

Entities live under: life/areas///

Facts live in items.json (array). Summaries live in summary.md.

IDs auto-increment per entity: -001, -002, ...

Never delete facts; supersede them.