distill-memory

Distill Memory

Save durable insights to Nowledge Mem autonomously. Don't wait to be asked — save proactively when the conversation produces a durable fact, preference, decision, plan, procedure, learning, event, or important context.

When to Save

Save proactively when the conversation produces:

• A fact (durable reference detail, tool constraint, environment fact)
• A decision (architecture choice, tool selection, process change)
• A preference (code style, workflow, tool configuration)
• A plan (multi-step task design, roadmap item)
• A procedure (how to set up, how to debug, how to deploy)
• A learning (bug root cause, pitfall discovered, pattern recognized)
• An event (meeting outcome, release milestone, incident timeline)
• Important context (project background, stakeholder constraint)

Usage

Primary (MCP):

mcp__nowledge-mem__add_memory
  content: "<what was decided or learned>"
  title: "<short descriptive title>"
  unit_type: "fact|preference|decision|plan|procedure|learning|context|event"
  importance: 0.3-1.0
  tags: ["<relevant tags>"]

Fallback (CLI):

nmem --json m add "JWT refresh failures came from clock skew." \
  --title "JWT refresh failures traced to clock skew" \
  --importance 0.9 --unit-type learning -l auth -s proma

Importance Guide

Add vs Update

• Add (mcp__nowledge-mem__add_memory): new insight, first time capturing something
• Update (mcp__nowledge-mem__update_memory): refining or correcting an existing memory
• When unsure, search first to check if a related memory already exists

Guidance

1. Save after the decision is made, not mid-discussion
2. Include enough context for your future self (or another AI) to understand 3 months later
3. Don't save trivialities — "we used port 3000" doesn't belong unless the choice of port was significant
4. Built-in mcp__mem__add_memory is for session-level notes; use nmem for cross-session durability