Yedhu Krishnan: ليكتب الـ agent الكود ويكتب المطور وصف الـ commit بنفسه
الـ agent يرى ما تغيّر في الكود لكنه لا يرى سبب القرار، فإذا طُلب منه السبب ولّد سببًا معقولًا قد يكون خاطئًا، وسيبني عليه شخص آخر بعد عام.
نشر المطور Yedhu Krishnan في 30 سبتمبر 2026 مقالًا فكرته الأساسية بسيطة: يمكن ترك الـ agent يكتب الكود، لكن وصف الـ commit يجب أن يكتبه المطور بنفسه.
والحجة لا تتعلق بترتيب المستودع. فالـ agent يرى الـ diff، أي التغييرات في الكود، لكنه لا يرى النقاش الذي سبق القرار. لا يعرف مثلًا أن الفريق اختار حلًا أقل جودة لأن الحل الأفضل يحتاج إلى migration ليس هذا وقتها. وحين يُطلب منه ذكر السبب، يكتب سببًا يبدو معقولًا. والسبب المعقول الخاطئ أخطر من ترك الخانة فارغة، لأن شخصًا ما سيبني عليه بعد عام.
والنقطة الثانية في المقال تتعلق بالمراجعة. فالتأكد من أن الكود يفعل فعلًا ما يقوله الوصف مهمة لا يقوم بها إلا الإنسان. وإذا كتب الـ agent الكود والوصف معًا، فلا يكون أي منهما قد راجع الآخر.
أما أكثر أفكار المقال قابلية للتطبيق فهي ما يسميه exit criteria للحلول المؤقتة. فحين يكون الحل مؤقتًا، يكتب المطور جملة تبدأ بعبارة: أفعل هذا إلى أن… وإذا لم يجد للجملة نهاية، فالحل لم يكن مؤقتًا أصلًا.
ويشير المقال إلى أن كتابة هذا السطر تكشف للمطور أحيانًا أنه لم يفهم شيئًا كان واثقًا من فهمه. وبهذا يصبح وصف الـ commit أداة تفكير قبل أن يكون توثيقًا، وتزداد قيمته في الفرق التي يكتب فيها الـ agent جزءًا متزايدًا من الكود.