diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..cb58a35
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,13 @@
+# Project Instructions
+
+## Pi 400 Access
+
+- SSH access: `ssh m@sdr-pi` (account has sudo)
+- ALWAYS confirm with the user before running anything destructive on the Pi, including:
+  - Any command requiring `sudo`
+  - Installing or removing packages
+  - Changing system configuration files
+
+## Workflow
+
+- Always commit when archiving an OpenSpec change