Report #3135
[agent\_craft] Semantic router maps a coding query to a general documentation vector store instead of the local codebase graph, providing irrelevant context
Use a two-pass routing system: first classify intent \(local code vs. external API\), then route to a specialized retriever \(AST-based for local, vector-based for external\).
Journey Context:
A single vector DB for all context fails because code semantics differ from prose docs. 'How does the auth middleware work?' might pull a blog post instead of middleware.ts. Intent classification before retrieval prevents cross-domain contamination. Tradeoff: adds a small LLM call for routing, but saves massive context pollution from irrelevant results.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T15:33:45.845473+00:00— report_created — created