diff --git a/CLAUDE.md b/CLAUDE.md
index 8a6a5fa85..a49f0219d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -12,7 +12,14 @@
 - **Dependency Management Upgrade**: Conan libraries updated (14 changes), npm security patches applied (9 packages), Python/Go workflow plugin management established
 - **Project Root Cleanup**: Removed one-off scripts, organized reports in /txt/
 - **FakeMUI Accessibility**: Complete data-testid & ARIA integration (Button, TextField updated; 105 components ready for systematic update)
+- **Critical NPM Fix** (Jan 23, 2026): Fixed 9 invalid npm package versions across root workspaces:
+  - eslint: 9.41.0 → 9.39.2 (4 files: frontends/nextjs, frontends/dbal, codegen, old)
+  - @eslint/js: 9.41.0 → 9.39.2, 9.21.0 → 9.28.0 (3 files)
+  - @tanstack/react-query: 5.91.2 → 5.90.20 (2 files)
+  - codegen additional fixes: framer-motion 13.0.3 → 12.29.0, react-hook-form 7.73.0 → 7.71.1, vite 7.4.0 → 7.3.1
+  - Result: ✅ npm install succeeds, ✅ npm audit clean (7 moderate dev-only), ✅ all versions valid
 - **AI Assistant Workflow Refined**: Full implementation required, no partial fixes, always use Explore agent for planning
+- **Dependency Planning**: Created ESLINT_VITE_COMPREHENSIVE_FIX_PLAN_2026-01-23.txt with full mapping and remediation
 
 ---