Skip to content

Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active

📐 docs: Make CLAUDE.md Portable and Restore AGENTS.md Parity (#15046)

Alexandre Beguel6baeff801c4b
diff --git a/AGENTS.md b/AGENTS.md
index 1cc4a69d52..287d5357f2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -10,4 +10,8 @@ instead of copying classes into a feature. Keep genuine layout and behavior loca
why any new custom CSS cannot be expressed by the shared system. See the detailed policy in
`CLAUDE.md` under “Theming and styling.”
-When adding or changing code that mutates user documents, invalidate the auth user document cache for affected users. This includes single-user updates and bulk role/user mutations; otherwise OpenID JWT request burst caching can serve a stale `req.user` until its TTL expires.
+## Backend auth cache
+
+When adding or changing code that mutates user documents, invalidate the auth user document cache
+for affected users, including bulk role and user mutations. See the detailed policy in `CLAUDE.md`
+under “Auth cache invalidation”.
diff --git a/CLAUDE.md b/CLAUDE.md
index 20cda2ee2f..bff3a7ebd1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -13,7 +13,8 @@ LibreChat is a monorepo with the following key workspaces:
| `/client` | TypeScript/React | Frontend | `packages/data-provider`, `packages/client` | Frontend SPA |
| `/packages/client` | TypeScript | Frontend | `packages/data-provider` | Shared frontend utilities |
-The source code for `@librechat/agents` (major backend dependency, same team) is at `/home/danny/agentus`.
+The source code for `@librechat/agents` (major backend dependency, same team) lives at
+<https://github.com/danny-avila/agents>.
---
@@ -170,6 +171,16 @@ Multi-line imports count total character length across all lines. Consolidate va
---
+## Backend Rules (`api/**`, `packages/api/**`)
+
+### Auth cache invalidation
+
+When adding or changing code that mutates user documents, invalidate the auth user document cache
+for the affected users. This covers single-user updates as well as bulk role and user mutations.
+Without it, OpenID JWT request burst caching can serve a stale `req.user` until its TTL expires.
+
+---
+
## Development Commands
| Command | Purpose |