‏صف مرج محلی برای ایجنت‌های موازی Claude Code

این پروژه یه صف مرج محلی و بدون هزینه‌ست برای حالتی که چند ایجنت Claude Code هم‌زمان دارن کد لند می‌کنن، بیلد می‌گیرن و تست می‌زنن. کاری که می‌کنه اینه که این کارها رو سریالایز می‌کنه تا رقابت روی پوش، بیلدهای سنگین تکراری و فلیکی‌شدن تست‌ها به‌خاطر منابع مشترک اصلاً پیش نیاد. با npm نصب می‌شه و یه دستور init کل راه‌اندازی رو انجام می‌ده.

همهٔ تنظیمات تو یه فایل جمع شده: اسم برنچ هر lane، پسوند ورک‌تری، پورت پایه، برنچ یکپارچه‌سازی و از همه مهم‌تر checkCommand که دروازهٔ واقعی لندکردنه.

export default {
  branchPrefix: "lane/",
  portBase: 3000,
  integrationBranch: "main",
  checkCommand: "npm run check",
  checksRequired: true,
};

کانفیگ خراب — اسم برنچ خالی، پورت منفی، یا productionBranch برابر با integrationBranch — همون لحظهٔ لود شدن با لیست کامل مشکلات ارور می‌ده، نه سه مرحله بعد.

جعبه‌ابزارش چند دستوره: land که با صف FIFO ریبیس و پوش می‌کنه و خود ایجنت‌ها اجراش می‌کنن، build-lock که بیلد رو در کل ماشین سریالایز می‌کنه، sync برای فست‌فوروارد کردن چک‌اوت اصلی، preview برای آینه‌کردن فوری تغییرات یه lane بدون بیلد، و promote که فقط دست آدمه و به گفتهٔ نویسنده هیچ‌وقت نباید تو دستورات ایجنت بیاد. یه هوک pre-push هم پوش مستقیم به برنچ یکپارچه‌سازی رو رد می‌کنه و قبل از هر لند checkCommand رو اجرا می‌کنه؛ راه فرار اضطراری هم هست، ولی از طریق یه متغیر محیطی مشخص، نه یه فلگ عمومی.

نویسنده خودش محدودیت‌ها رو صریح گفته: هیچ آدمی قبل از لندشدن کد رو ری‌ویو نمی‌کنه و تنها دروازه پاس‌شدن checkCommand هست، پس یه تست‌سوییت واقعی و یه دستور الکی برای این ابزار فرقی ندارن. قفل‌ها بر پایهٔ زنده‌بودن PID کار می‌کنن نه تایم‌اوت، همه‌چیز فقط روی یک ماشین معتبره، و این ابزار مرز امنیتی نیست — جلوی اشتباه رو می‌گیره نه یه ایجنت متخاصم. یه checkCommand کند هم سقف واقعی توان عبوره: سوییت سه‌چهار دقیقه‌ای یعنی خیلی کمتر از ۲۰ لند در ساعت.

نکات کلیدی:

• صف مرج محلی و رایگان برای ایجنت‌های موازی Claude Code، بدون نیاز به پول‌ریکوئست
• هر lane برنچ و ورک‌تری و پورت جدا داره؛ land ریبیس و پوش رو با صف FIFO سریالایز می‌کنه
• هوک pre-push پوش مستقیم رو رد می‌کنه و checkCommand تنها دروازهٔ لندکردنه
• محدودیت‌ها: بدون ری‌ویو انسانی، فقط روی یک ماشین، و مرز امنیتی محسوب نمی‌شه