diff --git a/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md b/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md
index 65aa9ade..94a7df21 100644
--- a/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md
+++ b/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md
@@ -32,6 +32,58 @@ Reading discipline for AI:
 AI_NOTE_END
 -->
 
+<details>
+<summary><strong>🧭 Not sure where to start ? Open the WFGY Engine Compass</strong></summary>
+
+### WFGY System Map · Quick navigation
+
+> 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 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 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-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  — **🔴 YOU ARE HERE 🔴** |
+| ⚙️ 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 |
+| 🏡 Onboarding | [Starter Village](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md) | Guided entry point for new users |
+
+---
+</details>
+
 # Problem Map 3.0 Troubleshooting Atlas 🗺
 ## A failure router for vibe coders and engineers building with AI. 🧭