Update SemanticClinicIndex.md

2026-04-28 11:40:07 +00:00 · 2025-08-14 22:40:36 +08:00 · 2025-08-14 22:40:36 +08:00 · b3a2a63e68
commit b3a2a63e68
parent 40b5e84c97
1 changed files with 36 additions and 23 deletions
--- a/ProblemMap/SemanticClinicIndex.md
+++ b/ProblemMap/SemanticClinicIndex.md
@ -18,7 +18,14 @@ Use this page when you don’t yet know *which thing is breaking*. Start from sy
 [Examples](./examples/README.md) ·
 [Eval](./eval/README.md) ·
 [Ops](./ops/README.md) ·
-[Multi-Agent Problems](./Multi-Agent_Problems.md)
+[Multi-Agent Problems](./Multi-Agent_Problems.md) ·
+**[Retrieval Playbook](./retrieval-playbook.md)** ·
+**[Rerankers](./rerankers.md)** ·
+**[Data Contracts](./data-contracts.md)** ·
+**[Multilingual Guide](./multilingual-guide.md)** ·
+**[Privacy & Governance](./privacy-and-governance.md)** ·
+**[FAQ](./faq.md)** ·
+**[Glossary](./glossary.md)**

 ---

@ -33,7 +40,6 @@ Read **[`RAG Architecture & Recovery`](./rag-architecture-and-recovery.md)**.
 Want the full catalog instead? See **[Problem Map Index](./README.md)**.  
 🧩 Or, **jump straight to MVP Demos**: [Run minimal WFGY examples →](./mvp_demo/README.md)

-
 ---

 ## Quick triage by symptom
@ -47,10 +53,14 @@ Want the full catalog instead? See **[Problem Map Index](./README.md)**.
 | Output degrades over 100k-token dialogs | Memory / Long-context | [`entropy-collapse.md`](./entropy-collapse.md) · [`context-drift.md`](./context-drift.md) |
 | OCR PDFs **look** correct yet answers drift | Data / OCR | [`ocr-parsing-checklist.md`](./ocr-parsing-checklist.md) |
 | Hybrid (HyDE + BM25) gets worse than single retriever | Retrieval / Querying | [`patterns/pattern_query_parsing_split.md`](./patterns/pattern_query_parsing_split.md) |
+| **High recall but top-k ordering is messy** | Retrieval / Reranking | [`rerankers.md`](./rerankers.md) · [`retrieval-playbook.md`](./retrieval-playbook.md) |
 | Corrections don’t stick; model re-asserts old claim | Reasoning / Prompting | [`patterns/pattern_hallucination_reentry.md`](./patterns/pattern_hallucination_reentry.md) |
 | “Who said what” merges across sources | Prompting / Constraints | [`patterns/pattern_symbolic_constraint_unlock.md`](./patterns/pattern_symbolic_constraint_unlock.md) |
 | Some facts can’t be retrieved though indexed | Retrieval / Index | [`patterns/pattern_vectorstore_fragmentation.md`](./patterns/pattern_vectorstore_fragmentation.md) |
 | Answers flip between sessions / tabs | Memory / State | [`patterns/pattern_memory_desync.md`](./patterns/pattern_memory_desync.md) |
+| **Need a standard schema for snippets/citations** | Prompting / Traceability | [`data-contracts.md`](./data-contracts.md) |
+| **Non-English corpus drifts / tokenizer mismatch** | Language / Locale | [`multilingual-guide.md`](./multilingual-guide.md) |
+| **PII/compliance concerns with traces/logs** | Governance | [`privacy-and-governance.md`](./privacy-and-governance.md) |
 | Multi-agent tools fight each other | Agents | [`Multi-Agent_Problems.md`](./Multi-Agent_Problems.md) |
 | First prod call crashes after deploy | Infra / Boot | [`predeploy-collapse.md`](./predeploy-collapse.md) |
 | Tools fire before data is ready (RAG boot fence) | Infra / Boot | [`patterns/pattern_bootstrap_deadlock.md`](./patterns/pattern_bootstrap_deadlock.md) |
