أحياناً تعرف بالضبط ما تريد.

لا تحتاج شيئاً يكتشف المهام — تحتاج شيئاً يُنجزها.

هذا ما بُني له /arib-build.


الفكرة بجملة واحدة

أعطه هدفاً محدداً — يُحدّد أصغر وضع تنفيذ مناسب، يُفكّك، يوزّع على المتخصصين، يجمع، ويُمرّر بوابة الدمج.

size goal → choose mode → decompose → dispatch → integrate → reconcile → merge gate

الجديد: ثلاثة أوضاع للتنفيذ

أهم ما جاء في v3.16.0 — الأداة لا تعمل بطريقة واحدة. تختار أصغر آلية تُناسب الهدف:

الهدفالوضعما يحدث
تغيير محدود، بضعة متخصصين، جولة واحدةInline (الافتراضي)Task(engineer-manager) مباشرة
واسع / متوازٍ / يحتاج تحقق مكثّفWorkflowالأداة تُطلق Workflow — pipeline بتزامن محدود
حملة لا تنتهي في جولة واحدة/loopجولة لكل وحدة، تُغلق لما يجف الـ backlog

المبدأ: اصعد فقط إذا احتجت. لا Workflow لتعديل ملف واحد. لا /loop لهدف ينتهي في دقيقتين.


الحلقة الداخلية (الـ engineer-manager)

بعد اختيار الوضع، يأخذ engineer-manager زمام الأمور:

┌─────────────────────────────────────────────────┐
│                 /arib-build <goal>               │
│                                                 │
│  0. SIZE GOAL  → يختار الوضع المناسب            │
│       ↓                                         │
│  1. DECOMPOSE  → يُفكّك + يبني task graph        │
│       ↓                                         │
│  2. DISPATCH   → متخصصون بالتوازي (حيث آمن)    │
│    Architect  Reviewer  Tester  Security…       │
│       ↓                                         │
│  3. INTEGRATE  → يجمع كل المخرجات              │
│       ↓                                         │
│  4. RECONCILE  → verification-agent يتحقق       │
│       ↓                                         │
│  5. MERGE GATE → الدمج أو HOLD للإنسان          │
└─────────────────────────────────────────────────┘

أمثلة عملية

# Inline — هدف محدود، جولة واحدة
/arib-build add a soft-delete flag to the Patient entity
# architect + planner ▶ database-guardian ▶ implement
# ▶ code-reviewer + security-auditor + test-engineer ▶ RECONCILED
# migration = high-stakes → HOLD for human merge

# Workflow — هدف واسع، يتوازى
/arib-build migrate all 40 controllers to the new auth guard
# → decompose → 40 وحدات → LAUNCH Workflow: pipeline(units, migrate, verify)
# كل وحدة: verification-agent → auto-merge أو HOLD

# /loop — حملة مستمرة
/loop /arib-build harden every money-math path in the billing module
# كل جولة: path واحد → build → reconcile → (auto/HOLD) → re-arm
# تتوقف لما يجف الـ backlog

بوابة الدمج — لا تتغير بالوضع

الوضع يُغيّر “كيف” تُوزَّع المهام — لا “من” يأذن بالدمج.

في كل الأوضاع الثلاثة، الدمج إلى main يستوجب:

  • CI أخضر
  • verification-agent يرجع RECONCILED
  • الفئات الحساسة (مال، مصادقة، migration، أسرار) → HOLD للإنسان دائماً

زيادة النطاق لا تُزيد الصلاحية.


Stack Skills — تخصصات تُزرع في كل هدف

/arib-build الافتراضي لا يمتد لأي skill آخر. لكن لما الهدف يحتاج تخصصاً عميقاً، Stack Skills جاهزة:

Skillما يُضيفه للبيلد
/arib-nestjsمعمار صحيح للـ modules، DTOs، Guards — يُراجع كل ما لمسه المتخصصون
/arib-postgresmigrations آمنة، queries مُحسَّنة، N+1 ممسوك قبل الدمج
# بيلد عادي
/arib-build add JWT refresh token flow

# بيلد + مراجعة NestJS صريحة
/arib-build add JWT refresh token flow
/arib-nestjs review apps/api/src/modules/auth   # ← بعد البيلد

الفلسفة: يُضاف Stack Skill حين يُحدّد المهندس إنه محتاج — لا يُطلق تلقائياً.


الربط مع /arib-wave-plan (v3.17)

لما الهدف كبير ومُعقّد، /arib-wave-plan يُقفل المتطلبات قبل إطلاق البيلد:

# أولاً: اقفل ما تريد بالضبط
/arib-wave-plan "redesign the checkout flow"
# يُنتج waves/<id>/PLAN.md → قفل المتطلبات

# ثم: نفّذ على الخطة المقفولة
/arib-build @waves/<id>/PLAN.md

تفيد حين لا تريد الـ decomposition تُعيد تفسير الهدف في كل جولة.


المقارنة مع /arib-engine

هما أخوان — لا بديلان:

/arib-engine/arib-build
نقطة البدايةمشكلة مفتوحةهدف محدّد
يكتشف العمل؟✅ adversarial find→refute→confirm❌ أنت تُحدّده
أوضاع التنفيذمع /loop دائماًInline / Workflow / /loop
“هل انتهينا؟”الدليل يُقرّرالهدف يُقرّر
المناسب لـحملة مفتوحة / اكتشافتسليم هندسي محدّد

الجمع بينهما:

/loop /arib-engine discover    ← يكتشف الأهداف
/arib-build <كل هدف>          ← يُنجز كل هدف بالتوازي

متى تختار أيهما؟

استخدم /arib-build حين:

  • الهدف واضح ومحدّد
  • عندك مواصفات جاهزة للتنفيذ
  • تريد تسليماً سريعاً ومُتحقَّقاً منه

استخدم /arib-engine حين:

  • المشكلة مفتوحة (“صلّح ما يحتاج تصليح”)
  • تحتاج من يكتشف الأولويات بنفسه
  • تريد حملة مستمرة

المصدر

جزء من CCM v3.18.0 “Compression & Lean”:

claude-code-methodology.claude/skills/arib-build/SKILL.md


آخر تحديث: يونيو 2026 | CCM v3.18.0