- سجل قرار معماري (ADR) هو وثيقة تسجل قرارات التصميم. يكتب المؤلف أن سجلات ADR التي أُوكلت إلى الذكاء الاصطناعي بدأت مع مرور الوقت تفقد انتظام بنية أقسامها، وأن نص القرارات صار يتضمن تفاصيل برمجية مثل قوائم قوائم الشاشات والثوابت.
- يقترح المؤلف فحص القواعد البنيوية التي يمكن للآلة التحقق منها، مثل ترتيب الأقسام وقيم Status والمراجع بين سجلات ADR ووجود الملفات المرتبطة، بملف سياسات يُفشل CI عند المخالفة. أما القواعد الدلالية، مثل ما إذا كانت الوثيقة مكتوبة بأسلوب المواصفات، فيحكم عليها نموذج لغوي كبير ولا تُترك إلا تحذيرات في طلب الدمج (PR).
- regomark أداة سطر أوامر أنشأها المؤلف. تحلل Markdown وتفحص القواعد باستخدام OPA (أداة تقييم السياسات). ويذكر المؤلف أنه لا يوجد تطبيق خاص بسجلات ADR، وأن القواعد توضع في ملف السياسات الخاص بالمستودع الذي يستخدمها.
- عند إعادة قراءة 7 من مستودعاته، يذكر المؤلف أن كل ما اختلف عن الشيفرة كان تفاصيل لم يكن لازمًا أن تُكتب في سجل ADR، وأن القرارات والضمانات التي يجب الحفاظ عليها لم تصبح قديمة. وهذه ملاحظة من المؤلف وحده.
O: يصلح هذا لمشهد يريد فيه مطوّر أن يترك مراجعة ADR للذكاء الاصطناعي وأن يلتقط تلقائيًا اختلافات الشكل في كل PR، فيضع سياسة .regomark/policy في مستودع واحد ويشغّل regomark check في CI.
X: يذكر الكاتب صراحةً أن الفحص الدلالي يُقيَّم بواسطة LLM، لذا قد يعطي ADR نفسه نتائج مختلفة في كل تشغيل. قبل تحديد مدى الثقة في التحذيرات، يلزم التحقق من ذلك.