diff --git a/CLAUDE.md b/CLAUDE.md
index 46c587a..ab16a3e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -71,11 +71,13 @@ Note: Git passthrough works for ALL subcommands, even those not explicitly liste
 rtk pnpm list           # Compact dependency tree (70%)
 rtk pnpm outdated       # Compact outdated packages (80%)
 rtk pnpm install        # Compact install output (90%)
-rtk npm run <script>    # Compact npm script output
+rtk npm build           # ⚠️ BUG: Use "rtk npm build" NOT "rtk npm run build"
 rtk npx <cmd>           # Compact npx command output
 rtk prisma              # Prisma without ASCII art (88%)
 ```
 
+**Known RTK Bug**: For npm scripts, use `rtk npm build` instead of `rtk npm run build`. The `run` keyword causes RTK to fail.
+
 ### Files & Search (60-75% savings)
 ```bash
 rtk ls <path>           # Tree format, compact (65%)