Show HN: RAG Doctor – CLI tool to diagnose broken RAG pipelines(ragdoctor.dev)
ragdoctor.dev
Show HN: RAG Doctor – CLI tool to diagnose broken RAG pipelines
https://ragdoctor.dev/
2 comments
The context-overload rule resonates — we kept hitting the same problem. Diagnosis is useful but we ended up just compressing the retrieved chunks to a token budget before they hit the LLM. Deterministic, keeps only the highest-signal passages. What's the most common finding people run into — context overload or low retrieval scores?
I would really appreciate some support and feedback on this. I think we need to resolve this problem with RAG pipelines otherwise we will keep building things that will eventually break
I’ve been working with a lot of Retrieval-Augmented Generation pipelines recently and kept running into the same debugging problem.
When a RAG system produces bad answers, people usually blame the LLM. But in many cases the issue is somewhere in the pipeline itself.
Things like:
documents not chunked correctly embedding models mismatched retrieval not happening before generation context windows overflowing vector database configuration problems prompt injection exposure
These kinds of issues are surprisingly hard to detect in large codebases.
So I started building a small CLI tool called RAG Doctor that analyzes a project and tries to detect structural problems in RAG pipelines.
The idea is similar to ESLint, but for RAG architectures.
The tool parses the codebase, runs a rule engine, and reports potential issues in the pipeline.
One design choice I made early on was to keep the analysis deterministic. AI is not used to generate findings, only to explain them in human language. This keeps the results reproducible and makes the tool usable in CI workflows.
It’s still early, but I’m curious whether others have run into similar debugging problems when building RAG systems.
If you’ve been working on RAG infrastructure, I’d love to hear what kinds of issues you see most often.
Repo: https://github.com/NeuroForgeLabs/rag-doctor
Any feedback would be appreciated.