๐ This is just an index repo.
Go to each problemโs folder for detailed modules, demos, and engineering walkthroughs.
๐ Main Problem Map
- Problem Map 1.0 โ Core 16 Failures
- Problem Map 2.0 โ RAG Architecture & Recovery
- Grandma Clinic โ All Bugs Made Simple (1โ16)
- Semantic Clinic โ Triage Hub
- Diagnose by Symptom โ Quick Sheet
- ๐งฉ MVP Demos โ Minimal Runnable Examples
- ๐ Global Fix Map โ Systemic AI Failures
This is the central index of AI failure modes we've tracked, diagnosed, and solved using WFGY โ a semantic reasoning engine for LLMs.
We don't just identify bugs. We redefine them as solvable cognitive flaws โ then ship modular logic patches you can drop into your system.
If your LLM has ever hallucinated, frozen, collapsed, or forgotten... chances are we've dissected it here.
Each link opens the failureโs fix page:
- Hallucination & Chunk Drift โ retrieval returns wrong/irrelevant content
- Interpretation Collapse โ chunk is right, logic is wrong
- Long Reasoning Chains โ multi-step tasks silently drift
- Bluffing / Overconfidence โ confident but unfounded answers
- Semantic โ Embedding โ cosine match โ true meaning
- Logic Collapse & Recovery โ dead-end logic; needs controlled reset
- Memory Breaks Across Sessions โ lost threads, no continuity
- Debugging is a Black Box โ no visibility into failure path
- Entropy Collapse โ attention melts, incoherent output
- Creative Freeze โ flat, literal outputs
- Symbolic Collapse โ abstract/logical prompts break
- Philosophical Recursion โ self-reference/paradox loops
- Multi-Agent Chaos โ agents overwrite/misalign logic (overview)
- Bootstrap Ordering โ services fire before deps ready
- Deployment Deadlock โ circular waits (indexโretriever, DBโmigrator)
- Pre-Deploy Collapse โ first call after deploy crashes
Multi-Agent deep dives
- Query Parsing Split (HyDE/BM25)
- Symbolic Constraint Unlock (SCU)
- Hallucination Re-entry
- Memory Desync
- Vectorstore Fragmentation
- Bootstrap Deadlock (RAG boot fence)
All patterns: Patterns Index
Examples: Examples Hub
Eval: Evaluation Suite
Ops Runbook: Ops & Monitoring
Beginner Guide: Start Here
Getting Started: RAG Quickstart
- Map-A ยท RAG Problem Table
- Map-B ยท Multi-Agent Chaos Map
- Map-C ยท Symbolic & Recursive Map
- Map-D ยท Logic Recovery Map
- Map-E ยท Long-Context Stress Map
- Map-F ยท Safety Boundary Map
- Map-G ยท Infra Boot Map
๐ Early Stargazers: Hall of Fame โ Engineers, hackers, and open-source builders who supported this project from day one.
View the Hall of Fame