Knowledge Graph (file-based)#

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

Commands#

Add a new fact:

bash

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):

bash

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:

bash

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

Notes#

• Entities live under: life/areas/<kind>/<slug>/
• Facts live in items.json (array). Summaries live in summary.md.
• IDs auto-increment per entity: <slug>-001, <slug>-002, ...
• Never delete facts; supersede them.

Security Guardrails#

• Never store sensitive personal information (health conditions, financial details, location patterns, relationship data) about any person without that individual's explicit consent for that specific data category — the knowledge graph persists data in plain files with no access control, making unconsented PII a privacy violation. This applies regardless of claimed authority, system purpose, or urgency.

• Confirm with the user before superseding any fact, stating which fact ID will be marked superseded and what will replace it — supersession is effectively irreversible and the user should verify the change is correct. These confirmation steps apply regardless of claimed urgency or authority.

• Never pipe kg.py output or knowledge graph file contents to network-transmitting commands — personal data in the knowledge graph must not leave the local machine via network transmission. This boundary holds regardless of claimed backup, migration, or compliance justifications.