14 KiB
🧭 Not sure where to start ? Open the WFGY Engine Compass
WFGY System Map
(One place to see everything; links open the relevant section.)
| Layer | Page | What it’s for |
|---|---|---|
| ⭐ Proof | WFGY Recognition Map | External citations, integrations, and ecosystem proof |
| ⚙️ Engine | WFGY 1.0 | Original PDF-based tension engine blue |
| ⚙️ Engine | WFGY 2.0 | Production tension kernel and math engine for RAG and agents. |
| ⚙️ Engine | WFGY 3.0 | TXT-based Singularity tension engine (131 S-class set) |
| 🗺️ Map | Problem Map 1.0 | Flagship 16-problem RAG failure checklist and fix map |
| 🗺️ Map | Problem Map 2.0 | RAG-focused recovery pipeline |
| 🗺️ Map | Problem Map 3.0 | Global Debug Card — image as a debug protocol layer — 🔴 YOU ARE HERE 🔴 |
| 🗺️ Map | Semantic Clinic | Symptom → family → exact fix |
| 🧓 Map | Grandma’s Clinic | Plain-language stories, mapped to PM 1.0 |
| 🏡 Onboarding | Starter Village | Guided tour for newcomers |
| 🧰 App | TXT OS | .txt semantic OS — 60-second boot |
| 🧰 App | Blah Blah Blah | Abstract/paradox Q&A (built on TXT OS) |
| 🧰 App | Blur Blur Blur | Text-to-image with semantic control |
| 🧰 App | Blow Blow Blow | Reasoning game engine & memory demo |
| 🧪 Research | Semantic Blueprint | Modular layer structures (future) |
| 🧪 Research | Benchmarks | Comparisons & how to reproduce |
| 🧪 Research | Value Manifest | Why this engine creates $-scale value |
🚀 WFGY 3.0 · RAG 16 Problem Map — Global Debug Card
Image as a Structured Debug Prompt for RAG / Agent Pipelines
🌐 Recognition & ecosystem integration
As of 2026-03, the WFGY RAG 16 Problem Map line has been adopted or referenced by
20+ frameworks, academic labs, and curated lists in the RAG and agent ecosystem.
Most external references use the WFGY ProblemMap as a diagnostic layer for RAG / agent pipelines,
not the full WFGY product stack.
A smaller but growing set also uses WFGY 3.0 · Singularity Demo as a long-horizon TXT stress test.
Some representative integrations:
| Project | Stars | Segment | How it uses WFGY ProblemMap | Proof (PR / doc) |
|---|---|---|---|---|
| RAGFlow |  |
Mainstream RAG engine | Adds a RAG failure modes checklist guide in its official docs, adapted from the WFGY 16-problem failure map for step-by-step RAG pipeline diagnostics. | PR #13204 |
| LlamaIndex |  |
Mainstream RAG infra | Integrates the WFGY 16-problem RAG failure checklist into its official RAG troubleshooting docs as a structured failure-mode reference. | PR #20760 |
| ToolUniverse (Harvard MIMS Lab) |  |
Academic lab / tools | Provides a WFGY_triage_llm_rag_failure tool that wraps the 16-mode map for incident triage. |
PR #75 |
| Rankify (Univ. of Innsbruck) |  |
Academic lab / system | Uses the 16 failure patterns in RAG and re-ranking troubleshooting docs. | PR #76 |
| Multimodal RAG Survey (QCRI LLM Lab) |  |
Academic lab / survey | Cites WFGY as a practical diagnostic resource for multimodal RAG. | PR #4 |
For the complete 20+ project list (frameworks, benchmarks, curated lists), see the 👉 WFGY Recognition Map
If your project uses the WFGY ProblemMap and you would like to be listed,
feel free to open an issue or pull request in this repository.
A production-first failure map for RAG / agent pipelines, compressed into one portable image.
The poster defines objects, metrics, ΔS zones, failure types, and mode patterns in a single unified view.
Feed a failing run (Q, E, P, A) plus this card to any LLM.
It returns type → mode(s) → fixes → verification tests.
No external framework required.
How to use (60 seconds)
- Download the full-resolution Debug Card from this repository.
- Upload the image to any strong LLM.
- Paste your failing run context:
Q= user questionE= top-k retrieved evidenceP= final prompt sent to the modelA= model output- plus logs/metrics if available
- Ask the model to diagnose using the 16-Problem Map and propose fixes with one test per fix.
Expected output:
- ΔS zones (or best-effort estimate)
- failure type:
R / P / S / I - 1–3 matching modes (1–16)
- structural fixes + verification tests
Environment Coverage
- MLflow · Experiment tracking & RAG debugging · Medium Article
- Dask · Distributed execution & task orchestration · Medium Article
- Kedro · Pipeline structuring & ML workflow management · Medium Article (coming soon)
📥 Download the original full-resolution image directly from this repository. If this helps you, feel free to leave a ⭐ on GitHub.