قرار معماري: تصميمان وناقد وسجل ADR
آخر تحديث
احسم سؤالا في التصميم بسير العمل Architecture Debate: مقترحان من Architect، ونقد من Reviewer، وتوليف نهائي يحفظ سجل ADR مقترحا ينتظر قرار شخص.
استخدم هذا القالب حين يعيد الفريق فتح سؤال التصميم نفسه مرة بعد مرة. فسير العمل Architecture Debate ينتج مقترحين متنافسين، ونقدا لكليهما، وقرارا مكتوبا، قبل أن يبني أحد الشيء نفسه.
الوكلاء الذين يعملون
تعمل الخطوات واحدة تلو الأخرى، وترى كل منها ما سبقها. يقرأ Architect B المقترح الأول، فصغ المهمة على أنها خيار حقيقي («طابور مهام، أم الإبقاء على cron») لا فكرة واحدة يطلب التوسع فيها. ويقرأ الناقد المقترحين كليهما، ويوازن التوليف النهائي بين الثلاثة.
ما تحصل عليه
حين تكتمل الجلسة، يسجل التوليف النهائي سجل قرار معماري بالحالة proposed (مقترح)، مربوطا بالجلسة. ولا يقبل شيء بكلمة الذكاء الاصطناعي: بل يقبله شخص أو يرفضه من Plan → ADRs.
لا يغير سير العمل Architecture Debate أي كود. فتنتهي الجلسة بوثائقها وبالسجل المقترح: لا فروقات، ولا تشغيل اختبار، ولا موافقة لتطبيق تغيير. ولإبقاء القرار في المستودع أيضا، ابدأ جلسة Plan, Build, Review & Test تطلبه ملف Markdown في docs/adr/. ويتبع ذلك التغيير المسار المعتاد: يعمل أمر الاختبار لديك عليه، وتقرأ مراجعة الذكاء الاصطناعي الفروقات وتسجل الملاحظات، ويوافق عليه شخص غير الذي بدأ الجلسة قبل أن يفتح طلب السحب.
حدد سقفا لما تنفقه المناظرة
مع فئة النماذج Auto، يعد Architect خطوة توجيه فيحصل على أفضل فئة لديك حصة فيها، وهذا سير العمل يشغله ثلاث مرات. من Configure → Billing، اضبط ميزانية لمساحة العمل، ثم اختر Edit limits وأعط Architecture Debate حدا خاصا به:
| الحقل | قيمة مثال |
|---|---|
| Period | Monthly |
| Hard limit (USD) | 200 |
| Per-workflow caps (USD) | Architecture Debate: 15 |
يغطي الحد كل جلسات Architecture Debate في الفترة. فمتى بلغ إنفاقها الحد، ترفض الجلسة التالية، وتتوقف الجلسة الجارية مع Blocked by budget. راجع ضوابط التكلفة.
نصائح
- ضع القيود في المهمة: حجم البيانات، ومن يشغل الخدمة في بيئة الإنتاج، وما يجب ألا يتغير.
- اطرح سؤالا واحدا في كل جلسة. فالسؤالان يحصلان على نصفي إجابة.
- إذا كانت النتيجة متقاربة، أرسل طلب متابعة بالنقاط المفتوحة لدى الناقد بدل البدء من جديد.
- بعد قبول القرار، حدد نطاق العمل باستخدام قالب مواصفة الميزة.
الأسئلة الشائعة
هل يعمل المعماريان في الوقت نفسه؟
لا. يعمل Architect B بعد Architect A ويقرأ مقترحه. فكلمة «المناظرة» تصف طريقة تقسيم الخطوات للعمل، لا توقيتها.
هل يقبل سجل ADR تلقائيا؟
لا. يحفظ بالحالة proposed (مقترح). وينقله شخص إلى accepted أو rejected من Plan, ADRs.
هل ستغير الجلسة كود تطبيقي؟
لا. سير العمل Architecture Debate يكتب وثائق فقط. وتنتهي الجلسة بسجل القرار، دون فروقات ودون طلب سحب.