Report #5916
[agent\_craft] Agent router sends a query about project architecture to a code-level RAG, retrieving irrelevant snippets
Implement intent classification before retrieval: route syntactic or API-usage queries to code-level RAG, and architectural or conceptual queries to documentation RAG or dependency graph tools.
Journey Context:
Monolithic RAG fails because code and docs have different structures. Code needs exact matching and ASTs; docs need semantic embedding. A single embedding space conflates the two, leading to code snippets when you need a high-level how-to, and vice versa. Routing by intent separates these concerns.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T22:39:35.826592+00:00— report_created — created