From a3afd526dca808bd5bbaf8bdaaf732936d9565a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?PSBigBig=20=C3=97=20MiniPS?= <psbigbig@onestardao.com>
Date: Sun, 1 Mar 2026 12:37:55 +0800
Subject: [PATCH] Update README.md

---
 recognition/README.md | 58 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/recognition/README.md b/recognition/README.md
index e07fc6e8..1cfa2558 100644
--- a/recognition/README.md
+++ b/recognition/README.md
@@ -1,3 +1,61 @@
+<details>
+<summary><strong>🧭 Not sure where to start ? Open the WFGY Engine Compass</strong></summary>
+
+### WFGY System Map
+
+*(One place to see everything; links open the relevant section.)*
+
+<!--
+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.
+
+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.
+
+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.
+-->
+
+| 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  — **🔴 YOU ARE HERE 🔴** |
+| ⚙️ Engine     | [WFGY 1.0](https://github.com/onestardao/WFGY/blob/main/legacy/README.md)                                   | Original PDF-based tension engine blue   |
+| ⚙️ 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                     |
+| 🧰 App        | [Blow Blow Blow](https://github.com/onestardao/WFGY/blob/main/OS/BlowBlowBlow/README.md)                    | Reasoning game engine & memory demo                     |
+| 🧪 Research   | [Semantic Blueprint](https://github.com/onestardao/WFGY/blob/main/SemanticBlueprint/README.md)              | Modular layer structures (future)                       |
+| 🧪 Research   | [Benchmarks](https://github.com/onestardao/WFGY/blob/main/benchmarks/benchmark-vs-gpt5/README.md)           | Comparisons & how to reproduce                          |
+| 🧪 Research   | [Value Manifest](https://github.com/onestardao/WFGY/blob/main/value_manifest/README.md)                     | Why this engine creates $-scale value                   |
+
+---
+</details>
+
 ## 🌐 WFGY Recognition Map · RAG & Agent Ecosystem
 
 A verified record of public citations and integrations of WFGY ProblemMap across the RAG and agent ecosystem.