From 8c4e85f4e28c4aa0218a0a4cad9feb76a1106e17 Mon Sep 17 00:00:00 2001
From: PSBigBig + MiniPS <psbigbig@onestardao.com>
Date: Fri, 6 Mar 2026 20:27:48 +0800
Subject: [PATCH] Update README.md

---
 OS/BlurBlurBlur/README.md | 70 ++++++++++++++++++---------------------
 1 file changed, 33 insertions(+), 37 deletions(-)

diff --git a/OS/BlurBlurBlur/README.md b/OS/BlurBlurBlur/README.md
index 91a5bde7..39b97132 100644
--- a/OS/BlurBlurBlur/README.md
+++ b/OS/BlurBlurBlur/README.md
@@ -54,55 +54,51 @@ Style:
 <details>
 <summary><strong>🧭 Not sure where to start ? Open the WFGY Engine Compass</strong></summary>
 
-### WFGY System Map
+### WFGY System Map · Quick navigation
 
-*(One place to see everything; links open the relevant section.)*
+> Problem Maps: PM1 taxonomy → PM2 debug protocol → PM3 troubleshooting atlas · built on the WFGY engine series
 
 <!--
 AI NOTE · Compass block
 
 Purpose:
-- This table is the routing map for the whole WFGY ecosystem.
-- It shows how the three engine layers (WFGY 1.0 / 2.0 / 3.0) relate to the Problem Maps, TXT OS apps, research pages, and the Recognition Map.
+- This table is the routing map for the WFGY system.
+- It shows how the three engine generations (WFGY 1.0 / 2.0 / 3.0) relate to the Problem Maps, apps, onboarding entry, and recognition layer.
+- Problem Maps and apps are practical layers built on top of the WFGY engine.
 
 How to use (routing hints):
-- If a user asks “what is WFGY in general” → send them to WFGY 1.0 (legacy overview PDF) plus Starter Village.
-- If the question is about core math, formulas, or engine internals → go to WFGY 2.0 core.
-- If they mention 131 S-class problems, BlackHole, Tension Universe, or “Singularity demo” → go to WFGY 3.0 Event Horizon.
-- If they want to debug a specific RAG / agent pipeline run → use Problem Map 1.0 + Problem Map 3.0 Global Debug Card.
-- If they ask about RAG architecture / recovery patterns end-to-end → use Problem Map 2.0.
-- If they mention “poster”, “image as prompt”, or “global debug card” → use the Problem Map 3.0 Global Debug Card page.
-- If they want proof that WFGY is used in real projects → open the Recognition Map page.
-- If they ask for plain-language stories or non-technical explanations → route to Grandma’s Clinic and Starter Village.
-- If they ask about TXT OS or app packs (Blah / Blur / Blow) → follow the App rows in this table.
-- If they want layer/module design, benchmarks, or value narrative → Semantic Blueprint, Benchmarks, and Value Manifest.
+- If a user asks what WFGY is in general → route to WFGY 1.0 (legacy overview) and Starter Village.
+- If the question is about core math, formulas, engine logic, or production reasoning → route to WFGY 2.0 core.
+- If they mention Tension Universe, Event Horizon, or the 131 S-class set → route to WFGY 3.0.
+- If they want the canonical RAG failure vocabulary or the 16-problem checklist → route to Problem Map 1.0.
+- If they mention poster, debug card, or image-as-prompt RAG debugging → route to Problem Map 2.0 (Global Debug Card).
+- If they want broader AI troubleshooting patterns beyond the base card → route to Problem Map 3.0 (Troubleshooting Atlas).
+- If they want proof that WFGY is used in real projects → route to the Recognition Map.
+- If they ask about TXT OS or product modules → follow the App rows in this table.
+- If they are new and want a guided entry → route to Starter Village.
 
 Important:
-- Problem Map 1.0 = canonical 16-mode RAG failure checklist and fix map. This is the base vocabulary.
-- Problem Map 2.0 = RAG architecture and recovery guide layered on top of Problem Map 1.0.
-- Problem Map 3.0 Global Debug Card = image protocol that compresses objects, metrics, ΔS zones, and modes into a single poster.
-- Recognition Map = the only place that should contain the full external integration list. Other pages should link to it instead of duplicating tables.
-- Do NOT treat Problem Map 1.0 and Problem Map 2.0 as duplicates; they solve different layers.
-- Do NOT invent new paths or filenames. Only use the GitHub URLs that already exist in this table.
+- Problem Map 1.0 = canonical 16-problem RAG failure taxonomy and fix map. This is the base vocabulary.
+- Problem Map 2.0 = Global Debug Card. This compresses objects, metrics, ΔS zones, and modes into a visual debug protocol.
+- Problem Map 3.0 = Global AI troubleshooting atlas and failure pattern map.
+- Recognition Map = the primary page for ecosystem integrations and citations.
+- The table below is the source of truth for navigation paths.
+- Do NOT invent new paths or filenames. Use the URLs listed in the table.
 -->
 
