diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..995ce71
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,43 @@
+# mcNanoVNA Docs
+
+Documentation site for mcNanoVNA — MCP server for NanoVNA vector network analyzer control.
+
+- **Production**: https://mcnanovna.warehack.ing
+- **Git**: `git@git.supported.systems:RF/mcnanovna-docs.git`
+- **Server**: `ssh -A warehack-ing@warehack.ing`, repo at `~/mcnanovna-docs`
+
+## Stack
+
+- Astro/Starlight (static output)
+- Docker multi-stage build (Node builder -> Caddy prod)
+- caddy-docker-proxy on external `caddy` network
+- Separate `docker-compose.dev.yml` for development overlay
+
+## Environment
+
+Copy `.env.example` to `.env`:
+
+```env
+COMPOSE_PROJECT=mcnanovna-docs
+DOMAIN=mcnanovna.warehack.ing
+MODE=prod
+```
+
+## Commands
+
+```bash
+make up        # Start production (static Caddy server)
+make dev       # Start development (Vite hot-reload)
+make down      # Stop all containers
+make logs      # Follow container logs
+make build     # Build production image
+make rebuild   # Force rebuild (no cache)
+make shell     # Open shell in running container
+make clean     # Remove containers, images, volumes
+```
+
+## Deploy to Production
+
+```bash
+ssh -A warehack-ing@warehack.ing "cd ~/mcnanovna-docs && git pull && make up"
+```