architecture
إطار عمل قرارات الهندسة المعمارية
تساعد هذه المهارة الفرق على اتخاذ قرارات هندسة معمارية أفضل من خلال تحليل المفاضلات المنظم وتوثيق ADR. توفر أشجار القرار وإرشادات الأنماط وقوالب لتوثيق خيارات الهندسة المعمارية مع المبررات الخاصة بها.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "architecture". ساعدني في تخطيط الهندسة المعمارية لتطبيق تجارة إلكترونية MVP مع مطور واحد
النتيجة المتوقعة:
لمطور واحد في MVP، أوصي بـ: بنية Monolith مع Next.js، Prisma للوصول إلى البيانات، مصادقة JWT، قاعدة بيانات PostgreSQL، Stripe للمدفوعات. المفاضلات: توسع مستقل محدود، يمكن استخراج الخدمات لاحقاً عند الضرورة.
استخدام "architecture". أنشئ ADR لاختيار PostgreSQL على MongoDB
النتيجة المتوقعة:
قالب ADR: السياق - الحاجة إلى بيانات تعاملات موثوقة. الخيارات التي تم النظر فيها: PostgreSQL (ACID، استعلامات معقدة) مقابل MongoDB (مرن، توسع أفقي). القرار: PostgreSQL. المبرر: التجارة الإلكترونية تتطلب سلامة التعاملات. المفاضلات المقبولة: مخطط أقل مرونة في البداية.
التدقيق الأمني
آمنAll static findings are false positives. The skill is a documentation guide for architectural decision-making. Detected patterns are markdown formatting (backticks), authentication standards (SAML, JWT), and normal decision-making terms (validate). No actual security risks identified.
مشكلات متوسطة المخاطر (1)
مشكلات منخفضة المخاطر (3)
درجة الجودة
ماذا يمكنك بناءه
تخطيط هندسة المشروع الجديد
عند بدء مشروع جديد، استخدم المهارة لتحديد الهندسة المعمارية المناسبة بناءً على حجم الفريق ومتطلبات القياس وقيود الجدول الزمني.
توثيق قرارات الهندسة المعمارية
عند إجراء خيارات معمارية مهمة، استخدم قوالب ADR لتسجيل السياق والخيارات التي تم النظر فيها ومبررات القرار والمفاضلات المقبولة.
إرشاد اختيار النمط
عند عدم التأكد من نمط الهندسة المعمارية الذي يجب استخدامه، استشر أشجار القرار لتقييم المفاضلات بين الخيارات مثل monolith مقابل microservices، أو REST مقابل GraphQL.
جرّب هذه الموجهات
ساعدني في تحديد الهندسة المعمارية لـ [project type] جديد مع [team size] مطورين، تستهدف [user scale] مستخدمين، مع جدول زمني هو [timeline]. الميزانية هي [budget constraint]. استخدم مهارة الهندسة المعمارية لتوجيه هذا القرار.
أنشئ ADR لاختيار [technology/pattern] على البدائل. السياق يتضمن [problem description]. ضع في الاعتبار هذه القيود: [list constraints]. استخدم إطار تحليل المفاضلات من مهارة الهندسة المعمارية.
ساعدني في الاختيار بين بنية microservices و monolith لـ [project description] مع [team size] مطورين. ما هي المفاضلات؟ متى يكون كل نهج مبرراً؟
ما نمط الوصول إلى البيانات الذي توصي به لـ [project type] مع احتياجات وصول بيانات [complexity level]؟ ضع في الاعتبار: حجم الفريق هو [size]، متطلبات الاختبار هي [level]، مصادر البيانات تشمل [sources].
أفضل الممارسات
- ابدأ بأبسط هندسة معمارية تلبي المتطلبات الحالية وأضف التعقيد فقط عند الضرورة المثبتة
- وثق المفاضلات دائماً - كل خيار معماري له تكاليف وفوائد يجب أن تكون صريحة
- استخدم ADRs لتسجيل ليس فقط ما تم تقريره ولكن لماذا، بما في ذلك القيود التي أثرت على الاختيار
- ضع خبرة الفريق في الاعتبار عند اختيار الأنماط - أفضل نمط لا فائدة منه إذا لم يستطع الفريق صيانته
تجنب
- microservices المبكرة جداً - تقسيم الخدمات قبل أن يبرر حجم الفريق أو القياس التعقيد
- التجريد المفرط مع بنية Clean/Hexagonal عندما يكون CRUD بسيطاً كافياً
- اختيار CQRS أو Event Sourcing بدون أدلة على أداء القراءة/الكتابة تظهر الفائدة
- تجاهل المفاضلات - كل خيار معماري له تكاليف يجب الاعتراف بها