memory-recall

name	memory-recall
description	This skill should be used when the user asks about "past decisions", "previous learnings", "what did we decide", "how did we solve", "remember when", or mentions topics that may have stored memories. Also triggers when working on tasks where historical context would be valuable, such as "working on authentication", "implementing the database", or encountering errors similar to previously resolved issues.
version	0.3.0
allowed-tools	["Bash","Read"]

Memory Recall Skill

Automatically recalls relevant memories from the git-backed memory system to provide historical context during conversations.

Purpose

This skill bridges the gap between conversations by surfacing relevant decisions, learnings, context, and patterns stored in the git notes memory system. It helps maintain continuity across sessions and prevents re-solving problems that have already been addressed.

When This Skill Activates

Direct Triggers

• Questions about past work: "what did we decide about...", "how did we handle...", "why did we choose..."
• Explicit recall requests: "recall", "remember when", "previously", "last time"
• Decision inquiries: "what was the reasoning", "why are we using..."

Contextual Triggers

• Starting work on a feature that has related memories
• Encountering errors similar to previously resolved issues
• Discussing topics with high relevance scores to stored memories
• Beginning tasks where historical context would be valuable

Core Workflow

Step 1: Context Extraction

Extract key concepts from the current conversation:

from git_notes_memory import get_recall_service

recall = get_recall_service()

# Extract concepts from recent messages
concepts = extract_concepts(conversation_context)
# Examples: file names, function names, error messages, technology terms

Step 2: Memory Search

Perform semantic search across namespaces:

python3 -c "
from git_notes_memory import get_recall_service

recall = get_recall_service()
results = recall.search(
    query='''$EXTRACTED_CONCEPTS''',
    k=5,
    min_similarity=0.7  # Only high-relevance results
)

for r in results:
    print(f'{r.memory.namespace}: {r.memory.summary} (score: {r.similarity:.2f})')
"

Step 3: Format Results

Present memories in a non-intrusive summary:

**Relevant Memories Found** (3 matches)

1. **Decisions** (0.92 relevance): Use PostgreSQL for JSONB support
2. **Learnings** (0.85 relevance): Connection pooling prevents timeouts
3. **Progress** (0.78 relevance): Database schema in migrations/

_Use `/memory:recall` for more details or `/memory:search` for custom queries._

Configuration

The skill respects environment variables:

Variable	Default	Description
MEMORY_AUTO_RECALL	true	Enable/disable automatic recall
MEMORY_RECALL_THRESHOLD	0.7	Minimum similarity score
MEMORY_RECALL_LIMIT	3	Maximum memories to surface

Namespace Reference

The memory system supports 10 namespaces:

Namespace	Contains	Example Query
inception	Problem statements, scope, success criteria	"project goals", "what are we building"
elicitation	Requirements clarifications, constraints	"requirements", "must support"
research	External findings, technology evaluations	"compared options", "evaluated"
decisions	Architectural and design decisions	"database selection", "auth approach"
progress	Task completions, milestones	"completed phase", "finished"
blockers	Obstacles and impediments	"stuck on", "blocked by"
reviews	Code review findings	"code review", "security finding"
learnings	Knowledge discoveries	"pytest fixtures", "async patterns"
retrospective	Post-mortems and retrospectives	"project retrospective", "lessons learned"
patterns	Recurring solutions	"error handling", "API patterns"

Memory Expansion and Hydration

Memories in <memory_context> are summaries only to save token budget. When a memory is highly relevant to the current task, you should expand it.

Auto-Expansion Triggers

Expand a memory automatically when:

• Relevance > 0.85: High semantic similarity to current task
• Active blocker: Memory is in blockers namespace and may be recurring
• Decision context: User is making a similar decision and past context helps

How to Expand Memories

1. Use recall command:

   /memory:recall <memory-id>
   

   Example: /memory:recall decisions:abc123:0

2. Check git commits for file context: Memory IDs contain commit SHAs: namespace:COMMIT_SHA:index

   git show abc123 --name-only  # See files changed with this memory
   

3. Reference expanded content in your response:

   • "Based on the decision (decisions:abc123:0), we chose PostgreSQL because..."
   • "This is similar to a previous blocker (blockers:def456:0) which was resolved by..."

When to Use Summaries Only

• Memory is tangentially related (relevance < 0.7)
• User is just exploring, not deeply working on the topic
• Multiple memories match - summarize first, expand on request

Non-Intrusive Design Principles

1. Relevance threshold: Only surface memories above 0.7 similarity
2. Limited output: Show brief summaries, not full content
3. Auto-expand high relevance: Expand memories above 0.85 automatically
4. No interruption: Don't break user's flow mid-thought
5. Escape hatch: Can be disabled via environment variable
6. On-demand detail: Full content available via /memory:recall

Integration Examples

Automatic Context Loading

When user starts: "I'm working on the authentication system"

The skill:

1. Extracts "authentication system" as the query
2. Searches all namespaces
3. Surfaces relevant decisions, learnings, and patterns

Error Resolution

When user encounters: "Getting a connection timeout error"

The skill:

1. Extracts "connection timeout error"
2. Searches for similar past issues
3. Surfaces relevant learnings and patterns

Decision Inquiry

When user asks: "Why are we using Redis for caching?"

The skill:

1. Extracts "Redis caching" as the query
2. Focuses on decisions namespace
3. Surfaces the original decision with reasoning

Related Commands

• /memory:capture - Store new memories
• /memory:recall - Manual recall with options
• /memory:search - Advanced search with filters
• /memory:sync - Synchronize memory index
• /memory:status - Check system health

Additional Resources

Reference Files

For detailed implementation patterns:

• references/search-optimization.md - Query optimization techniques
• references/namespace-guide.md - When to use each namespace

Example Files

Working examples in examples/:

• examples/auto-recall.py - Automatic context extraction
• examples/filtered-search.py - Namespace-filtered queries