diff --git a/CLAUDE.md b/CLAUDE.md
index d9a8e37..c30668e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,7 +5,7 @@ mirroring to Gitea, cleanup and retention, and arbitrary REST calls on a cron. P
 FastAPI, APScheduler, PostgreSQL and Redis. Container `scheduler` on `docker-dataplane`,
 port **8090**, Redis DB **3**, Postgres DB **scheduler**.
 
-It is the homelab's cron. Recurring work belongs here rather than in a systemd timer (D-5).
+It is the homelab's cron. Recurring work belongs here rather than in a systemd timer (workspace D-5).
 
 ## Live contract
 
@@ -115,7 +115,7 @@ tagging.
 
 Work lives in **pql**, not a markdown TODO. **This repo's vault is standalone** — its tickets
 and its internal decisions live here in `.pql/` and `governance/`, and travel with a clone,
-because `.pql/changelog/` is committed and replayed by the git hooks (D-15). The databases are
+because `.pql/changelog/` is committed and replayed by the git hooks (workspace D-15). The databases are
 gitignored and rebuildable with `pql plan rebuild`.
 
 `pql` is **not** on the non-interactive `PATH` — invoke it as `/home/jpmschweitzer/.local/bin/pql`.
@@ -129,7 +129,7 @@ is this repo.
 ```
 
 Stack-level decisions that constrain this service — the host, the network, deploy mechanics,
-and the fact that recurring work belongs here at all (D-5) — live in the **workspace** vault
+and the fact that recurring work belongs here at all (workspace D-5) — live in the **workspace** vault
 and need the flag:
 
 ```bash