تصمیم‌های پروژه کجا باید ثبت بشن؟
هوش مصنوعیخلاصهٔ کامل‌تر
آنتون استن تو این پست می‌گه یکی از مفیدترین تغییرهایی که تو کارش داده ربطی به Figma نداره. مشکل اصلی کمبود مستندات نبود، برعکس بود. Slack، یادداشت جلسه، کامنت‌های دیزاین، تیکت‌ها و یادداشت‌های شخصی همه بودن، ولی فهمیدن اینکه آخرش چی تصمیم گرفته شد هنوز سخت بود.
به گفته‌ی نویسنده، ایجنت‌ها تا حدی کمک می‌کنن چون میشه یه سؤال رو روی کلی منبع پرسید. ولی فقط وقتی جواب می‌ده که ایجنت به منبع‌ها دسترسی داشته باشه و ترتیب زمانی هم معلوم باشه. یه تصمیم بدون تاریخ خطرناکه: شاید دیروز گرفته شده، شاید شش هفته پیش و بعد برگشته، شاید هم فقط یه پیشنهاد بوده که هیچ‌کس قبولش نکرده. جستجو پیدا کردن اطلاعات رو راحت می‌کنه، ولی قابل‌اعتمادش نمی‌کنه.
مدلی که نویسنده بهش رسیده ساده‌ست. Slack برای بحثه، جلسه‌ها جاییه که خیلی چیزها حل میشه و برای ثبتشون از Granola استفاده می‌کنه. داخل پوشه‌ی هر پروژه تو ریپوی شخصیش هم دو فایل داره: running-notes.md و decisions.md. اولی ترتیب زمانی داره و می‌تونه شلوغ باشه: مشاهده‌ها، سؤال‌ها، چیزهایی که امتحان کرده و فکرهایی که هنوز در حال تغییرن. دومی خیلی سخت‌گیرانه‌ست و فقط می‌گه کار به کجا رسید، با جدیدترین تصمیم بالای فایل.
نویسنده می‌گه این جداسازی خیلی کمکش کرده. اگه بخواد بفهمه چطور به یه نقطه رسیدن، سراغ running notes می‌ره و اگه بخواد بدونه الان چی درسته، سراغ decisions. بدون این فرق، هر فکر قدیمی هم‌وزن تصمیم فعلی میشه و ایجنت ممکنه یه جواب کاملاً مستند درباره‌ی چیزی بده که دیگه هیچ‌کس قبولش نداره. یعنی context بیشتر خوبه، ولی context باید ساختار هم داشته باشه.
برای همین تاریخ‌ها مهمن. وقتی یه تصمیم عوض میشه، نویسنده نسخه‌ی قبلی رو پاک نمی‌کنه و تصمیم جدید رو بالاش اضافه می‌کنه. این کار چیزی شبیه version history برای فکرهای محصول می‌سازه. نویسنده معتقده لازم نیست همه دقیقاً همین روش رو پیاده کنن. اصل مهم اینه که هر جا یه وظیفه‌ی مشخص داشته باشه، وگرنه تیم هر تصمیم رو دو بار هزینه می‌ده: یه بار موقع گرفتنش و یه بار شش هفته بعد که کسی یادش نیست.
نکات کلیدی:
- مشکل معمولاً کمبود مستندات نیست، پخش بودن تصمیم‌ها بین ابزارهای مختلفه.
- running-notes.md ترتیب زمانی داره و جای فکرهای ناتمومه.
- decisions.md فقط تصمیم‌های نهایی رو نگه می‌داره، جدیدترین بالا.
- تصمیم قدیمی پاک نمی‌شه و تصمیم جدید بالاش اضافه میشه تا تغییر معلوم باشه.
- ایجنت‌ها با context بیشتر بهتر می‌شن، ولی فقط اگه اون context ساختار و تاریخ داشته باشه.
