diff --git a/CLAUDE.md b/CLAUDE.md
index 2f20d219..51dd8b8e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -137,6 +137,8 @@ Swarm-level:
   `swarm-logs-auth`.
 - **`swarm-logs-auth/`** — nginx `auth_request` responder for agent access
   to the log store.
+- **`swarm-metrics-auth/`** — nginx `auth_request` responder for Grafana's
+  bearer on the metrics store's query API.
 - **`swarm-logs/`** — agent CLI: a LogsQL query in, log lines out.
 - **`swarm-matrix-client/`** — appservice calls against the swarm
   homeserver, shared by `swarm-controller` and `swarm-matrix-ctl`.
@@ -145,6 +147,9 @@ Swarm-level:
   crates.
 - **`swarm-builder/`** — builds agent config PR heads for commit status.
   Design: [`docs/swarm/builder.md`](docs/swarm/builder.md).
+- **`swarm-ci-metrics/`** — polls the forge's Actions runs and pushes each
+  finished run's duration and queue wait to the metrics store. Design:
+  [`docs/swarm/ci-metrics.md`](docs/swarm/ci-metrics.md).
 - **`swarm-claude-login/`** — runs `claude auth login` for one agent and
   stores the credentials at `swarm/agents/<agent>/claude-credentials`.
   Design: [`docs/swarm/claude-login.md`](docs/swarm/claude-login.md).