mem-search

# Memory Search Skill

Search your Claude Code knowledge base to find relevant information.

## When to Use

- Finding how a previous error was solved
- Recalling decisions made about the codebase
- Looking up patterns used before
- Getting context about a file's history
- Finding knowledge and learnings

## Usage

The skill accepts a natural language query. Examples:

```
/mem-search authentication error fix
/mem-search database schema decisions
/mem-search how did we handle caching
/mem-search API rate limiting patterns
```

## Workflow

1. **Analyze the Query**
   - Determine if they're looking for an error, decision, pattern, or general info
   - Identify any project context

2. **Search Strategy**
   - Use `mem_search` with appropriate filters
   - For errors: filter by `type: error`
   - For decisions: filter by `type: decision`
   - For patterns: filter by `type: pattern`
   - For knowledge: filter by `type: learning`

3. **Present Results**
   - Show a summary of top matches
   - Show title, type, and path for each result
   - Offer to show full details with `mem_read`

## Output Format

Present results clearly:

```markdown
## Found X results for "query"

### [Title]
**Type**: type | **Path**: `path/to/note.md`
**Project**: project-name

---

Would you like me to show the full details of any of these?

Note: Search returns lightweight results. Use mem_read for full note content.
```

## Advanced Usage

If the user wants project-wide context:
```
mem_project_context({ project: "project-name" })
```

This returns unresolved errors, active decisions, and patterns for the project.