From 621bf80c5a35a817aac638c2f745645b5973e891 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?PSBigBig=20=C3=97=20MiniPS?= <psbigbig@onestardao.com>
Date: Mon, 2 Mar 2026 11:12:30 +0800
Subject: [PATCH] docs: add colab MVP landing page

---
 ProblemMap/colab/README.md | 99 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 ProblemMap/colab/README.md

diff --git a/ProblemMap/colab/README.md b/ProblemMap/colab/README.md
new file mode 100644
index 00000000..6b6945e0
--- /dev/null
+++ b/ProblemMap/colab/README.md
@@ -0,0 +1,99 @@
+# WFGY Global Debug Card · Colab MVP
+
+This folder contains the first runnable notebook demo for the **WFGY Global Debug Card**.
+
+The goal of this MVP is not to fully automate every RAG repair.  
+The goal is to prove that the Global Debug Card can move from:
+
+- image-based diagnosis
+- structured triage
+- machine-readable debug packets
+- a reproducible first-pass repair loop
+
+## What this Colab MVP is for
+
+The notebook in this folder is designed to run one failing case built from:
+
+- `Q` = user question
+- `E` = retrieved evidence
+- `P` = final prompt sent to the model
+- `A` = model output
+
+It will then:
+
+1. run a first-pass diagnosis
+2. emit a debug packet
+3. apply one constrained repair action
+4. run one verification pass
+5. show a simple before/after result
+
+This makes the notebook useful for:
+
+- reproducible triage
+- protocol validation
+- small repair experiments
+- future agent integration
+
+## Wave 0 scope
+
+The first public MVP is intentionally narrow.
+
+Wave 0 focuses on the modes that are most suitable for constrained repair loops:
+
+- **No.1** retrieval wrong or off-topic
+- **No.5** semantic vs embedding mismatch
+- **No.8** missing evidence visibility
+- **No.2** interpretation collapse
+
+These are the strongest first targets because they can often improve through:
+
+- retrieval parameter changes
+- query rewrite
+- evidence visibility upgrades
+- constrained prompt repair
+
+## Minimum completion standard
+
+The Colab MVP is considered complete when it can:
+
+1. ingest one `(Q, E, P, A)` case
+2. emit one machine-readable debug packet
+3. apply one constrained repair action
+4. return one verification result
+
+That is the minimum public Wave 0 bar.
+
+## Planned files
+
+This folder will contain:
+
+- `wfgy_global_debug_card_colab_mvp.ipynb`
+
+Related files in nearby folders:
+
+- `ProblemMap/specs/wfgy_problem_catalog_v1.json`
+- `ProblemMap/specs/wfgy_debug_packet_v1.json`
+- `ProblemMap/examples/cases/retrieval_offtopic_case_v1.json`
+- `ProblemMap/examples/packets/retrieval_offtopic_before_v1.json`
+- `ProblemMap/examples/packets/retrieval_offtopic_after_v1.json`
+
+## Current status
+
+Work in progress.
+
+This folder is being prepared as the first public runnable demo layer for the Global Debug Card.  
+The notebook, example case, and packet specs will be added step by step.
+
+## Main entry point
+
+If you are looking for the image-first protocol page, start here:
+
+[WFGY 3.0 · RAG 16 Problem Map · Global Debug Card](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md)
+
+If you want the machine-readable protocol layer, the next step will be:
+
+- `ProblemMap/specs/README.md`
+
+If you want reproducible demo inputs and outputs, the next step will be:
+
+- `ProblemMap/examples/README.md`