AI CodeOps

وكيل ADR Writer

يحول وكيل ADR Writer نموذج التهديدات إلى سجل قرار معماري فيه السياق والقرار والعواقب والبدائل، ويحفظه سجل ADR مقترحا.

وكيل ADR Writer يسجل القرارات. يكتب سجل قرار معماري (ADR) منظما من أربعة أجزاء: السياق (Context) والقرار (Decision) والعواقب (Consequences) والبدائل (Alternatives).

أين يعمل

سير العملالخطوة
Threat ModelRecord ADR

لسير العمل Threat Model ثلاث خطوات. يصف وكيل Architect النطاق وطريقة تدفق البيانات عبر النظام. ثم يجري وكيل Security Auditor عليه تحليل STRIDE: انتحال الهوية، والعبث بالبيانات، والإنكار، وكشف المعلومات، وحجب الخدمة، ورفع الصلاحيات. وبعدهما يسجل وكيل ADR Writer النتيجة قرارا.

المدخلات

  • مهمة الجلسة، مثل «ضع نموذج تهديدات لواجهة webhooks العامة الجديدة».
  • لقطة للقراءة فقط من الملفات ذات الصلة في مستودع المشروع.
  • النطاق وتحليل STRIDE من الخطوتين السابقتين.

المخرجات

سجل ADR نصي، فيه السياق والقرار والعواقب والبدائل.

تحفظه المنصة في سجل القرارات المعمارية لمساحة العمل قرارا بحالة proposed، مربوطا بالجلسة وبخطوة الوكيل، وبالمشروع حين يكون للجلسة مشروع. ويؤخذ عنوانه من أول سطر ذي معنى في السجل. أما الإجابة القصيرة جدا فلا تحفظ، لأنها لا تحسم شيئا.

والحفظ بحالة مقترح مقصود. فالقرار الذي يكتبه الذكاء الاصطناعي يدخل مسار المراجعة نفسه الذي يدخله قرار كتبه شخص، فلا يصادق السجل أبدا على قرار لم ينظر فيه أحد.

مثال على تشغيل

مثال توضيحي، وليس جلسة مسجلة. يشغل Matt سير العمل Threat Model على ميزة webhooks جديدة. يرسم وكيل Architect التدفق: العميل يضبط عنوان URL، والمنصة توقّع الأحداث وترسلها، وخادم العميل يتحقق منها. وينبه وكيل Security Auditor إلى تزوير الطلبات نحو العناوين الداخلية، وإلى إعادة إرسال الأحداث القديمة، وإلى تسرب الأسرار في السجلات. ثم يسجل وكيل ADR Writer القرار: منع نطاقات العناوين الخاصة وجهةً لرسائل webhook، وتوقيع كل حدث مع طابع زمني ورفض الأحداث القديمة، وعدم تسجيل سر التوقيع أبدا. ويذكر العواقب، مثل حاجة العملاء على الشبكات الخاصة إلى وسيط ترحيل، والبديل المرفوض المتمثل في قوائم السماح بعناوين IP. ويظهر سجل ADR في السجل بحالة مقترح.

الحدود

  • قراره لا يكون أفضل من التحليل الذي سبقه. ولا يضيف بحثا أمنيا من عنده.
  • لا يعمل إلا في Threat Model. ويحفظ كل من Architecture Debate و Discovery & Spec أيضا سجلات ADR مقترحة، لكن من التوليف النهائي لوكيل Architect ومن متطلبات وكيل Product Analyst، لا من هذا الوكيل.
  • لا يتحقق من أن القرار نفذ.

الأسئلة الشائعة

هل يقبل سجل ADR الذي يكتبه الوكيل تلقائيا؟

لا. يحفظ بالحالة proposed (مقترح). ويقبله شخص في مساحة العمل أو يرفضه، تماما كسجل ADR مكتوب باليد.

ماذا يحدث إذا شغلت جلسة Threat Model نفسها مرة أخرى؟

معرف سجل ADR مأخوذ من الجلسة، فإعادة تشغيل تلك الجلسة تحدّث سجلها بدل أن تضيف نسخة مكررة.