‏پلاگین shunt، مصرف توکن Claude Code رو ۹۰٪ کم کرد

نویسنده تو بلاگ مهندسی Spotify می‌گه بیشتر کاری که یه ایجنت کدنویسی مثل Claude Code انجام می‌ده اصلاً فکر کردن نیست، I/O ـه: خوندن پنج تا فایل برای جواب دادن به یه سوال دربارهٔ یه متد، یا ساختن یه فایل تست شبیه بیست تا تست بغلیش. به گفتهٔ اون هزینهٔ اصلی هم لایسنس نیست، توکنه؛ و طبق پیش‌بینی Gartner تا سال ۲۰۲۸ هزینهٔ کدنویسی با AI از میانگین حقوق یه برنامه‌نویس هم رد می‌شه.

راه‌حلی که پیدا کرده دو تا mode تو Portal by Spotify بوده. mode یه ایجنت declarative ـه، یعنی فقط تو یه فایل می‌نویسی دستورالعمل چیه، کدوم مدل، با چه پارامترهایی و چه ابزارهایی، و بقیه‌ش با Portal ـه که روی یه رانتایم موقت اجراش می‌کنه. mode اول یعنی bulk-reader فایلای بزرگ رو می‌خونه و جواب کوتاه و بولت‌وار می‌ده، دومی یعنی code-writer کد قابل‌پیش‌بینی مثل تست و config رو از روی یه فایل نمونه می‌سازه. تو مثال‌ها هر دو با Gemini 2.5 Flash کار می‌کنن.

نسخهٔ اول این مسیریابی فقط چند تا قانون تو CLAUDE.md بود، ولی چون قانون‌ها توصیه‌ای بودن Claude می‌تونست نادیده‌شون بگیره. نسخهٔ فعلی یه پلاگین به اسم shunt ـه با سه لایه: هوک‌های PreToolUse که خوندن فایل بالای ۳۵۰ خط رو بلاک می‌کنن (این آستانه با متغیر SHUNT_MIN_LINES عوض می‌شه)، دو تا اسکریپت که Portal CLI رو صدا می‌زنن، و دو تا skill که به Claude می‌گن کِی و چطور اون اسکریپتا رو صدا بزنه. خوندن هدفمند با offset و limit همچنان آزاده.

نویسنده محدودیتا رو هم صاف می‌گه. ویرایش کد رو نمی‌شه واگذار کرد چون خلاصهٔ مدل کارگر شمارهٔ خط قابل‌اعتماد نداره. استدلال کردن هم نه؛ اون مدل تو تستش یه باگ ظریف thread-safety رو ندید ولی Claude سریع گرفتش. هر واگذاری هم یه رفت‌وبرگشت شبکه‌ست و معمولاً ۱۰ تا ۳۰ ثانیه طول می‌کشه، با سقف ۳۰ ثانیه برای هر invocation. برای همین آستانهٔ خط وجود داره: زیر اون حد، هزینهٔ تأخیر از صرفه‌جویی بیشتر می‌شه.

نکات کلیدی:

• میانگین صرفه‌جویی توکن تو تست روی یه مونوریپوی جاوا حدود ۹۰٪ بوده
• آستانهٔ پیش‌فرض بلاک شدن خوندن فایل ۳۵۰ خطه و با SHUNT_MIN_LINES تنظیم می‌شه
• هر invocation تو Portal سقف ۳۰ ثانیه داره و جواب معمولاً ۱۰ تا ۳۰ ثانیه طول می‌کشه
• دو mode عمومی bulk-reader و code-writer آماده‌ن و تو مثال‌ها با Gemini 2.5 Flash کار می‌کنن
• دیباگ، تصمیم‌های معماری و کد حساس عمداً از مسیر واگذاری بیرون گذاشته شدن