إجراء التشغيل القياسي: ترميز المعرفة غير المرئية في المستودع

استخدم هذا الإجراء عندما لا تزال هناك معلومات سياقية مهمة في مستندات Google أو سلاسل المحادثات أو التذاكر أو عقول الأشخاص.

الهدف

جعل المعرفة غير المرئية للوكلاء قابلة للاكتشاف في قاعدة الكود حتى تتمكن الجلسة الجديدة من التصرف بناءً عليها دون الاعتماد على محادثة سابقة.

إشارات المحفز

• يستمر الوكيل في السؤال عن كيفية عمل النظام.
• يقول البشر "قررنا هذا في Slack" أو "اتبع ما قاله فلان الأسبوع الماضي."
• تشير المراجعات إلى قواعد منتج أو أمان غير مكتوبة في المستودع.
• الجلسات الجديدة تكرر عمل الاكتشاف الذي يجب أن يكون مستقرًا بالفعل.

إجراء التشغيل القياسي للتنفيذ

1. اذكر مصادر المعرفة غير المرئية: المستندات، المحادثات، قواعد الفريق الضمنية، القرارات الشفهية.
2. لكل مصدر، اسأل: هل هذه بنية أم سلوك منتج أم سياسة أمان أم توقع موثوقية أم سياق خطة أم مادة مرجعية؟
3. رمِّزها في منتج المستودع المطابق:
   • البنية -> ARCHITECTURE.md
   • سلوك المنتج -> docs/product-specs/
   • منطق التصميم -> docs/design-docs/
   • حالة التنفيذ -> docs/exec-plans/
   • المراجع الخارجية المتكررة -> docs/references/
   • توقعات الجودة أو الموثوقية -> docs/QUALITY_SCORE.md أو docs/RELIABILITY.md
4. استبدل العبارات الغامضة بصياغة مفيدة تشغيليًا.
5. أزل أو أهمل النسخ القديمة حتى يحتفظ المستودع بحقيقة واحدة قابلة للاكتشاف.

قواعد الترميز الجيد

• اكتب من أجل قابلية الاكتشاف، وليس من أجل الاكتمال الأدبي.
• فضِّل المستندات القصيرة بأسماء ملفات واضحة.
• اربط المنتجات ذات الصلة ببعضها.
• خزِّن القواعد الدائمة، وليس نصوص الاجتماعات.
• حدِّث المستودع في نفس الجلسة التي يُتخذ فيها القرار.

تعريف الإنجاز

• يمكن لوكيل جديد اكتشاف القاعدة ذات الصلة دون سؤال بشري.
• نفس الحقيقة غير مبعثرة عبر ملفات متعددة متناقضة.
• المنتج الجديد يعيش بالقرب من الكود أو سير العمل الذي يحكمه.