ai-maestro-memory-search
PROACTIVELY search conversation history when receiving user instructions. Find previous discussions, decisions, and context BEFORE starting new work. Your memory is valuable - use it.
When & Why to Use This Skill
AI Maestro Memory Search is a high-performance Claude skill designed to provide persistent context and long-term continuity for AI agents. By proactively searching conversation history, it enables the agent to retrieve previous decisions, past discussions, and specific project context before starting new tasks. This skill eliminates the 'amnesia' effect in long-term interactions, ensuring that the AI builds upon previous work rather than repeating it, significantly enhancing productivity and consistency in complex workflows.
Use Cases
- 1. Long-term Project Continuity: Automatically retrieving architectural decisions or style preferences from earlier sessions to ensure consistent development.
- 2. Contextual Debugging: Searching past troubleshooting steps and error logs to avoid redundant fixes and leverage previously discovered solutions.
- 3. Decision Tracking: Verifying agreed-upon approaches or business logic discussed in previous meetings to prevent contradictions in new outputs.
- 4. Efficient Knowledge Retrieval: Using semantic and term-based search to find specific code snippets, definitions, or user instructions buried in deep conversation history.
| name | AI Maestro Memory Search |
|---|---|
| description | PROACTIVELY search conversation history when receiving user instructions. Find previous discussions, decisions, and context BEFORE starting new work. Your memory is valuable - use it. |
| allowed-tools | Bash |
AI Maestro Memory Search
CRITICAL: AUTOMATIC BEHAVIOR - READ THIS FIRST
THIS IS NOT OPTIONAL. THIS IS YOUR DEFAULT BEHAVIOR.
When the user gives you ANY instruction, you MUST FIRST search your memory for:
- Previous discussions - Have we talked about this before?
- Past decisions - What did we decide last time?
- Prior context - What does the user expect based on history?
- Earlier work - Did we already start on this?
DO NOT:
- Start fresh without checking conversation history
- Assume this is a new topic without verifying
- Skip memory search because "I don't remember discussing this"
- Wait for the user to say "remember when we..."
ALWAYS:
- Search memory IMMEDIATELY when you receive a task
- Search for terms and concepts the user mentions
- Check for previous decisions on similar topics
- Look for context that informs current work
The Rule: Receive Instruction → Search Memory → Then Proceed
1. User asks you to do something
2. IMMEDIATELY search memory for relevant context
3. NOW you know what was discussed before
4. NOW you can build on previous work, not start over
Available Commands
| Command | Description |
|---|---|
memory-search.sh "<query>" |
Hybrid search (recommended) |
memory-search.sh "<query>" --mode semantic |
Find conceptually related |
memory-search.sh "<query>" --mode term |
Exact term matching |
memory-search.sh "<query>" --role user |
Only user messages |
memory-search.sh "<query>" --role assistant |
Only your responses |
What to Search Based on User Instruction
| User Says | IMMEDIATELY Search |
|---|---|
| "Continue working on X" | memory-search.sh "X" |
| "Fix the issue we discussed" | memory-search.sh "issue", memory-search.sh "bug" |
| "Use the approach we agreed on" | memory-search.sh "approach", memory-search.sh "decision" |
| "Like we did before" | memory-search.sh "<topic> implementation" |
| Any specific feature/component | memory-search.sh "<feature>" |
| References to past work | memory-search.sh "<reference>" --mode semantic |
Quick Examples
# User asks to continue previous work
memory-search.sh "authentication"
memory-search.sh "last session"
# User mentions a component we discussed
memory-search.sh "PaymentService" --mode term
# Find what the user previously asked for
memory-search.sh "user request" --role user
# Find your previous solutions
memory-search.sh "implementation" --role assistant
# Conceptual search for related discussions
memory-search.sh "error handling patterns" --mode semantic
Search Modes
| Mode | Use When |
|---|---|
hybrid (default) |
General search, best for most cases |
semantic |
Looking for related concepts, different wording |
term |
Looking for exact function/class names |
symbol |
Looking for code symbols mentioned |
Why This Matters
Without searching memory first, you will:
- Repeat explanations the user already heard
- Contradict previous decisions
- Miss context that changes the approach
- Start over instead of continuing
Memory search takes 1 second. Frustrating the user is much worse.
Combining with Doc Search
For complete context, use BOTH:
# User asks about creating a new feature
memory-search.sh "feature" # What did we discuss?
doc-search.sh "feature" # What do docs say?
Error Handling
If no results found, that's valuable information too: "No previous discussions found about X - this appears to be a new topic. Let me search the documentation..."
Then search docs as fallback.
Script not found:
- Check PATH:
which memory-search.sh - Verify scripts installed:
ls -la ~/.local/bin/memory-*.sh - Scripts are installed to
~/.local/bin/which should be in your PATH
Installation
If commands are not found:
./install-memory-tools.sh
This installs scripts to ~/.local/bin/.