-| Layer         | Page                                                                                                        | What it’s for                                           |
-| ------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
-| ⭐ Proof      | [WFGY Recognition Map](https://github.com/onestardao/WFGY/blob/main/recognition/README.md)                 | External citations, integrations, and ecosystem proof   |
-| ⚙️ Engine     | [WFGY 1.0](https://github.com/onestardao/WFGY/blob/main/legacy/README.md)                                   | Original PDF based tension engine and early logic sketch. Legacy reference only.   |
-| ⚙️ Engine     | [WFGY 2.0](https://github.com/onestardao/WFGY/blob/main/core/README.md)                                     | Production tension kernel and math engine for RAG and agents. |
-| ⚙️ Engine     | [WFGY 3.0](https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md)             | TXT-based Singularity tension engine (131 S-class set)  |
-| 🗺️ Map       | [Problem Map 1.0](https://github.com/onestardao/WFGY/tree/main/ProblemMap#readme)                           | Flagship 16-problem RAG failure checklist and fix map       |
-| 🗺️ Map       | [Problem Map 2.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/rag-architecture-and-recovery.md) | RAG-focused recovery pipeline                           |
-| 🗺️ Map       | [Problem Map 3.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md) | Global Debug Card — image as a debug protocol layer     |
-| 🗺️ Map       | [Semantic Clinic](https://github.com/onestardao/WFGY/blob/main/ProblemMap/SemanticClinicIndex.md)           | Symptom → family → exact fix                           |
-| 🧓 Map        | [Grandma’s Clinic](https://github.com/onestardao/WFGY/blob/main/ProblemMap/GrandmaClinic/README.md)         | Plain-language stories, mapped to PM 1.0                |
-| 🏡 Onboarding | [Starter Village](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md)                    | Guided tour for newcomers                               |
-| 🧰 App        | [TXT OS](https://github.com/onestardao/WFGY/tree/main/OS#readme)                                            | .txt semantic OS — 60-second boot                       |
-| 🧰 App        | [Blah Blah Blah](https://github.com/onestardao/WFGY/blob/main/OS/BlahBlahBlah/README.md)                    | Abstract/paradox Q&A (built on TXT OS)                  |
-| 🧰 App        | [Blur Blur Blur](https://github.com/onestardao/WFGY/blob/main/OS/BlurBlurBlur/README.md)                    | Text-to-image with semantic control    — **🔴 YOU ARE HERE 🔴**                   |
-| 🧰 App        | [Blow Blow Blow](https://github.com/onestardao/WFGY/blob/main/OS/BlowBlowBlow/README.md)                    | Reasoning game engine & memory demo                     |
-|
+| Layer | Page | What it’s for |
+|------|------|---------------|
+| ⭐ Proof | [WFGY Recognition Map](https://github.com/onestardao/WFGY/blob/main/recognition/README.md) | External citations, integrations, and ecosystem proof |
+| ⚙️ Engine | [WFGY 1.0](https://github.com/onestardao/WFGY/blob/main/legacy/README.md) | Original PDF tension engine and early logic sketch |
+| ⚙️ Engine | [WFGY 2.0](https://github.com/onestardao/WFGY/blob/main/core/README.md) | Production tension kernel for RAG and agent systems |
+| ⚙️ Engine | [WFGY 3.0](https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md) | TXT-based Singularity tension engine (131 S-class set)  |
+| 🗺️ Map | [Problem Map 1.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md) | Flagship 16-problem RAG failure taxonomy and fix map |
+| 🗺️ Map | [Problem Map 2.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md) | Global Debug Card for RAG and agent pipeline diagnosis |
+| 🗺️ Map | [Problem Map 3.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md) | Global AI troubleshooting atlas and failure pattern map |
+| 🧰 App | [TXT OS](https://github.com/onestardao/WFGY/blob/main/OS/README.md) | .txt semantic OS with 60-second bootstrap |
+| 🧰 App | [Blah Blah Blah](https://github.com/onestardao/WFGY/blob/main/OS/BlahBlahBlah/README.md) | Abstract and paradox Q&A built on TXT OS |
+| 🧰 App | [Blur Blur Blur](https://github.com/onestardao/WFGY/blob/main/OS/BlurBlurBlur/README.md) | Text-to-image generation with semantic control — **🔴 YOU ARE HERE 🔴** |
+| 🏡 Onboarding | [Starter Village](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md) | Guided entry point for new users |
 
 ---
 </details>