Memory Skill Policy
This skill is an MCP-facing facade for memory operations. Core memory policy (lifecycle/revalidation/promotion) belongs to Rust memory core, not this skill surface.
Router Logic
Scenario 1: User wants to store a transient finding
- Analyze: Determine if the item is transient operational memory (bug/workaround/incident note)
- Store: Call
save_memory(content, metadata) - Confirm: Show the saved memory ID
Scenario 2: User wants to remember/search
- Search: Call
search_memory(query, limit) - Format: Present results with relevance scores
- Respond: "I found X memories about that..."
Scenario 3: User asks for current operational memory status
- List: Call
get_memory_stats() - Recall: Call
search_memory() with relevant keywords - Present: Show structured summary with transient scope
Commands Reference
| Command | Description | Example |
|---|
save_memory | Store short-term operational memory item | save_memory("Temporary workaround for timeout in parser", {"tag": "incident"}) |
search_memory | Semantic search in memory | search_memory("git commit format", limit=5) |
index_memory | Optimize vector index (IVF-FLAT) | index_memory() |
get_memory_stats | Get memory count | get_memory_stats() |
load_skill | Load skill manifest into memory | load_skill("git") |
Workflow: Store a Transient Workaround
User: Remember this temporary fix: increase parser timeout when MCP queue spikes.
Claude:
1. save_memory(
content="Temporary workaround: increase parser timeout under MCP queue spike",
metadata={"domain": "runtime", "kind": "workaround", "source": "user"}
)
2. → Saved memory [a1b2c3d4]: Temporary workaround: increase parser timeout...
3. → "Stored as short-term operational memory."
Workflow: Recall Recent Operational Context
User: What workaround did we use for MCP queue timeout?
Claude:
1. search_memory("MCP queue timeout workaround")
2. → Found 2 matches:
- [Score: 0.8921] Temporary workaround: increase parser timeout...
- [Score: 0.7234] Queue backpressure note...
3. → "I found recent operational memory for this issue..."
Memory vs Knowledge Skill
| Aspect | Memory (this skill) | Knowledge skill |
|---|
| Scope | Short-term operational context | Long-term reusable knowledge |
| Nature | Transient (can be purged after revalidation) | Stable (promoted/curated) |
| Purpose | "What recent issue/workaround context exists?" | "What durable rule/pattern should be reused?" |
| Policy | Managed by Rust memory core lifecycle | Managed by knowledge ingestion/curation flows |
| Exposure | MCP tool facade | MCP tool interface |
Best Practices
- Store transient operational memory, not permanent rules
- Include
kind in metadata (incident, workaround, observation) - Use clear, searchable phrasing in content
- Promote only proven durable patterns to
knowledge
