diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..1a04b0e
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,24 @@
+# cosma-qc
+
+Voir README.md pour la description du projet.
+
+---
+
+## Infrastructure (Flag Lab)
+
+Repo de reference : `floppyrj45/infra` sur Gitea
+- `INFRA.md` — carte complete machines et services
+- `RUNBOOK.md` — diagnostic quand ca patouille
+- `AUTO_STATUS.md` — etat temps reel (infra-watcher toutes les 5 min)
+
+### Acces SSH
+- CORE : `ssh floppyrj45@192.168.0.82`
+- Gitea LAN : `http://192.168.0.82:3000`
+- Gitea public : `https://laboratoire.freeboxos.fr/gitea/`
+- Proxmox : `http://192.168.0.168:8006`
+
+### Conventions dev
+- Commits en francais, prefixes `feat:` / `fix:` / `docs:`
+- Push sur Gitea (.82), pas GitHub
+- Jamais de secrets dans les repos — variables dans `~/.openclaw/workspace/.env`
+- Jamais detruire une VM sans accord explicite de Baptiste
\ No newline at end of file