Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.
TypeScript acmeagentsai-agentscertificate-managementdevsecopsenvironment-variableskubernetesopen-sourcepampkipostgresprivate-caprivileged-access-managementsecret-managementsecret-managersecretssecrets-managementsecuritysecurity-toolsvault
chore: add CLAUDE.md pointers so Claude Code loads nested AGENTS.md files
andrewhuhh5baec85a941c
diff --git a/AGENTS.md b/AGENTS.mdindex 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mddiff --git a/backend/e2e-test/CLAUDE.md b/backend/e2e-test/CLAUDE.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.+