diff --git a/CLAUDE.md b/CLAUDE.md
index 086ff07..193a908 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -71,6 +71,14 @@ TICKETS_API_KEY="" DATABASE_URL="sqlite+aiosqlite:///dev.db" \
   uvicorn corvid.main:app --reload --port 8090
 ```
 
+## IaC sync
+
+Corvid runs embedded inside the homelab-dashboard Docker image — it is not deployed
+as a standalone service via Ansible. However, its config surface (env vars, ports,
+API key) is reflected in `pve/ansible/roles/homedash/templates/env.j2` and
+`pve/ansible/host_vars/hetzner.yml`. If corvid's env requirements change (new vars,
+renamed keys), update those files to prevent drift flagged by the compliance runner.
+
 ## DB migrations
 
 Alembic runs at startup (`entrypoint.sh`). Add new migrations in