diff --git a/CLAUDE.md b/CLAUDE.md
index e887315..60edfee 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -112,6 +112,16 @@ med Docker container-IPs.
 - Maskinrommet (host) → Docker-tjenester: via container-IP
   (løses dynamisk i `maskinrommet-env.sh`)
 
+## Claude CLI-verktøy
+Claude kan opprette egne CLI-verktøy i `tools/` for å interagere med
+systemet. Shell-scripts eller Rust binaries. Krav:
+- Dokumenter hvert verktøy i `tools/README.md`
+- Bruk PG direkte (`psql`) eller maskinrommet-API (`curl localhost:3100`)
+- Navnekonvensjon: `synops-<verb>` (f.eks. `synops-context`, `synops-search`)
+- Hold det enkelt — ett verktøy per oppgave
+
+Ref: `docs/infra/agent_api.md` for planlagt API-overflate.
+
 ## Claude som chat-deltaker
 - **Agent-node:** `d3eebc99-9c0b-4ef8-bb6d-6bb9bd380a44` (node_kind: `agent`)
 - **Trigger:** Melding i kommunikasjonsnode der Claude er `member_of`
diff --git a/tools/README.md b/tools/README.md
new file mode 100644
index 0000000..9d695b1
--- /dev/null
+++ b/tools/README.md
@@ -0,0 +1,27 @@
+# Synops CLI-verktøy
+
+CLI-verktøy for Claude sin interaksjon med systemet. Bruker PG direkte
+eller maskinrommet-API. Ligger i PATH via symlink eller direkte kall.
+
+## Verktøy
+
+| Verktøy | Beskrivelse | Status |
+|---------|-------------|--------|
+| (kommer) | | |
+
+## Konvensjoner
+- Navnekonvensjon: `synops-<verb>` (f.eks. `synops-context`)
+- Shell-scripts eller Rust binaries
+- Ett verktøy per oppgave — hold det enkelt
+- Output: stdout, strukturert tekst (markdown eller JSON)
+- DB-tilkobling: `$DATABASE_URL` eller fra `/tmp/maskinrommet.env`
+
+## Planlagte verktøy
+Ref: `docs/infra/agent_api.md`
+
+- `synops-context <communication_id>` — hent kontekst for en chat
+- `synops-search <query>` — søk i grafen (noder + edges)
+- `synops-tasks [--phase N] [--status S]` — oppgavestatus fra tasks.md
+- `synops-feature-status <key>` — implementeringsstatus for en feature
+- `synops-respond <comm_id> <tekst>` — send svar i en chat
+- `synops-update-spec <node_id>` — oppdater spec-node (stdin)