AGENTS.md · diff

git:20260810.c3a429d to git:20260820.6baeff8

5 added, 1 removed. Audit A to A.

See CLAUDE.md.

## Frontend theming and styling

For frontend work, compose existing `@librechat/client` primitives and variants before adding

feature-local styles. Use semantic theme/Tailwind roles for color and shared appearance; do not

introduce raw palette utilities, hard-coded colors, or arbitrary theme CSS. If the system cannot

express a reusable design need, deepen the shared primitive or versioned theme-token registry

instead of copying classes into a feature. Keep genuine layout and behavior local, and document

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”.