diff --git a/ProblemMap/GrandmaClinic/README.md b/ProblemMap/GrandmaClinic/README.md index a70d4a7d..5ebd8697 100644 --- a/ProblemMap/GrandmaClinic/README.md +++ b/ProblemMap/GrandmaClinic/README.md @@ -27,28 +27,38 @@ No.16 [Pre-deploy Collapse](https://github.com/onestardao/WFGY/blob/main/Problem --- -## Quick Index Table (πŸ‘΅Grandma + Class) -> click a row to jump. each item shows a beginner-friendly class and the grandma tag. +## πŸ”Ž Quick Index β€” πŸ‘΅ Grandma + Class (aligned with Problem Map 1.0 categories) + +> These are the 16 common failures, each with its **Problem Map 1.0 class** on the left and a **Grandma metaphor** on the right. +> Pick by Class if you know the tech stack, pick by Grandma if you just want to feel the bug. + +| No. | Problem (jump) | Class (from Problem Map 1.0) | Grandma tag | Emoji | +|----:|-----------------|-----------------------------|-------------|:----:| +| 1 | [No.1 Hallucination & Chunk Drift](#no01) | Finding info (Retrieval) | **Wrong Cookbook** | πŸ“–πŸ½οΈ | +| 2 | [No.2 Interpretation Collapse](#no02) | Misreading (Reasoning) | **Salt for Sugar** | πŸ§‚πŸ¬ | +| 3 | [No.3 Long Reasoning Chains](#no03) | Losing the goal (Planning) | **Lost Shopping Trip** | πŸ›’πŸ§Ύ | +| 4 | [No.4 Bluffing / Overconfidence](#no04) | Ungrounded output | **No Recipe Card** | 🍽️❌ | +| 5 | [No.5 Semantic β‰  Embedding](#no05) | Embedding mismatch | **Pepper Confusion** | πŸŒΆοΈβš–οΈ | +| 6 | [No.6 Logic Collapse & Recovery](#no06) | Looping / stuck logic | **Dead-End Alley** | πŸš§β†©οΈ | +| 7 | [No.7 Memory Breaks Across Sessions](#no07) | Forgetting state | **Wrong Drawer Memory** | πŸ—„οΈπŸ“ | +| 8 | [No.8 Debugging is a Black Box](#no08) | No traceability | **Blank Card** | πŸƒπŸ”Ž | +| 9 | [No.9 Entropy Collapse](#no09) | Too much noise | **One-Pot Gray Stew** | 🍲🌫️ | +| 10 | [No.10 Creative Freeze](#no10) | No exploration | **Bland Soup** | πŸ₯£πŸ§Š | +| 11 | [No.11 Symbolic Collapse](#no11) | Symbols/tables break | **Ignore Fractions** | βž—πŸ“ | +| 12 | [No.12 Philosophical Recursion](#no12) | Infinite loop | **Infinite Why Loop** | πŸ”β“ | +| 13 | [No.13 Multi-Agent Chaos](#no13) | Role & memory clash | **Kitchen Tug-of-War** | πŸ‘©β€πŸ³πŸ‘¨β€πŸ³ | +| 14 | [No.14 Bootstrap Ordering](#no14) | Wrong boot order | **Cold Pan Egg** | 🍳🧯 | +| 15 | [No.15 Deployment Deadlock](#no15) | Resource lock | **You-First Doorway** | πŸšͺ⏳ | +| 16 | [No.16 Pre-deploy Collapse](#no16) | Preflight failure | **Burnt First Pot** | 🍯πŸ”₯ | + +--- + +> tip: +> β€’ **Class** β†’ matches the professional Problem Map 1.0 categories you saw in the main table. +> β€’ **Grandma tag** β†’ a metaphor to make the bug intuitive. +> β€’ use either column to jump to the fix section below. -| No. | Problem (jump) | Class | Grandma tag | Emoji | -|----:|-----------------|-------|-------------|:----:| -| 1 | [No.1 Hallucination & Chunk Drift](#no01) | Retrieval alignment | Wrong Cookbook | πŸ“–πŸ½οΈ | -| 2 | [No.2 Interpretation Collapse](#no02) | Reasoning interpretation | Salt for Sugar | πŸ§‚πŸ¬ | -| 3 | [No.3 Long Reasoning Chains](#no03) | Planning control | Lost Shopping Trip | πŸ›’πŸ§Ύ | -| 4 | [No.4 Bluffing / Overconfidence](#no04) | Grounding check | No Recipe Card | 🍽️❌ | -| 5 | [No.5 Semantic β‰  Embedding](#no05) | Embedding audit | Pepper Confusion | πŸŒΆοΈβš–οΈ | -| 6 | [No.6 Logic Collapse & Recovery](#no06) | Recovery loop | Dead-End Alley | πŸš§β†©οΈ | -| 7 | [No.7 Memory Breaks Across Sessions](#no07) | Session memory | Wrong Drawer Memory | πŸ—„οΈπŸ“ | -| 8 | [No.8 Debugging is a Black Box](#no08) | Traceability | Blank Card | πŸƒπŸ”Ž | -| 9 | [No.9 Entropy Collapse](#no09) | Entropy control | One-Pot Gray Stew | 🍲🌫️ | -| 10 | [No.10 Creative Freeze](#no10) | Safe exploration | Bland Soup | πŸ₯£πŸ§Š | -| 11 | [No.11 Symbolic Collapse](#no11) | Symbol channel | Ignore Fractions | βž—πŸ“ | -| 12 | [No.12 Philosophical Recursion](#no12) | Recursion boundary | Infinite Why Loop | πŸ”β“ | -| 13 | [No.13 Multi-Agent Chaos](#no13) | Role and memory fences | Kitchen Tug-of-War | πŸ‘©β€πŸ³πŸ‘¨β€πŸ³ | -| 14 | [No.14 Bootstrap Ordering](#no14) | Boot order | Cold Pan Egg | 🍳🧯 | -| 15 | [No.15 Deployment Deadlock](#no15) | Lock and timeout | You-First Doorway | πŸšͺ⏳ | -| 16 | [No.16 Pre-deploy Collapse](#no16) | Preflight checks | Burnt First Pot | 🍯πŸ”₯ |