mirror of
https://github.com/run-llama/awesome-rag.git
synced 2026-07-01 21:14:08 -04:00
Proposal: add WFGY 16 Problem Map as RAG failure mode map #1
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @onestardao on GitHub (Feb 12, 2026).
Hi, thanks for putting together this RAG resource list.
I wanted to ask whether a failure mode taxonomy and debugging guide for RAG systems would be in scope as an additional resource.
What WFGY Problem Map is
WFGY is an open source project that defines a 16 mode failure map (No.1 to No.16) for LLM plus RAG pipelines. The modes include:
retrieval hallucination even when relevant evidence is present
vector store ingestion and index fragmentation
bootstrap ordering and infra race conditions between API gateway and vector DB
secrets and config drift only visible on first production deploy
and other quietly dangerous failure modes
Problem Map README:
https://github.com/onestardao/WFGY/tree/main/ProblemMap#readme
For each mode, there is a description, typical symptoms and suggested minimal countermeasures.
Why it might help this list
Many RAG frameworks already exist here. A concrete failure mode map gives teams:
a shared vocabulary to describe RAG outages and mis behaviour
a checklist before shipping to production
a way to organise post mortems and mitigation playbooks
Possible entry
If you think this fits the scope, one possible entry under a “Debugging / reliability / hardening” section could be:
WFGY 16 Problem Map – RAG failure mode taxonomy
Open source map of 16 real world failure modes (No.1 to No.16) for LLM plus RAG systems, with debugging checklists and mitigation ideas.
https://github.com/onestardao/WFGY/tree/main/ProblemMap#readme
If this feels out of scope for the list, no worries and thanks for considering it.