BMAD Method: المرجع الكامل لبناء المشاريع مع وكلاء الذكاء الاصطناعي

المستوى: متوسط–متقدم · وقت القراءة: ~10 دقائق

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

هذا المقال ليس تعريفاً سريعاً فقط، بل مرجع عملي كامل يشرح BMAD من الداخل: فلسفته، مراحله، مساراته، وكلاءه، أهم أدواته، وكيف تبدأ به سواء كنت تبني مشروعاً جديداً أو تدخل على مشروع قائم.

BMAD = Breakthrough Method for Agile AI-Driven Development
الاسم الآخر: Build More Architect Dreams

• الموقع الرسمي: docs.bmad-method.org
• GitHub: bmad-code-org/BMAD-METHOD

أولاً: ما الذي يجعل BMAD مختلفاً؟

الفكرة الجوهرية في BMAD بسيطة، لكنها عميقة الأثر:

• الذكاء الاصطناعي يعمل أفضل عندما يتلقى سياقاً منظماً وواضحاً
• المشروع لا يُدار عبر محادثة فوضوية واحدة، بل عبر مراحل مترابطة
• كل مرحلة تنتج وثائق ومخرجات تغذي المرحلة التالية
• النظام يتكيف مع حجم المشروع، فلا يفرض نفس العمق على bug صغير وعلى منصة كبيرة
• علاقتك مع الـ AI هنا ليست علاقة أوامر لحظية فقط، بل تيسير وتنسيق بين أدوار متعددة

بكلمات أخرى، BMAD لا يحاول جعل الـ AI أكثر ذكاءً بالسحر، بل يجعله أكثر فاعلية عبر الهيكلة.

ثانياً: المراحل الأربع في BMAD

يمر العمل في BMAD عبر أربع مراحل رئيسية:

1) Analysis — التحليل

هذه مرحلة استكشافية. لا تحتاجها دائماً، لكنها مفيدة عندما تكون الفكرة ضبابية، أو عندما تريد التحقق من السوق، أو دراسة المجال، أو اختبار فرضية قبل الالتزام.

2) Planning — التخطيط

هذه هي المرحلة التي لا ينبغي تجاوزها. هنا تتحدد المتطلبات، والنطاق، وما الذي سيُبنى فعلاً.

3) Solutioning — الحل التقني

بعد أن تعرف ماذا تريد، تنتقل إلى كيف ستبنيه: architecture، وتقسيم epics وstories، وفحص الجاهزية قبل التنفيذ.

4) Implementation — التنفيذ

في هذه المرحلة يتحول كل ما سبق إلى قصص قابلة للتنفيذ، ثم كود، ثم مراجعة، ثم تتبع للتقدم.

ثالثاً: مسارات المشروع، متى تختار كل Track؟

BMAD لا يعامل كل المشاريع بنفس الطريقة، بل يقدم أكثر من مسار:

مهم: أرقام الـ stories هنا إرشادية فقط. لا تحسبها رياضياً، بل اختر المسار بناءً على مقدار التخطيط والتنسيق الذي يحتاجه مشروعك.

القاعدة الذهبية

ابدأ محادثة جديدة لكل workflow.
هذا ليس تفصيلاً شكلياً، بل جزء أساسي من الطريقة، لأنه يمنع تلوث السياق وتجاوز حدود الـ context window.

رابعاً: كيف يبدو هيكل المشروع بعد التثبيت؟

بعد تثبيت BMAD، غالباً سيظهر لديك هيكل قريب من هذا:

project/
├── _bmad/                  ← agents, workflows, tasks, config
├── _bmad-output/           ← المخرجات: PRD, Architecture, Stories...
│   ├── planning-artifacts/
│   └── implementation-artifacts/
├── docs/                   ← توثيق المشروع
└── .claude/skills/         ← Skills على Claude Code
    ├── bmad-help/
    ├── bmad-create-prd/
    └── ...

• على Cursor: .cursor/skills/
• على Windsurf: .windsurf/skills/

هذا التنظيم مهم، لأنه يفصل بين:

• المنهج نفسه
• مخرجات العمل
• التوثيق
• المهارات أو الـ skills المرتبطة ببيئة التطوير

خامساً: الوكلاء الافتراضيون، من يفعل ماذا؟

أحد أجمل أجزاء BMAD هو أنه لا يحمّل الوكلاء شخصية عامة، بل يوزع عليهم أدواراً محددة:

الفكرة هنا ليست تجميلية. عندما تعطي كل وكيل دوراً ضيقاً وواضحاً، تقل الهلوسة، وتزيد الجودة، وتصبح المخرجات أكثر اتساقاً.

سادساً: الـ Triggers داخل جلسات الوكلاء

بعض الوكلاء لديهم اختصارات سريعة تؤدي إلى وظائف محددة داخل الجلسة نفسها:

هذه الـ triggers تجعل استخدام النظام أسرع، خصوصاً عندما تعمل على نفس المشروع لفترة طويلة.

سابعاً: Workflow Skills حسب المراحل

المرحلة 1: Analysis

هذه المرحلة اختيارية، لكنها قوية جداً حين تكون الرؤية غير ناضجة تماماً.

المرحلة 2: Planning

هنا يتحول التصور إلى متطلبات واضحة.

المرحلة 3: Solutioning

هنا تتشكل الصورة التقنية الفعلية.

لماذا تأتي Stories بعد Architecture؟ لأن قرارات قاعدة البيانات، والـ APIs، والـ tech stack تؤثر مباشرة على كيفية تقسيم العمل.

المرحلة 4: Implementation

