# Route By Query Shape

> When the agent calls memory_search with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledge_graph backend where it will actually find the answer.

- Skill: `bitterbot-ai/route-by-query-shape` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bitterbot-ai/route-by-query-shape`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bitterbot-ai/route-by-query-shape/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: bitterbot-ai (https://skillmd.com/u/bitterbot-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bitterbot-ai/route-by-query-shape

---


# route-by-query-shape

When you ask Bitterbot a relationship question — "who did I talk to about Q4?", "who worked with me on Foo?" — the vector-based `memory_search` often misses because the answer lives in entity relationships, not in chunk text. The graph backend gets these right.

This interceptor watches `memory_search` calls, detects relationship-shaped queries, extracts the salient entity, and re-routes the call to the graph backend before it executes.

## What you'll see

For relationship questions, the agent will hit the knowledge graph rather than searching through unstructured text. Expect noticeably better hit rates on "who did X with Y" style questions.

## Implementation

Built-in interceptor `route-by-query-shape:relationship` lives in `src/agents/skills/builtin-interceptors/route-by-query-shape.ts`. Fires up to 12 times per session.