1 files changed, 21 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..174a71c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# GAP: Generalization-and-Perturbation Framework
+
+Code for the GAP framework, which decomposes equivalence-preserving transformations of mathematical problems into **surface** (deterministic renaming) and **kernel** (parameter resampling with multi-judge verification) families.
+
+## Contents
+
+- `putnam-bench-anon/` — evaluation harness: multi-provider async solver/grader with checkpoint, cross-provider grading, CLI
+- `mini_gap_math*.py` — MATH Level 4-5 generalization experiments
+- `kv_math*.py` — kernel-variant generation and evaluation on MATH
+- `analysis/` — structural-overlap analysis, rescue experiment runner, figure generation
+
+## Quick start
+
+```bash
+pip install -r putnam-bench-anon/requirements.txt
+python putnam-bench-anon/putnam_cli.py --help
+```
+
+## License
+
+CC-BY-4.0. See `LICENSE`.