diff --git a/README.md b/README.md
index 8a8921d..3a57127 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,41 @@
-# exorcist-game
+# Exorcist Game (Arcane Purge)
+
+A text-based exorcist game where Bible verses are the spell mechanics. Fight through a gauntlet of escalating demons by matching verse categories to each demon's weaknesses.
+
+> Personal prototype project — functional, but not polished.
+
+## Gameplay
+
+- Terminal-based combat loop with timer pressure
+- Six escalating demon encounters, each with health, damage, and elemental weaknesses
+- Verse-based spell system: recite verses from the right category (Binding, Healing, Exorcism, Protection, Judgment) to deal damage
+- Mismatched categories fizzle — read the demon, pick the verse
+
+## Project Structure
+
+| Path | Description |
+|------|-------------|
+| `main.py` | Game engine, demon definitions, and combat loop |
+| `data.py` | Verse loading, normalization, and spell resolution |
+| `verses.json` | Verse dataset |
+| `docker/` | Dockerfile and compose for containerized runs |
+| `tests/` | Test suite for verse data and game logic |
+
+## Running
+
+### Local
+
+```bash
+uv sync
+python main.py
+```
+
+### Docker
+
+```bash
+docker compose -f docker/docker-compose.yml up
+```
+
+## Status
+
+Working prototype. Built as an experiment in terminal game design; not actively maintained.
diff --git a/__pycache__/data.cpython-311.pyc b/__pycache__/data.cpython-311.pyc
deleted file mode 100644
index eaccd6e..0000000
Binary files a/__pycache__/data.cpython-311.pyc and /dev/null differ
diff --git a/__pycache__/data.cpython-313.pyc b/__pycache__/data.cpython-313.pyc
deleted file mode 100644
index 3db61c6..0000000
Binary files a/__pycache__/data.cpython-313.pyc and /dev/null differ
diff --git a/__pycache__/data.cpython-314.pyc b/__pycache__/data.cpython-314.pyc
deleted file mode 100644
index 33fc20b..0000000
Binary files a/__pycache__/data.cpython-314.pyc and /dev/null differ
diff --git a/__pycache__/main.cpython-313.pyc b/__pycache__/main.cpython-313.pyc
deleted file mode 100644
index f5868fa..0000000
Binary files a/__pycache__/main.cpython-313.pyc and /dev/null differ
diff --git a/__pycache__/main.cpython-314.pyc b/__pycache__/main.cpython-314.pyc
deleted file mode 100644
index 069b402..0000000
Binary files a/__pycache__/main.cpython-314.pyc and /dev/null differ
diff --git a/tests/__pycache__/test_data.cpython-313-pytest-9.0.3.pyc b/tests/__pycache__/test_data.cpython-313-pytest-9.0.3.pyc
deleted file mode 100644
index 82b28c0..0000000
Binary files a/tests/__pycache__/test_data.cpython-313-pytest-9.0.3.pyc and /dev/null differ
diff --git a/tests/__pycache__/test_data.cpython-314-pytest-9.0.2.pyc b/tests/__pycache__/test_data.cpython-314-pytest-9.0.2.pyc
deleted file mode 100644
index bd5b028..0000000
Binary files a/tests/__pycache__/test_data.cpython-314-pytest-9.0.2.pyc and /dev/null differ
diff --git a/tests/__pycache__/test_main.cpython-313-pytest-9.0.3.pyc b/tests/__pycache__/test_main.cpython-313-pytest-9.0.3.pyc
deleted file mode 100644
index 89096c8..0000000
Binary files a/tests/__pycache__/test_main.cpython-313-pytest-9.0.3.pyc and /dev/null differ
diff --git a/tests/__pycache__/test_main.cpython-314-pytest-9.0.2.pyc b/tests/__pycache__/test_main.cpython-314-pytest-9.0.2.pyc
deleted file mode 100644
index c65aa78..0000000
Binary files a/tests/__pycache__/test_main.cpython-314-pytest-9.0.2.pyc and /dev/null differ