WFGY (WanFaGuiYi) Problem Map

16 reproducible failure modes in AI systems — with fixes (MIT).
If this page saves you time, a ⭐ helps others find it.

Semantic memory & reasoning fix in action

Quick access

Beginner Guide: Identify & fix your first failure
Visual RAG Guide (multi-dimensional): RAG Architecture & Recovery — high-altitude view linking symptom × pipeline stage × failure class, with the exact recovery path.
Diagnose by symptom: Fast triage table → Diagnose.md
Field Reports: Real bugs & fixes from users
TXT OS directory: Browse the OS repo

Quick-Start Downloads (60 sec)

Tool	Link	3-Step Setup
WFGY 1.0 PDF	Engine Paper	1) Download 2) Upload to your LLM 3) Ask: “answer using WFGY + ”
TXT OS (plain-text OS)	TXTOS.txt	1) Download 2) Paste into any LLM chat 3) Type “hello world” to boot

Failure catalog (with fixes)

#	Problem Domain	What breaks	Doc
1	Hallucination & Chunk Drift	Retrieval returns wrong/irrelevant content	hallucination.md
2	Interpretation Collapse	Chunk is right, logic is wrong	retrieval-collapse.md
3	Long Reasoning Chains	Drifts across multi-step tasks	context-drift.md
4	Bluffing / Overconfidence	Confident but unfounded answers	bluffing.md
5	Semantic ≠ Embedding	Cosine match ≠ true meaning	embedding-vs-semantic.md
6	Logic Collapse & Recovery	Dead-end paths; needs controlled reset	logic-collapse.md
7	Memory Breaks Across Sessions	Lost threads, no continuity	memory-coherence.md
8	Debugging is a Black Box	No visibility into failure path	retrieval-traceability.md
9	Entropy Collapse	Attention melts, incoherent output	entropy-collapse.md
10	Creative Freeze	Flat, literal outputs	creative-freeze.md
11	Symbolic Collapse	Abstract/logical prompts break	symbolic-collapse.md
12	Philosophical Recursion	Self-reference/paradoxes crash reasoning	philosophical-recursion.md
13	Multi-Agent Chaos	Agents overwrite/misalign logic	multi-agent-chaos.md
14	Bootstrap Ordering	Services fire before deps ready	bootstrap-ordering.md
15	Deployment Deadlock	Circular waits (index⇆retriever, DB⇆migrator)	deployment-deadlock.md
16	Pre-Deploy Collapse	Version skew / missing secret on first call	predeploy-collapse.md

Problem families: Prompting · Retrieval · Reasoning · Infra/Deploy — locate the root cause first, then apply the specific patch.

Why these 16 errors were solvable

WFGY does not just react; it gives semantic altitude. Core tools ΔS, λ_observe, and e_resonance help detect, decode, and defuse collapse patterns from outside the maze.

See the pipeline and recovery end-to-end:
→ RAG Architecture & Recovery

Problem Maps Index (Map-A … Map-G)

These short IDs let you route quickly in issues/PRs/support threads.

Map ID	Map Name	Linked Issues	Focus	Link
Map-A	RAG Problem Table	#1, #2, #3, #5, #8	Retrieval-augmented generation failures	View
Map-B	Multi-Agent Chaos Map	#13	Coordination failures, memory conflicts	View
Map-C	Symbolic & Recursive Map	#11, #12	Symbolic logic traps, abstraction, paradox	View
Map-D	Logic Recovery Map	#6	Dead-end logic, reset loops, controlled recovery	View
Map-E	Long-Context Stress Map	#3, #7, #10	100k-token memory, noisy PDFs, long-task drift	View
Map-F	Safety Boundary Map	#4, #8	Overconfidence, jailbreak resistance, traceability	View
Map-G	Infra Boot Map	#14–#16	Ordering, boot loops, version skew, deadlocks	View

Minimal quick-start

Open Beginner Guide → follow the symptom checklist.
Use the Visual RAG Guide to locate the failing stage.
Open the matching page above and apply the patch.

Ask any LLM to apply WFGY (TXT OS makes it smoother):


I’ve uploaded TXT OS / WFGY notes.
My issue: \[e.g., OCR tables from scanned PDFs look fine but answers are wrong].
Which WFGY modules should I apply and in what order?

Status & difficulty

#	Problem	Difficulty*	Implementation
1	Hallucination & Chunk Drift	Medium	✅ Stable
2	Interpretation Collapse	High	✅ Stable
3	Long Reasoning Chains	High	✅ Stable
4	Bluffing / Overconfidence	High	✅ Stable
5	Semantic ≠ Embedding	Medium	✅ Stable
6	Logic Collapse & Recovery	Very High	✅ Stable
7	Memory Breaks Across Sessions	High	✅ Stable
8	Debugging Black Box	Medium	✅ Stable
9	Entropy Collapse	High	✅ Stable
10	Creative Freeze	Medium	✅ Stable
11	Symbolic Collapse	Very High	✅ Stable
12	Philosophical Recursion	Very High	✅ Stable
13	Multi-Agent Chaos	Very High	✅ Stable
14	Bootstrap Ordering	Medium	✅ Stable
15	Deployment Deadlock	High	⚠️ Beta
16	Pre-Deploy Collapse	Medium-High	✅ Stable

*Distance from default LLM behavior to a production-ready fix.

Contributing / support

Open an Issue with a minimal repro (inputs → calls → wrong output).
PRs for clearer docs, repros, or patches are welcome.
WFGY Project home: github.com/onestardao/WFGY
TXT OS: github.com/onestardao/WFGY/tree/main/OS
If this map helped you, a ⭐ helps more devs find it.

🧭 Explore More

Module	Description	Link
Semantic Blueprint	Layer-based symbolic reasoning & semantic modulations	View →
Benchmark vs GPT-5	Stress test GPT-5 with full WFGY reasoning suite	View →
Semantic Clinic Index	Expanded failure catalog: prompt injection, memory bugs, logic drift	View →

👑 Early Stargazers: See the Hall of Fame —
Engineers, hackers, and open source builders who supported WFGY from day one.

⭐ Help reach 10,000 stars by 2025-09-01 to unlock Engine 2.0 for everyone ⭐ Star WFGY on GitHub

10 KiB Raw Blame History Unescape Escape