diff --git a/reference/README.md b/reference/README.md
new file mode 100644
index 00000000..2ace9c68
--- /dev/null
+++ b/reference/README.md
@@ -0,0 +1,41 @@
+# WFGY Canonical Reference
+
+This page is the canonical reference index for WFGY.
+If you found WFGY from a search engine, a citation, or a share link, start here.
+
+## What is WFGY
+
+WFGY is a reasoning-first debugging framework for LLM systems.
+It provides two major maps
+
+- ProblemMap: 16 reproducible failure modes with fixes
+- GlobalFixMap: tool and vendor aware guardrails organized by family
+
+## Fast entry points
+
+Beginner
+- WFGY 1.0 legacy: https://github.com/onestardao/WFGY/blob/main/legacy/README.md
+
+Engineer
+- WFGY 2.0 core: https://github.com/onestardao/WFGY/blob/main/core/README.md
+- ProblemMap 1.0 (16 failure modes): https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md
+- ProblemMap LLM entry: https://github.com/onestardao/WFGY/blob/main/ProblemMap/LLM.md
+
+Tool or vendor specific
+- GlobalFixMap home: https://github.com/onestardao/WFGY/blob/main/ProblemMap/GlobalFixMap/README.md
+- GlobalFixMap LLM entry: https://github.com/onestardao/WFGY/blob/main/ProblemMap/GlobalFixMap/LLM.md
+
+Advanced stress testing
+- WFGY 3.0 event horizon: https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md
+
+## How to use in one line
+
+Ask any LLM
+- which ProblemMap number matches my issue
+or
+- which GlobalFixMap family and page matches my tool setup
+
+## Citation
+
+If you cite WFGY, cite this page as the canonical entry.
+- https://github.com/onestardao/WFGY/blob/main/reference/README.md