knowledge-graph

Knowledge Graph Skill

Maintain a lightweight, append-only entity graph that compounds durable facts across sessions.

When to Use

• Extract durable facts from recent work or conversation history
• Rewrite entity summaries from active facts
• Answer "what do we know about X?" without reopening large transcripts
• Keep shared context for people, companies, and projects inside the workspace

Data Model

Store the graph under:

<workspace>/life/areas/
  people/<slug>/
  companies/<slug>/
  projects/<slug>/

Each entity folder should contain:

• summary.md for the short, current snapshot
• facts.jsonl for atomic, append-only facts

Use one JSON object per line:

{
  "id": "<slug>-NNN",
  "fact": "Plain-English fact",
  "category": "relationship|milestone|status|preference|context|decision",
  "ts": "YYYY-MM-DD",
  "source": "conversation|manual|inference",
  "status": "active|superseded",
  "supersedes": "<older-id>"
}

Fact Rules

• Keep facts atomic. One durable fact per entry.
• Append new facts instead of rewriting history.
• When something changes, add a new fact and mark the old one as superseded.
• Skip ephemera, greetings, speculation, and low-value chatter.
• Check existing facts before adding duplicates.

Durable facts usually include:

• role or relationship changes
• key decisions
• long-lived preferences
• major project milestones
• stable operating context

Workflows

Fact Extraction

1. Read the recent daily note and the recent conversation window.
2. Identify durable facts worth preserving.
3. Resolve entity type and slug.
4. Create the entity folder if it does not exist.
5. Append new facts to facts.jsonl.
6. Note extraction activity in the daily note if the workspace uses one.

Weekly Synthesis

1. List entities changed during the week.
2. Load active facts only.
3. Rewrite summary.md in 3 to 8 concise lines.
4. Ensure contradicted facts are marked superseded.
5. Record a short synthesis note in the daily log if applicable.