└── README.md


/README.md:
--------------------------------------------------------------------------------
  1 | # WFGY Problem Map — Index of AI Failures We've Solved
  2 | 
  3 | > 📌 **This is just an index repo.**  
  4 | > Go to each problem’s folder for detailed modules, demos, and engineering walkthroughs.  
  5 | > 👉 **[Main Problem Map](https://github.com/onestardao/WFGY/tree/main/ProblemMap)**
  6 | 
  7 | <img width="1536" height="1024" alt="Hero" src="https://github.com/user-attachments/assets/a73aac28-c133-4fcb-9643-fb2756736e02" />
  8 | 
  9 | ---
 10 | 
 11 | ## 🚀 Start Here (shortcuts)
 12 | 
 13 | - **[Problem Map 1.0 — Core 16 Failures](https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md)**
 14 | - **[Problem Map 2.0 — RAG Architecture & Recovery](https://github.com/onestardao/WFGY/blob/main/ProblemMap/rag-architecture-and-recovery.md)**
 15 | - **[Grandma Clinic — All Bugs Made Simple (1–16)](https://github.com/onestardao/WFGY/tree/main/ProblemMap/GrandmaClinic)**
 16 | - **[Semantic Clinic — Triage Hub](https://github.com/onestardao/WFGY/blob/main/ProblemMap/SemanticClinicIndex.md)**
 17 | - **[Diagnose by Symptom — Quick Sheet](https://github.com/onestardao/WFGY/blob/main/ProblemMap/Diagnose.md)**
 18 | - **[🧩 MVP Demos — Minimal Runnable Examples](https://github.com/onestardao/WFGY/blob/main/ProblemMap/mvp_demo/README.md)**
 19 | - **[🌍 Global Fix Map — Systemic AI Failures](https://github.com/onestardao/WFGY/blob/main/ProblemMap/GlobalFixMap/README.md)**
 20 | 
 21 | 
 22 | ---
 23 | 
 24 | ## 🧠 What is WFGY Problem Map?
 25 | 
 26 | This is the central index of AI failure modes we've tracked, diagnosed, and solved using **WFGY** — a semantic reasoning engine for LLMs.
 27 | 
 28 | We don't just identify bugs. We redefine them as solvable cognitive flaws — then ship modular logic patches you can drop into your system.
 29 | 
 30 | > If your LLM has ever hallucinated, frozen, collapsed, or forgotten... chances are we've dissected it here.
 31 | 
 32 | ---
 33 | 
 34 | ## 🧭 Problem Categories (Core 16)
 35 | 
 36 | Each link opens the failure’s fix page:
 37 | 
 38 | 1. **[Hallucination & Chunk Drift](https://github.com/onestardao/WFGY/blob/main/ProblemMap/hallucination.md)** — retrieval returns wrong/irrelevant content  
 39 | 2. **[Interpretation Collapse](https://github.com/onestardao/WFGY/blob/main/ProblemMap/retrieval-collapse.md)** — chunk is right, logic is wrong  
 40 | 3. **[Long Reasoning Chains](https://github.com/onestardao/WFGY/blob/main/ProblemMap/context-drift.md)** — multi-step tasks silently drift  
 41 | 4. **[Bluffing / Overconfidence](https://github.com/onestardao/WFGY/blob/main/ProblemMap/bluffing.md)** — confident but unfounded answers  
 42 | 5. **[Semantic ≠ Embedding](https://github.com/onestardao/WFGY/blob/main/ProblemMap/embedding-vs-semantic.md)** — cosine match ≠ true meaning  
 43 | 6. **[Logic Collapse & Recovery](https://github.com/onestardao/WFGY/blob/main/ProblemMap/logic-collapse.md)** — dead-end logic; needs controlled reset  
 44 | 7. **[Memory Breaks Across Sessions](https://github.com/onestardao/WFGY/blob/main/ProblemMap/memory-coherence.md)** — lost threads, no continuity  
 45 | 8. **[Debugging is a Black Box](https://github.com/onestardao/WFGY/blob/main/ProblemMap/retrieval-traceability.md)** — no visibility into failure path  
 46 | 9. **[Entropy Collapse](https://github.com/onestardao/WFGY/blob/main/ProblemMap/entropy-collapse.md)** — attention melts, incoherent output  
 47 | 10. **[Creative Freeze](https://github.com/onestardao/WFGY/blob/main/ProblemMap/creative-freeze.md)** — flat, literal outputs  
 48 | 11. **[Symbolic Collapse](https://github.com/onestardao/WFGY/blob/main/ProblemMap/symbolic-collapse.md)** — abstract/logical prompts break  
 49 | 12. **[Philosophical Recursion](https://github.com/onestardao/WFGY/blob/main/ProblemMap/philosophical-recursion.md)** — self-reference/paradox loops  
 50 | 13. **[Multi-Agent Chaos](https://github.com/onestardao/WFGY/blob/main/ProblemMap/Multi-Agent_Problems.md)** — agents overwrite/misalign logic (overview)  
 51 | 14. **[Bootstrap Ordering](https://github.com/onestardao/WFGY/blob/main/ProblemMap/bootstrap-ordering.md)** — services fire before deps ready  
 52 | 15. **[Deployment Deadlock](https://github.com/onestardao/WFGY/blob/main/ProblemMap/deployment-deadlock.md)** — circular waits (index⇆retriever, DB⇆migrator)  
 53 | 16. **[Pre-Deploy Collapse](https://github.com/onestardao/WFGY/blob/main/ProblemMap/predeploy-collapse.md)** — first call after deploy crashes  
 54 | 
 55 | **Multi-Agent deep dives**  
 56 | - **[Role Drift](https://github.com/onestardao/WFGY/blob/main/ProblemMap/multi-agent-chaos/role-drift.md)**  
 57 | - **[Cross-Agent Memory Overwrite](https://github.com/onestardao/WFGY/blob/main/ProblemMap/multi-agent-chaos/memory-overwrite.md)**
 58 | 
 59 | ---
 60 | 
 61 | ## 🧩 Patterns Library (targeted fixes)
 62 | 
 63 | - **[Query Parsing Split (HyDE/BM25)](https://github.com/onestardao/WFGY/blob/main/ProblemMap/patterns/pattern_query_parsing_split.md)**
 64 | - **[Symbolic Constraint Unlock (SCU)](https://github.com/onestardao/WFGY/blob/main/ProblemMap/patterns/pattern_symbolic_constraint_unlock.md)**
 65 | - **[Hallucination Re-entry](https://github.com/onestardao/WFGY/blob/main/ProblemMap/patterns/pattern_hallucination_reentry.md)**
 66 | - **[Memory Desync](https://github.com/onestardao/WFGY/blob/main/ProblemMap/patterns/pattern_memory_desync.md)**
 67 | - **[Vectorstore Fragmentation](https://github.com/onestardao/WFGY/blob/main/ProblemMap/patterns/pattern_vectorstore_fragmentation.md)**
 68 | - **[Bootstrap Deadlock (RAG boot fence)](https://github.com/onestardao/WFGY/blob/main/ProblemMap/patterns/pattern_bootstrap_deadlock.md)**
 69 | 
 70 | **All patterns:** **[Patterns Index](https://github.com/onestardao/WFGY/tree/main/ProblemMap/patterns)**
 71 | 
 72 | ---
 73 | 
 74 | ## 🛠️ Playbooks & Guides
 75 | 
 76 | - **[Retrieval Playbook](https://github.com/onestardao/WFGY/blob/main/ProblemMap/retrieval-playbook.md)**
 77 | - **[Rerankers](https://github.com/onestardao/WFGY/blob/main/ProblemMap/rerankers.md)**
 78 | - **[Data Contracts](https://github.com/onestardao/WFGY/blob/main/ProblemMap/data-contracts.md)**
 79 | - **[Multilingual Guide](https://github.com/onestardao/WFGY/blob/main/ProblemMap/multilingual-guide.md)**
 80 | - **[Privacy & Governance](https://github.com/onestardao/WFGY/blob/main/ProblemMap/privacy-and-governance.md)**
 81 | 
 82 | **Examples:** **[Examples Hub](https://github.com/onestardao/WFGY/tree/main/ProblemMap/examples)**  
 83 | **Eval:** **[Evaluation Suite](https://github.com/onestardao/WFGY/tree/main/ProblemMap/eval)**  
 84 | **Ops Runbook:** **[Ops & Monitoring](https://github.com/onestardao/WFGY/tree/main/ProblemMap/ops)**  
 85 | **Beginner Guide:** **[Start Here](https://github.com/onestardao/WFGY/blob/main/ProblemMap/BeginnerGuide.md)**  
 86 | **Getting Started:** **[RAG Quickstart](https://github.com/onestardao/WFGY/blob/main/ProblemMap/getting-started.md)**
 87 | 
 88 | ---
 89 | 
 90 | ## 🗺️ Maps A–G (fast routing)
 91 | 
 92 | - **[Map-A · RAG Problem Table](https://github.com/onestardao/WFGY/blob/main/ProblemMap/RAG_Problems.md)**
 93 | - **[Map-B · Multi-Agent Chaos Map](https://github.com/onestardao/WFGY/blob/main/ProblemMap/Multi-Agent_Problems.md)**
 94 | - **[Map-C · Symbolic & Recursive Map](https://github.com/onestardao/WFGY/blob/main/ProblemMap/Symbolic_Logic_Problems.md)**
 95 | - **[Map-D · Logic Recovery Map](https://github.com/onestardao/WFGY/blob/main/ProblemMap/logic-collapse.md)**
 96 | - **[Map-E · Long-Context Stress Map](https://github.com/onestardao/WFGY/blob/main/ProblemMap/LongContext_Problems.md)**
 97 | - **[Map-F · Safety Boundary Map](https://github.com/onestardao/WFGY/blob/main/ProblemMap/Safety_Boundary_Problems.md)**
 98 | - **[Map-G · Infra Boot Map](https://github.com/onestardao/WFGY/blob/main/ProblemMap/Infra_Boot_Problems.md)**
 99 | 
100 | ---
101 | 
102 | ## 🧪 MVP Demos (runnable mini examples)
103 | 
104 | - **[Demo Readme & Entrypoints](https://github.com/onestardao/WFGY/blob/main/ProblemMap/mvp_demo/README.md)**
105 | - **[Browse All Demos](https://github.com/onestardao/WFGY/tree/main/ProblemMap/mvp_demo)**
106 | 
107 | 
108 | ---
109 | 
110 | > 👑 **Early Stargazers: Hall of Fame** — Engineers, hackers, and open-source builders who supported this project from day one.  
111 | > **[View the Hall of Fame](https://github.com/onestardao/WFGY/tree/main/stargazers)**
112 | 
113 | <div align="center">
114 | 
115 | [![WFGY Main](https://img.shields.io/badge/WFGY-Main-red?style=flat-square)](https://github.com/onestardao/WFGY)
116 | &nbsp;
117 | [![TXT OS](https://img.shields.io/badge/TXT%20OS-Reasoning%20OS-orange?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS)
118 | &nbsp;
119 | [![Blah](https://img.shields.io/badge/Blah-Semantic%20Embed-yellow?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlahBlahBlah)
120 | &nbsp;
121 | [![Blot](https://img.shields.io/badge/Blot-Persona%20Core-green?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlotBlotBlot)
122 | &nbsp;
123 | [![Bloc](https://img.shields.io/badge/Bloc-Reasoning%20Compiler-blue?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlocBlocBloc)
124 | &nbsp;
125 | [![Blur](https://img.shields.io/badge/Blur-Text2Image%20Engine-navy?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlurBlurBlur)
126 | &nbsp;
127 | [![Blow](https://img.shields.io/badge/Blow-Game%20Logic-purple?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlowBlowBlow)
128 | 
129 | </div>
130 | 


--------------------------------------------------------------------------------