@ -66,7 +76,8 @@ Guard against injections, role drift, and schema leakage.

 - **Citation-first, schema-locked prompting** — [`retrieval-traceability.md`](./retrieval-traceability.md)  
 - **Overconfidence / Bluffing Controls** — [`bluffing.md`](./bluffing.md)  
- **Symbolic Constraint Unlock (SCU) / source mixing** — [`patterns/pattern_symbolic_constraint_unlock.md`](./patterns/pattern_symbolic_constraint_unlock.md)
+- **Symbolic Constraint Unlock (SCU) / source mixing** — [`patterns/pattern_symbolic_constraint_unlock.md`](./patterns/pattern_symbolic_constraint_unlock.md)  
+- **Snippet & citation schemas** — [`data-contracts.md`](./data-contracts.md)

 **Verification**: ΔS(question, context) ≤ 0.45; λ remains convergent across paraphrases; constraint probes do not flip λ.

@ -79,6 +90,8 @@ Make the index correct, measured, and explainable.
 - **Interpretation vs Retrieval Collapse** — [`retrieval-collapse.md`](./retrieval-collapse.md)  
 - **Embedding ≠ Semantic Meaning** — [`embedding-vs-semantic.md`](./embedding-vs-semantic.md)  
 - **Traceability (why this snippet?)** — [`retrieval-traceability.md`](./retrieval-traceability.md)  
+- **Rerankers (ordering control)** — [`rerankers.md`](./rerankers.md)  
+- **Retrieval Playbook (end-to-end knobs)** — [`retrieval-playbook.md`](./retrieval-playbook.md)  
 - **Vectorstore Fragmentation** — [`patterns/pattern_vectorstore_fragmentation.md`](./patterns/pattern_vectorstore_fragmentation.md)  
 - **Query Parsing Split (HyDE/BM25)** — [`patterns/pattern_query_parsing_split.md`](./patterns/pattern_query_parsing_split.md)  
 - **Semantic Chunking Checklist** — [`chunking-checklist.md`](./chunking-checklist.md)  
@ -129,7 +142,8 @@ Boot in a known-good order, every time.
 - **Bootstrap Ordering** — [`bootstrap-ordering.md`](./bootstrap-ordering.md)  
 - **Deployment Deadlock** — [`deployment-deadlock.md`](./deployment-deadlock.md)  
 - **Pre-Deploy Collapse** — [`predeploy-collapse.md`](./predeploy-collapse.md)  
- **Live Monitoring & Debug Playbook** — [`ops/live_monitoring_rag.md`](./ops/live_monitoring_rag.md) · [`ops/debug_playbook.md`](./ops/debug_playbook.md)
+- **Live Monitoring & Debug Playbook** — [`ops/live_monitoring_rag.md`](./ops/live_monitoring_rag.md) · [`ops/debug_playbook.md`](./ops/debug_playbook.md)  
+- **Privacy & Governance** — [`privacy-and-governance.md`](./privacy-and-governance.md)

 **Verification**: deterministic warm-up; idempotent index builds; version/secret checks pass.

@ -165,22 +179,21 @@ Tell me:

 ---

-
 ### 🧭 Explore More

