‏ورک‌فلوی توسعه با هوش مصنوعی: یک تجربه‌ی واقعی

مارک اریکسون یه پست مفصل نوشته درباره‌ی ستاپ واقعی‌اش برای توسعه با کمک ایجنت‌های هوش مصنوعی. هدفش نه فروختن چیزیه نه ادعای کارشناسی — فقط می‌خواد بگه به چه نتیجه‌ای رسیده و چرا.

ابزارها: او از OpenCode به عنوان ایجنت اصلی استفاده می‌کنه، اما نه با رابط ترمینال (TUI) — بلکه با یه UI وبی به اسم CodeNomad. این انتخاب به خاطر نیاز به تب‌های چندگانه، هایلایت سینتکس، و کپی‌پیست راحته. محیط کار ترکیبی از WSL روی ویندوزه: سرور داخل WSL اجرا می‌شه و UI از مرورگر ویندوز باز می‌شه. مدل انتخابی هم Claude Opus 4.6 از Anthropic هست که از طریق API استفاده می‌شه.

ورک‌فلوی دو لایه: هسته‌ی اصلی کار یه معماری Orchestrator/Subtask هست. یه سشن «والد» طولانی‌مدت فقط وظیفه داره کانتکست کلی پروژه رو نگه داره و زیرتسک‌ها رو راه‌اندازی کنه. سشن‌های فرزند جاییه که کار واقعی — تحقیق، برنامه‌ریزی، و کدنویسی — انجام می‌شه. اریکسون تأکید می‌کنه که خودش تصمیم می‌گیره چی کار بشه، کِی تموم بشه، و کِی کامیت بزنه.

مدیریت پرمیشن‌ها: او YOLO نمی‌کنه. یه پلاگین سفارشی نوشته که دستورات Bash رو بر اساس یه لیست regex از دستورات امن/خطرناک تجزیه می‌کنه و اکثر پرامپت‌های تأیید رو حذف می‌کنه، بدون اینکه خطر واقعی ایجاد کنه. این رویکرد قطعی (deterministic) هست — یعنی به‌جای اینکه بذاری خود مدل تصمیم بگیره، منطق قابل‌پیش‌بینی اجرا می‌شه.

مدیریت کانتکست: یکی از چالش‌های اصلی کار با ایجنت‌ها پر شدن پنجره‌ی کانتکست (context window) هست. اریکسون از سه ابزار برای جلوگیری از این مشکل استفاده می‌کنه: cachebro برای کش کردن فایل‌های خونده‌شده، grepika و tilth برای جستجوی ساختار کد بدون نیاز به خوندن کل فایل‌ها، و پلاگین OpenCode Dynamic Context Pruning که به‌جای فشرده‌سازی کل سشن، بخش‌های قدیمی رو تدریجی فشرده می‌کنه. نتیجه اینه که حتی سشن‌های خیلی طولانی هم به‌ندرت از ۱۰۰ هزار توکن می‌گذرن.

مخزن مستندات شخصی (dev-plans): برای اینکه فایل‌های Markdown پلن و تحقیق، ریپوی مشترک تیم رو آلوده نکنن، یه ریپوی جداگانه‌ی شخصی ساخته به اسم dev-plans. ساختار این ریپو شامل پوشه‌های architecture، features، research، progress-updates، و subtask-handoffs هست. یه اسکریپت TypeScript به اسم devplans.ts هم با Bun نوشته که کارهای تکراری مثل ثبت پیشرفت روزانه و مدیریت فایل‌های handoff رو اتوماتیک می‌کنه:

// devplans.ts - نمونه‌ای از دستورات موجود
//   devplans progress                  // ایجاد/دریافت فایل پیشرفت امروز
//   devplans handoff create [slug]     // ایجاد فایل handoff جدید
//   devplans handoff consume           // خواندن و آرشیو همه‌ی handoffهای معلق
//   devplans doc create <type> <slug>  // ایجاد سند با تاریخ (feature|arch|...)

نکات کلیدی:

• OpenCode با UI وبی CodeNomad به‌جای TUI — انعطاف بیشتر، کنترل بهتر
• معماری دو لایه: Orchestrator برای مدیریت، Subtask برای کار واقعی
• پرمیشن‌ها با پارسینگ قطعی Bash مدیریت می‌شن، نه تأیید همه یا هیچ
• ترکیب cachebro + grepika + Dynamic Context Pruning، کانتکست رو کوچک نگه می‌داره
• ریپوی dev-plans مجزا از ریپوی اصلی، برای نگهداری مستندات شخصی
• کامیت‌های Git هنوز دستی توسط خود توسعه‌دهنده انجام می‌شه