Planning with Files: پلنریزیِ ماندگار روی دیسک برای ایجنتهای کدنویسی
خلاصهٔ کاملتر
به گفتهٔ مستندات پروژه، planning-with-files یه اسکیلِ پلنریزیِ فایلمحورِ ماندگار برای ایجنتهای کدنویسی هوش مصنوعیه. ایدهاش سادهست: بهجای اینکه پلن و پیشرفت کار فقط تو حافظهٔ ایجنت بمونه، سه فایل task_plan.md، findings.md و progress.md رو روی دیسک نگه میداره تا ایجنت از دستدادن کانتکست (context loss)، دستور /clear و کرش جون سالم به در ببره.
نویسنده این رویکرد رو به Manus تشبیه میکنه؛ همون شرکت ایجنت هوش مصنوعی که به گفتهٔ مقاله Meta با ۲ میلیارد دلار خریدش. طبق مستندات، Meta شرکت Manus رو ۲۹ دسامبر ۲۰۲۵ خرید، و این اسکیل همون سبکِ پلنریزی با فایلهای Markdownِ ماندگار رو برای بقیهٔ ایجنتها در دسترس میکنه.
نسخهٔ v3 یه قابلیت مهم اضافه کرده: حالتهای خودمختار (autonomous) و گِیتدار (gated) که بهصورت opt-in هستن، بهعلاوهٔ یه «گِیتِ تکمیل» (completion gate) که ایجنت رو تا وقتی پلن واقعاً تموم نشده نگه میداره. به گفتهٔ نویسنده، این برای اجراهای طولانیِ ایجنت مفیده و راهاندازیهای موجود با آپدیت به v3 هیچ تغییری نمیکنن.
یکی از نقاط قوتش سازگاری گستردهست: به گفتهٔ نویسنده، این اسکیل از راه استاندارد SKILL.md روی بیش از ۶۰ ایجنت نصب میشه و با Claude Code، Cursor، Codex، Gemini CLI و دهها ایجنت دیگه که از مشخصات Agent Skills پشتیبانی میکنن کار میکنه. برای Claude Code هم یه پلاگین داره که دستورهای اتوکاملِ /plan مثل شروع نشست پلنریزی و نمایش وضعیت پیشرفت اضافه میکنه.
مستندات اشاره میکنه که این پروژه ظرف کمتر از ۲۴ ساعت خیلی سریع محبوب شده و جامعهٔ کاربری کلی fork و افزونه روش ساخته؛ از گردشکارهای مصاحبهمحور و پشتیبانی چندپروژهای تا ارکستراسیون چندسطحیِ کار. اسکیل با لایسنس MIT منتشر شده. جانِ کلام اینه که با بیرونکشیدنِ پلن و حالت کار از حافظهٔ فرّارِ ایجنت و نشوندنش روی دیسک، کارهای طولانی و چندمرحلهای بین نشستها و کرشها پایدار میمونن.
نکات کلیدی:
- planning-with-files پلن، یافتهها و پیشرفت ایجنت رو بهصورت فایل روی دیسک نگه میداره
- سه فایل task_plan.md، findings.md و progress.md ایجنت رو در برابر context loss و کرش مقاوم میکنن
- نسخهٔ v3 حالتهای خودمختار/گِیتدار و یه گِیتِ تکمیل اضافه کرده
- روی بیش از ۶۰ ایجنت از راه استاندارد SKILL.md نصب میشه؛ لایسنس MIT
- رویکردش الهامگرفته از Manusه (شرکتی که به گفتهٔ مقاله Meta با ۲ میلیارد دلار خرید)




