From efcf5c185f365178164fbf4be110d532751b94b5 Mon Sep 17 00:00:00 2001
From: Marko Djordjevic <marko.homoludens@gmail.com>
Date: Mon, 16 Feb 2026 16:01:20 +0100
Subject: [PATCH] docs: document RTK bug with npm run command

---
 CLAUDE.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

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%)