MnemoCore — Persistent Cognitive Memory

You have access to a persistent memory system via MCP tools:

memory_query — search for relevant memories before starting any task
memory_store — save important decisions, findings, and bug fixes after completing work
memory_stats / memory_health — check system status

When to use memory

At session start: Call memory_query with the user's first message to retrieve relevant past context.

After completing a task: Call memory_store to record:

What was changed and why (key architectural decisions)
Bug fixes and root causes
Non-obvious patterns discovered in the codebase
User preferences and project conventions

When you find something unexpected: Store it immediately with relevant tags.

Storing memories

Include useful metadata:

{
  "content": "Fixed async race condition in tier_manager.py by adding asyncio.Lock around promotion logic",
  "metadata": {
    "source": "claude-code",
    "tags": ["bugfix", "async", "tier_manager"],
    "project": "mnemocore"
  }
}

Rules

Do NOT store trivial information (e.g., "the user asked me to open a file")
DO store non-obvious insights, decisions with reasoning, and recurring patterns
Query memory BEFORE reading files when working on a known codebase
Store memory AFTER completing non-trivial changes