code-memory-router

name

code-memory-router

description

Routes memory and retrieval tasks between MemPalace and QMD. Use this skill whenever the user asks WHERE something is in the codebase (route to QMD), WHY something was built a certain way or what was decided (route to MemPalace), or needs BOTH code and historical context (combined). Trigger on phrases like: 'where is X', 'find X in the code', 'search the codebase for X', 'what did we decide about X', 'why does X work this way', 'show me X and why we built it', 'look up X', 'what's in the handoffs about X', 'pull the relevant files for X'. Use proactively whenever a question could benefit from codebase search OR project memory — don't wait for the user to explicitly ask for a search.

Code Memory Router

Routes requests between MemPalace (project memory) and QMD (codebase search).

Two tools. Different jobs. Not interchangeable.

Read references/tool_selection.md for routing examples and edge cases.

What each tool does

QMD — indexes your codebase and docs. Hybrid BM25 + semantic search. Finds where things live in code.

MemPalace — persistent project memory. Stores past decisions, handoffs, architectural rationale, mission history. Answers why things exist.

Discover your setup (first time or if unsure)

# See what QMD collections exist
qmd collection list

# See what MemPalace wings/rooms exist
python -m mempalace status

Use these to confirm collection and wing names before searching.

Routing Decision

Choose QMD when the question is about:

• Where a function, symbol, or pattern lives in code
• How something is implemented right now
• Finding files matching a concept or term
• "Where is X defined / called / used?"

Choose MemPalace when the question is about: