diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..13c754d7
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,7 @@
+# CLAUDE.md
+
+## Commands
+
+- Pages are Markdown under `content/`; the theme is a git submodule under `themes/`.
+- Build: `hugo --minify` (needs Hugo extended). Preview: `hugo serve`.
+- Spelling: `.github/workflows/english_test.sh` fails on British spellings in `content/`; write American English.