-| Module                | Description                                              | Link     |
-|-----------------------|----------------------------------------------------------|----------|
-| WFGY Core             | WFGY 2.0 engine is live: full symbolic reasoning architecture and math stack | [View →](https://github.com/onestardao/WFGY/tree/main/core/README.md) |
-| Problem Map 1.0       | Initial 16-mode diagnostic and symbolic fix framework    | [View →](https://github.com/onestardao/WFGY/tree/main/ProblemMap/README.md) |
-| Problem Map 2.0       | RAG-focused failure tree, modular fixes, and pipelines   | [View →](https://github.com/onestardao/WFGY/blob/main/ProblemMap/rag-architecture-and-recovery.md) |
-| Semantic Clinic Index | Expanded failure catalog: prompt injection, memory bugs, logic drift | [View →](https://github.com/onestardao/WFGY/blob/main/ProblemMap/SemanticClinicIndex.md) |
-| Semantic Blueprint    | Layer-based symbolic reasoning & semantic modulations   | [View →](https://github.com/onestardao/WFGY/tree/main/SemanticBlueprint/README.md) |
-| Benchmark vs GPT-5    | Stress test GPT-5 with full WFGY reasoning suite         | [View →](https://github.com/onestardao/WFGY/tree/main/benchmarks/benchmark-vs-gpt5/README.md) |
-| 🧙‍♂️ Starter Village 🏡 | New here? Lost in symbols? Click here and let the wizard guide you through | [Start →](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md) |
+| Module                   | Description                                                                  | Link                                                                                               |
+| ------------------------ | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| WFGY Core                | WFGY 2.0 engine is live: full symbolic reasoning architecture and math stack | [View →](https://github.com/onestardao/WFGY/tree/main/core/README.md)                              |
+| Problem Map 1.0          | Initial 16-mode diagnostic and symbolic fix framework                        | [View →](https://github.com/onestardao/WFGY/tree/main/ProblemMap/README.md)                        |
+| Problem Map 2.0          | RAG-focused failure tree, modular fixes, and pipelines                       | [View →](https://github.com/onestardao/WFGY/blob/main/ProblemMap/rag-architecture-and-recovery.md) |
+| Semantic Clinic Index    | Expanded failure catalog: prompt injection, memory bugs, logic drift         | [View →](https://github.com/onestardao/WFGY/blob/main/ProblemMap/SemanticClinicIndex.md)           |
+| Semantic Blueprint       | Layer-based symbolic reasoning & semantic modulations                        | [View →](https://github.com/onestardao/WFGY/tree/main/SemanticBlueprint/README.md)                 |
+| Benchmark vs GPT-5       | Stress test GPT-5 with full WFGY reasoning suite                             | [View →](https://github.com/onestardao/WFGY/tree/main/benchmarks/benchmark-vs-gpt5/README.md)      |
+| 🧙‍♂️ Starter Village 🏡 | New here? Lost in symbols? Click here and let the wizard guide you through   | [Start →](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md)                   |

 ---

-> 👑 **Early Stargazers: [See the Hall of Fame](https://github.com/onestardao/WFGY/tree/main/stargazers)** —  
+> 👑 **Early Stargazers: [See the Hall of Fame](https://github.com/onestardao/WFGY/tree/main/stargazers)** —
 > Engineers, hackers, and open source builders who supported WFGY from day one.

 > <img src="https://img.shields.io/github/stars/onestardao/WFGY?style=social" alt="GitHub stars"> ⭐ [WFGY Engine 2.0](https://github.com/onestardao/WFGY/blob/main/core/README.md) is already unlocked. ⭐ Star the repo to help others discover it and unlock more on the [Unlock Board](https://github.com/onestardao/WFGY/blob/main/STAR_UNLOCKS.md).
@ -188,19 +201,19 @@ Tell me:
 <div align="center">

 [![WFGY Main](https://img.shields.io/badge/WFGY-Main-red?style=flat-square)](https://github.com/onestardao/WFGY)
-&nbsp;
+ 
 [![TXT OS](https://img.shields.io/badge/TXT%20OS-Reasoning%20OS-orange?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS)
-&nbsp;
+ 
 [![Blah](https://img.shields.io/badge/Blah-Semantic%20Embed-yellow?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlahBlahBlah)
-&nbsp;
+ 
 [![Blot](https://img.shields.io/badge/Blot-Persona%20Core-green?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlotBlotBlot)
-&nbsp;
+ 
 [![Bloc](https://img.shields.io/badge/Bloc-Reasoning%20Compiler-blue?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlocBlocBloc)
-&nbsp;
+ 
 [![Blur](https://img.shields.io/badge/Blur-Text2Image%20Engine-navy?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlurBlurBlur)
-&nbsp;
+ 
 [![Blow](https://img.shields.io/badge/Blow-Game%20Logic-purple?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlowBlowBlow)
-&nbsp;
+ 
+
 </div>

-