Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

chore: add CLAUDE.md pointers so Claude Code loads nested AGENTS.md files

andrewhuhh5baec85a941c
diff --git a/AGENTS.md b/AGENTS.md
index e0d8d42339..944559a0fe 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -101,4 +101,4 @@ Alerting (`backend/src/services/alert/`) and approvals (`backend/src/services/ap
## Keeping AGENTS.md Files Up to Date
-When a change adds a service, a pattern, or an invariant an agent would otherwise get wrong, update the `AGENTS.md` closest to that code. Put cross-cutting rules here, package rules in the package file, and subsystem detail in a file next to the subsystem's code, then link it from its package's `AGENTS.md`. Keep each file a map rather than a spec: concepts, where things live, and non-obvious invariants. Leave signatures, field lists, and step-by-step mechanics to the code.
+When a change adds a service, a pattern, or an invariant an agent would otherwise get wrong, update the `AGENTS.md` closest to that code. Put cross-cutting rules here, package rules in the package file, and subsystem detail in a file next to the subsystem's code, then link it from its package's `AGENTS.md`. Add a `CLAUDE.md` beside every new `AGENTS.md` that holds only the `@AGENTS.md` import: once the root `CLAUDE.md` exists, Claude Code reads only `CLAUDE.md` files, so a nested `AGENTS.md` without that pointer never loads for it. Keep each file a map rather than a spec: concepts, where things live, and non-obvious invariants. Leave signatures, field lists, and step-by-step mechanics to the code.
diff --git a/backend-go/CLAUDE.md b/backend-go/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend-go/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/CLAUDE.md b/backend/CLAUDE.md
new file mode 100644
index 0000000000..fcd33de464
--- /dev/null
+++ b/backend/CLAUDE.md
@@ -0,0 +1,4 @@
+Claude Code pointer: the guidance for this package is in AGENTS.md, and every backend change is checked against CODE_QUALITY.md.
+
+@CODE_QUALITY.md
diff --git a/backend/e2e-test/CLAUDE.md b/backend/e2e-test/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/e2e-test/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/agent-vault/CLAUDE.md b/backend/src/ee/services/agent-vault/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/agent-vault/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/audit-log/CLAUDE.md b/backend/src/ee/services/audit-log/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/audit-log/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/dynamic-secret/CLAUDE.md b/backend/src/ee/services/dynamic-secret/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/dynamic-secret/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/gateway-v2/CLAUDE.md b/backend/src/ee/services/gateway-v2/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/gateway-v2/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/pam/CLAUDE.md b/backend/src/ee/services/pam/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/pam/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/permission/CLAUDE.md b/backend/src/ee/services/permission/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/permission/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/ee/services/pki-discovery/CLAUDE.md b/backend/src/ee/services/pki-discovery/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/ee/services/pki-discovery/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/lib/cron/CLAUDE.md b/backend/src/lib/cron/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/lib/cron/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/lib/logger/CLAUDE.md b/backend/src/lib/logger/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/lib/logger/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/lib/request-context/CLAUDE.md b/backend/src/lib/request-context/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/lib/request-context/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/lib/telemetry/CLAUDE.md b/backend/src/lib/telemetry/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/lib/telemetry/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/queue/CLAUDE.md b/backend/src/queue/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/queue/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/server/lib/CLAUDE.md b/backend/src/server/lib/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/server/lib/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/server/plugins/auth/CLAUDE.md b/backend/src/server/plugins/auth/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/server/plugins/auth/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/alert/CLAUDE.md b/backend/src/services/alert/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/alert/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/approval-policy/CLAUDE.md b/backend/src/services/approval-policy/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/approval-policy/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/certificate-authority/CLAUDE.md b/backend/src/services/certificate-authority/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/certificate-authority/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/event-outbox/CLAUDE.md b/backend/src/services/event-outbox/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/event-outbox/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/kms/CLAUDE.md b/backend/src/services/kms/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/kms/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/oauth-client/CLAUDE.md b/backend/src/services/oauth-client/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/oauth-client/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/resource-cleanup/CLAUDE.md b/backend/src/services/resource-cleanup/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/resource-cleanup/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/telemetry/CLAUDE.md b/backend/src/services/telemetry/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/telemetry/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/backend/src/services/user-alias/CLAUDE.md b/backend/src/services/user-alias/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/backend/src/services/user-alias/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/docs/CLAUDE.md b/docs/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/docs/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/e2e/CLAUDE.md b/e2e/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/e2e/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/frontend/CLAUDE.md b/frontend/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/frontend/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/tests/CLAUDE.md b/tests/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/tests/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+
diff --git a/wasm/ironrdp-decoder/CLAUDE.md b/wasm/ironrdp-decoder/CLAUDE.md
new file mode 100644
index 0000000000..afc9db3545
--- /dev/null
+++ b/wasm/ironrdp-decoder/CLAUDE.md
@@ -0,0 +1,3 @@
+Claude Code pointer: the guidance for this directory is in AGENTS.md.
+