21 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 |
| 🗺️ Map | Semantic Clinic | Symptom → family → exact fix — 🔴 YOU ARE HERE 🔴 |
| 🧓 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 |
🏥 Semantic Clinic Index — Your ER Triage Desk for Broken Pipelines
🌙 3AM: a dev collapsed mid-debug… 🩺 WFGY Triage Center — Emergency Room & Grandma’s AI Clinic
🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥
🚑 WFGY Emergency Room (for developers)
👨⚕️ Now online:
Dr. WFGY in ChatGPT Room
This is a share window already trained as an ER.
Just open it, drop your bug or screenshot, and talk directly with the doctor.
He will map it to the right Problem Map / Global Fix section, write a minimal prescription, and paste the exact reference link.
If something is unclear, you can even paste a screenshot of Problem Map content and ask — the doctor will guide you.
⚠️ Note: for the full reasoning and guardrail behavior you need to be logged in — the share view alone may fallback to a lighter model.
💡 Always free. If it helps, a ⭐ star keeps the ER running.
🌐 Multilingual — start in any language.
👵 Grandma’s AI Clinic (for everyone)
- 16 common AI failure modes, each explained as a grandma story.
- Everyday metaphors: wrong cookbook, salt-for-sugar, burnt first pot.
- Shows both the life analogy and the minimal WFGY fix.
- Perfect entry point for beginners, or anyone who wants to “get it” in 30 seconds.
💡 Tip: Both tracks lead to the same Problem Map numbers.
Choose Emergency Room if you need a fix right now.
Choose Grandma’s Clinic if you want to understand the bug in plain words.
🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥
A complete triage hub for AI failures — beyond the core 16 — powered by WFGY.
Use this page when you don’t yet know which thing is breaking. Start from symptoms, jump to a failure family, then open the exact fix page. All fixes are driven by WFGY instruments: ΔS (semantic stress), λ_observe (layered observability), and E_resonance (coherence control).
If this page saves you time, a ⭐ helps others find it.
Quick Nav
Getting Started · RAG Problem Map 2.0 · Patterns Index · Examples · Eval · Ops · Multi-Agent Problems · Retrieval Playbook · Rerankers · Data Contracts · Multilingual Guide · Privacy & Governance · FAQ · Glossary
How to use this page
- Identify the symptom in the table below.
- Open the family (Prompting / Retrieval / Reasoning / Memory / Agents / Infra / Eval).
- Follow the fix page, then verify with ΔS ≤ 0.45 and convergent λ.
Prefer a pipeline-first view (OCR → chunk → embed → store → retrieve → prompt → LLM)?
Read RAG Architecture & Recovery.
Want the full catalog instead? See Problem Map Index.
🧩 Or, jump straight to MVP Demos: Run minimal WFGY examples →
Quick triage by symptom
| Symptom you see | Likely family | Open this |
|---|---|---|
| Answers cite wrong snippet / mismatch with ground truth | Retrieval → RAG | hallucination.md |
| Chunks look right but reasoning is wrong | Reasoning | retrieval-collapse.md |
| High similarity, wrong meaning | Retrieval / Embeddings | embedding-vs-semantic.md |
| Model can’t explain why (no trace) | Observability | retrieval-traceability.md |
| Output degrades over 100k-token dialogs | Memory / Long-context | entropy-collapse.md · context-drift.md |
| OCR PDFs look correct yet answers drift | Data / OCR | ocr-parsing-checklist.md |
| Hybrid (HyDE + BM25) gets worse than single retriever | Retrieval / Querying | patterns/pattern_query_parsing_split.md |
| High recall but top-k ordering is messy | Retrieval / Reranking | rerankers.md · retrieval-playbook.md |
| Corrections don’t stick; model re-asserts old claim | Reasoning / Prompting | patterns/pattern_hallucination_reentry.md |
| “Who said what” merges across sources | Prompting / Constraints | patterns/pattern_symbolic_constraint_unlock.md |
| Some facts can’t be retrieved though indexed | Retrieval / Index | patterns/pattern_vectorstore_fragmentation.md |
| Answers flip between sessions / tabs | Memory / State | patterns/pattern_memory_desync.md |
| Need a standard schema for snippets/citations | Prompting / Traceability | data-contracts.md |
| Non-English corpus drifts / tokenizer mismatch | Language / Locale | multilingual-guide.md |
| PII/compliance concerns with traces/logs | Governance | privacy-and-governance.md |
| Multi-agent tools fight each other | Agents | Multi-Agent_Problems.md |
| First prod call crashes after deploy | Infra / Boot | predeploy-collapse.md |
| Tools fire before data is ready (RAG boot fence) | Infra / Boot | patterns/pattern_bootstrap_deadlock.md |
Still lost? Open the Beginner Guide symptom checklist first.
Families & maps (with exact fixes)
A) Prompting & Safety
Guard against injections, role drift, and schema leakage.
- Citation-first, schema-locked prompting —
retrieval-traceability.md - Overconfidence / Bluffing Controls —
bluffing.md - Symbolic Constraint Unlock (SCU) / source mixing —
patterns/pattern_symbolic_constraint_unlock.md - Snippet & citation schemas —
data-contracts.md
Verification: ΔS(question, context) ≤ 0.45; λ remains convergent across paraphrases; constraint probes do not flip λ.
B) Retrieval, Data & Vector Stores
Make the index correct, measured, and explainable.
- Hallucination & Chunk Drift —
hallucination.md - Interpretation vs Retrieval Collapse —
retrieval-collapse.md - Embedding ≠ Semantic Meaning —
embedding-vs-semantic.md - Traceability (why this snippet?) —
retrieval-traceability.md - Rerankers (ordering control) —
rerankers.md - Retrieval Playbook (end-to-end knobs) —
retrieval-playbook.md - Vectorstore Fragmentation —
patterns/pattern_vectorstore_fragmentation.md - Query Parsing Split (HyDE/BM25) —
patterns/pattern_query_parsing_split.md - Semantic Chunking Checklist —
chunking-checklist.md - OCR / Parsing Quality Gate —
ocr-parsing-checklist.md
Verification: coverage ≥ 0.70 to target section; ΔS(question, retrieved) ≤ 0.45; flat-high ΔS vs k ⇒ index/metric mismatch.
C) Reasoning & Logic Control
Detect and repair logic collapse, dead ends, and abstraction failures.
- Logic Collapse & Recovery —
logic-collapse.md - Long Reasoning Chains —
context-drift.md - Symbolic Collapse —
symbolic-collapse.md - Philosophical Recursion —
philosophical-recursion.md - Hallucination Re-entry —
patterns/pattern_hallucination_reentry.md
Verification: fix point when λ stays convergent after BBCR (bridge) + BBAM (variance clamp).
D) Memory & Long-Context
Keep threads coherent across sessions and very long windows.
- Memory Breaks Across Sessions —
memory-coherence.md - Entropy Collapse —
entropy-collapse.md - Memory Desync —
patterns/pattern_memory_desync.md
Verification: E_resonance flat; ΔS stable at window joins.
E) Multi-Agent & Orchestration
Coordinate tools, roles, and shared memory without conflict.
- Multi-Agent Chaos (overview map) —
Multi-Agent_Problems.md - Role Drift (Deep Dive) —
multi-agent-chaos/role-drift.md - Cross-Agent Memory Overwrite (Deep Dive) —
multi-agent-chaos/memory-overwrite.md
Verification: when agents couple, ΔS does not spike; arbitration logs traceable.
F) Infra / Deploy
Boot in a known-good order, every time.
- Bootstrap Ordering —
bootstrap-ordering.md - Deployment Deadlock —
deployment-deadlock.md - Pre-Deploy Collapse —
predeploy-collapse.md - Live Monitoring & Debug Playbook —
ops/live_monitoring_rag.md·ops/debug_playbook.md - Privacy & Governance —
privacy-and-governance.md
Verification: deterministic warm-up; idempotent index builds; version/secret checks pass.
G) Evaluation & Guardrails
Detect “double hallucination” and prevent regression.
- RAG Precision/Recall —
eval/eval_rag_precision_recall.md - Latency vs Accuracy —
eval/eval_latency_vs_accuracy.md - Cross-Agent Consistency —
eval/eval_cross_agent_consistency.md - Semantic Stability —
eval/eval_semantic_stability.md
Acceptance: retrieve QA coverage ≥ 0.70 and ΔS ≤ 0.45; λ convergent; repeatability across seeds.
Ask the AI to fix your AI (safe prompt)
Read the WFGY TXT OS and Problem Map docs. Extract ΔS, λ_observe, E_resonance and the modules (BBMC, BBPF, BBCR, BBAM).
Given my failure:
- symptom: [describe]
- traces: [ΔS probes, λ states if any]
Tell me:
1) which layer/family is failing and why,
2) which fix page to open,
3) minimal steps to push ΔS ≤ 0.45 and keep λ convergent,
4) how to verify the fix.
🔗 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 + <your question>” |
| TXT OS (plain-text OS) | TXTOS.txt | 1️⃣ Download · 2️⃣ Paste into any LLM chat · 3️⃣ Type “hello world” — OS boots instantly |
Explore More
| 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 |
| 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 |
| Map | Semantic Clinic | Symptom to family to exact fix |
| Map | Grandma’s Clinic | Plain language stories mapped to Problem Map 1.0 |
| Onboarding | Starter Village | Guided tour for newcomers |
| App | TXT OS | TXT semantic OS, fast boot |
| App | Blah Blah Blah | Abstract and paradox Q and A built on TXT OS |
| App | Blur Blur Blur | Text to image with semantic control |
| App | Blow Blow Blow | Reasoning game engine and memory demo |
If this repository helped, starring it improves discovery so more builders can find the docs and tools.
