guardian-memory

Guardian Memory

Purpose

Every project interaction creates knowledge. This skill ensures nothing is lost. Use Project-Guardian MCP tools to maintain a living knowledge graph of your project in memory.db. Every write also mirrors automatically into the central aggregate at ~/memory/memory.db, so context stays available across projects; call sync_central_memory to force a sync on demand.

Safety

• Never store credentials, tokens, private keys, or sensitive personal data in observations.
• Ask before any operation that installs hooks, modifies repository files, consolidates databases, or deletes source databases.
• Record significant work only; skip trivial reads, formatting, and transient details.

Quick Start

1. Initialize Project (First Use Only)

initialize_memory

initialize_memory creates the database schema for the active project and ensures the central memory at ~/memory/memory.db exists. It no longer installs hooks or consolidates databases: use setup_pre_commit (with user approval) for hooks, and leave GUARDIAN_AUTO_MERGE unset to keep sub-project databases separate.

If the session started outside the project directory, call set_project_root with the absolute project path first so memory is written to the right project.

Then create the project root entity:

create_entity entities=[{
  "name": "project:<project-name>",
  "entityType": "project",
  "observations": [
    "[INIT] Project created | repo: <repo-url> | stack: <tech-stack>",
    "[CONTEXT] <brief description of project goals>"
  ]
}]

2. On Every Session Start

Search for entities related to the current project, directory, file, or topic:

search_nodes query="<file-or-topic>"

Use open_node for exact entities. Use read_graph only when the graph is known to be small or the user explicitly requests a complete view.

3. During Work — Track Everything

After every significant action, record it:

add_observation observations=[{
  "entityName": "project:<name>",
  "contents": ["[<timestamp>] action: <what> | impact: <effect> | files: <list>"]
}]