diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000000..66ef4c120ef0
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,5 @@
+## Refactoring Scope
+- Constrain scope tightly: do not modify unrelated files, themes, or settings 'while you're in there'.
+
+## Verification
+- For bug fixes, write the failing regression test FIRST and confirm it fails before applying the fix.