این مشکل انضباط نیست

هر تیم مهندسی این مکالمه را داشته: «باید بهتر مستند کنیم.» یک نفر یک سیاست برای ویکی می‌نویسد. همه موافقت می‌کنند. سه ماه بعد ویکی همان چهار صفحهٔ کهنهٔ همیشگی را دارد، و دلیل آن اصلاح پیچیدهٔ احراز هویت در فصل قبل، دقیقاً در ذهن یک نفر زندگی می‌کند.

برداشت معمول این است که تیم بی‌انضباط است. نیست. مستندسازی یک مشکل زمان‌بندی است، نه اراده — و بیشتر تیم‌ها آن را در لحظهٔ اشتباه حل می‌کنند.

نیمه‌عمر «چرا»

درست بعد از تمام کردن یک کار، دقیقاً می‌دانید چرا هر انتخابی را کردید: بده‌بستانی که سنجیدید و رد کردید، محدودیتی که آن راه‌حل زشت را تحمیل کرد، چیزی که ساده به‌نظر می‌رسید ولی نبود. این دانش نیمه‌عمر دارد.

یک روز بعد، «چه کاری» را به یاد دارید ولی بده‌بستان‌ها محو شده‌اند. یک هفته بعد، در بازبینی کد، اگر فشار بیاورند می‌توانید استدلال را بازسازی کنید، ولی زحمت دارد. یک ماه بعد، در جلسهٔ بازنگری که بالاخره کسی می‌پرسد «چرا این‌طور ساخته شده؟» — اصلاً یادتان نیست بده‌بستانی هم بوده. فقط می‌گویید «آن موقع منطقی بود.»

هیچ‌چیز در یک جریان کاری معمولی، همان لحظه که پاسخ هنوز ارزان است، سؤال را نمی‌پرسد.

مستندها واقعاً کجا می‌روند

ناپدید نمی‌شوند — فقط جایی می‌روند که بعداً کسی پیدایشان نمی‌کند:

هرکدام از این‌ها یک ثبت واقعی است. هیچ‌کدام پایدار، قابل‌جستجو یا وصل‌شده به کاری که توضیحش می‌دهد نیست.

دو چیزی که واقعاً جواب می‌دهد

ثبت در همان لحظهٔ کار، نه بعدش. ارزان‌ترین زمان برای ثبت یک تصمیم، پنج دقیقه بعد از گرفتن آن است — نه جلسهٔ بازنگری، نه پستمورتم، نه «هروقت کسی وقت کرد یک صفحهٔ ویکی بنویسد.» هر جریان کاری که مستندسازی را به یک مراسم بعدی موکول می‌کند، آن را به لحظه‌ای موکول می‌کند که دانش از قبل پوسیده است.

نوشتنش را از ننوشتنش ارزان‌تر کنید. یک باکس خالی با عنوان «مستندات را اینجا اضافه کنید» همیشه از ددلاین می‌بازد. یک سؤال مستقیم بله/نه — «می‌خواهی این را بنویسم؟» — درست در لحظهٔ درست پرسیده‌شده، نمی‌بازد.

جایی که یک ایجنت کدنویس هوش مصنوعی معادله را عوض می‌کند

بخش قابل‌توجهی از کد امروز توسط یک ایجنت هوش مصنوعی داخل ویرایشگری مثل کلود کد یا کرسر نوشته می‌شود. آن ایجنت یک تسک را با استدلال کامل هنوز در پنجرهٔ context خودش تمام می‌کند — همان حالت تازه و ارزان‌قیمتِ ثبت که یک توسعه‌دهندهٔ انسانی فقط حدود پنج دقیقه بعد از تحویل دارد.

این همان لحظه‌ای است که ارزش گرفتن دارد. WKFGo روی MCP به این ایجنت‌ها وصل می‌شود و درست بعد از تمام شدن یک تسک، مستقیم از شما می‌پرسد: این کار به‌صورت صفحهٔ ویکی نوشته شود؟ هیچ‌وقت بدون پرسیدن چیزی نمی‌نویسد — سازوکارش را در مستندسازی خودکار با MCP ببینید.

اعتراض‌های رایج

«ما از قبل یک ویکی داریم که کسی ازش استفاده نمی‌کند.» مشکل خود ویکی نیست — نبود محرک برای نوشتن در آن است. ویکی‌ای که هیچ پیشنهادی برای اضافه‌کردن به آن نمی‌رسد، دقیقاً مثل یک ویکی خالی می‌پوسد.

«مستندات به هر حال کهنه می‌شوند.» راهنماهای «چطور X را انجام دهیم» کهنه می‌شوند. یک ثبت تصمیم — «X را به‌جای Y انتخاب کردیم چون Z» — کهنه نمی‌شود، چون یک واقعیت تاریخی است، نه یک دستورالعمل. حتی بعد از تغییر کد اطرافش هم مفید می‌ماند.

«این مشکل فرایند است، نه ابزار.» درست است، ولی ابزار همان چیزی است که باعث می‌شود فرایند از برخورد با ددلاین جان سالم به در ببرد. سیاستی که کسی اجرایش نمی‌کند، فرایند نیست — آرزوست.

سؤالات متداول

مستندسازی باید از آدم باشد یا ایجنت هوش مصنوعی؟

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

مستندات بیشتر همیشه کمک می‌کند؟

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

کوچک‌ترین نسخه‌ی این کار که جواب می‌دهد چیست؟

یک عادت: هروقت تسک یا تصمیمی بسته می‌شود، کسی (یا چیزی) قبل از گم شدن زمینه بپرسد «این باید نوشته شود؟» بقیه فقط پرداخت آن است.

جمع‌بندی

بدهی مستندسازی مشکل انگیزه نیست — پنجره‌ای است که از دست رفته. استدلال را وقتی هنوز در حافظهٔ کاری کسی (یا چیزی) است بگیرید، ویکی خودش را می‌سازد.