بعد كل التخطيط، هنا يبدأ التنفيذ الحقيقي.

ثامناً: ماذا عن المشاريع الموجودة أصلاً؟

ليس كل مشروع يبدأ من الصفر. أحياناً تدخل على codebase قائم، وهنا يقدم BMAD مسارات مخصصة:

وهذه نقطة مهمة جداً:
إذا كان المشروع موجوداً بالفعل، فمن الخطأ أن تبدأ التنفيذ قبل أن تفهم أنماطه الحالية. وإلا سيخترع الـ AI اتفاقيات جديدة لا تناسب الكود القائم.

تاسعاً: أهم الأدوات الأساسية في BMAD

bmad-help

هذه الأداة هي قلب التجربة تقريباً.

وظيفتها:

• تفحص المشروع
• ترى ما الذي أُنجز
• تقترح الخطوة التالية
• تساعدك على معرفة ما هو إلزامي وما هو اختياري

أمثلة:

bmad-help
bmad-help I just finished architecture, what's next?
bmad-help أي track يناسب مشروعي؟
bmad-help show me what workflows are available

أدوات أساسية أخرى تستحق الانتباه

• bmad-party-mode لتجميع عدة وكلاء في جلسة واحدة عند القرارات الكبيرة
• bmad-advanced-elicitation لتحسين المخرجات بأساليب تفكير تكرارية
• bmad-distillator لضغط الوثائق الكبيرة إلى نسخة token-efficient
• bmad-review-adversarial-general لمراجعة ناقدة تكشف الثغرات
• bmad-review-edge-case-hunter لاصطياد الحالات الطرفية والطرق غير المغطاة
• bmad-editorial-review-prose لتحسين اللغة والوضوح
• bmad-editorial-review-structure لإعادة بناء وثيقة طويلة أو متشعبة
• bmad-shard-doc لتقسيم ملفات markdown الضخمة
• bmad-index-docs لتوليد فهرس منظّم للوثائق

عاشراً: دليل سريع لمشروع جديد

إذا كنت تبدأ من الصفر، فهذه أفضل خريطة مختصرة:

# 0. التثبيت
npx bmad-method install
 
# 1. البداية
bmad-help
 
# 2. Analysis (اختياري)
bmad-prfaq
bmad-product-brief
bmad-brainstorming
 
# 3. Planning
bmad-create-prd
bmad-create-ux-design
 
# 4. Solutioning
bmad-create-architecture
bmad-create-epics-and-stories
bmad-check-implementation-readiness
 
# 5. Implementation
bmad-sprint-planning
bmad-create-story
bmad-dev-story
bmad-code-review
bmad-sprint-status
bmad-retrospective

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

الحادي عشر: دليل سريع لمشروع موجود

أما إذا كنت تعمل على مشروع قائم، فهذه نقطة البداية الأنسب:

# 1. نظّف الـ artifacts القديمة من docs/ و _bmad-output/
 
# 2. افهم المشروع الحالي
bmad-generate-project-context
 
# 3. وثّق الوضع القائم
bmad-document-project
 
# 4. اختر نهجك
# تغيير صغير
bmad-quick-dev
 
# تغيير كبير
bmad-create-prd
bmad-create-architecture
bmad-create-epics-and-stories
bmad-dev-story

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

الثاني عشر: نصائح احترافية لاستخدام BMAD بذكاء

1) ابدأ دائماً بـ bmad-help

لأنها الأداة التي تعطيك الصورة الحالية للمشروع، وتقلل التخمين.

2) خصص chat جديد لكل workflow

هذا يحافظ على نقاء السياق ويقلل التلوث بين المراحل.

3) لا تتجاوز مرحلة التخطيط

كل دقيقة تستثمرها في PRD توفر وقتاً مضاعفاً لاحقاً في debugging وإعادة البناء.

4) راجع قبل أن تنفذ

استخدم bmad-review-adversarial-general على PRD والـ Architecture قبل دخول التنفيذ.

5) اضغط الوثائق الطويلة عند الحاجة

إذا صارت الوثيقة أكبر من أن تُستهلك بكفاءة، استخدم bmad-distillator.

6) في المشاريع القائمة، افهم الكود أولاً

ابدأ بـ bmad-generate-project-context حتى لا يفرض الـ AI conventions جديدة على مشروع قديم.

7) إذا أضفت module جديداً، أعد التثبيت

بعض الـ skills تُولّد من الـ modules، لذا قد تحتاج إلى إعادة تشغيل:

npx bmad-method install

الثالث عشر: الـ Modules الرسمية

هذه الـ modules توسّع BMAD من مجرد workflow framework إلى نظام عمل متكامل يمكن تخصيصه حسب طبيعة الفريق والمشروع.

الخلاصة

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

قيمته الحقيقية تظهر عندما تتوقف عن سؤال الوكيل: "اكتب لي شيئاً سريعاً"، وتبدأ في بناء سلسلة عمل منظمة، حيث:

• كل مرحلة لها غرض واضح
• كل وكيل له دور واضح
• كل وثيقة تُستخدم كمدخل للمرحلة التالية
• وكل قرار يقلل الفوضى بدلاً من أن يضاعفها

إذا كنت تريد أن تتعامل مع الـ AI كأداة إنتاج هندسي لا كمولد نصوص فقط، فـ BMAD Method من أكثر الأطر نضجاً ووضوحاً في هذا الاتجاه.

مصادر مفيدة

• الوثائق الرسمية
• Workflow Map التفصيلي
• قناة YouTube
• Discord المجتمع
• GitHub
• ملف LLM-optimized للوثائق كاملة

عبدالكريم العنزي — Astral