/arib-build بسيط في ظاهره — أعطه هدفاً، يُنجزه.
لكن الفرق بين هدف محكم وهدف فضفاض هو الفرق بين تسليم في دقائق وعمل يحتاج مراجعة.

هذا الدليل يُريك كيف تكتب الأمر — لا ماذا يفعل من الداخل.


صيغة الأمر

/arib-build <وصف الهدف>

اكتب الهدف كأنك تُكلّف مهندساً أول يعرف الكود:

  • ماذا تريد — لا كيف يُنفَّذ
  • الـ scope واضح — لا “صلّح كل شي”
  • النتيجة المتوقعة — لا العملية

أمثلة حقيقية — إنجليزي

مهام محددة (Inline)

/arib-build add soft-delete to the User entity
/arib-build add rate limiting to the /auth/login endpoint — 5 attempts per minute per IP
/arib-build replace all console.log calls in the payments module with the Logger service
/arib-build add input validation DTOs to the reservations controller
/arib-build write unit tests for the PricingService — cover edge cases for zero-night stays

مهام متوسطة (Workflow)

/arib-build migrate all API responses to use a unified ResponseDto wrapper
/arib-build add Redis caching to all GET endpoints in the RoomsModule
/arib-build enforce role-based guards across every controller in the HotelOS API

حملة مستمرة (مع /loop)

/loop /arib-build harden every money-math path in the billing module
/loop /arib-build add missing indexes to the top 10 slow queries in the reservation flow

أمثلة حقيقية — عربي

مهام محددة

/arib-build أضف حقل soft-delete لجدول المستخدمين مع migration آمنة
/arib-build ضع rate limiting على endpoint تسجيل الدخول — 5 محاولات في الدقيقة لكل IP
/arib-build استبدل كل console.log في موديول المدفوعات بـ Logger service
/arib-build أضف DTOs للـ validation على كل endpoints الحجوزات
/arib-build اكتب unit tests لـ PricingService مع تغطية حالات الإقامة صفر ليالي

مهام متوسطة

/arib-build حوّل كل responses في الـ API لـ ResponseDto موحّد
/arib-build أضف Redis caching لكل GET endpoints في RoomsModule
/arib-build فرض role-based guards على كل controllers في الـ API

مع /loop

/loop /arib-build صلّح كل عمليات الحساب المالي في موديول الفواتير

كيف تكتب هدفاً جيداً

❌ هدف ضعيف✅ هدف محكم
fix the authadd refresh token rotation to the JWT auth flow
improve performanceadd Redis cache to the rooms availability query — TTL 5 min
add testswrite integration tests for the check-in flow — cover overbooking and invalid dates
clean the codereplace magic numbers in the pricing module with named constants
صلّح المشاكلأصلح الـ N+1 في استعلام قائمة الحجوزات في ReservationsService

القاعدة: لو قرأ مهندس آخر الأمر وسأل “بس؟ خلاص؟” — الهدف واضح. لو سأل “تقصد إيش بالضبط؟” — اكتب أكثر.


الجمع مع Stack Skills

/arib-build ينجز العمل. Stack Skills تتحقق من جودته — opt-in دائماً، أنت من يُقرر متى.

مع /arib-nestjs

بعد أي بيلد يمس الـ architecture:

# أولاً: البيلد
/arib-build add a NotificationsModule with email and SMS providers

# ثانياً: مراجعة المعمار
/arib-nestjs review apps/api/src/modules/notifications
# إنجليزي
/arib-build implement the BookingService with full CRUD and event emission
/arib-nestjs review apps/api/src/modules/bookings

# عربي
/arib-build بنّي BookingService مع CRUD كامل وإرسال events
/arib-nestjs review apps/api/src/modules/bookings

/arib-nestjs يتحقق من: هل الـ DI صحيح؟ هل الـ DTOs مكتملة؟ هل في ثغرات أمنية في الـ guards؟

مع /arib-postgres

بعد أي بيلد يمس قاعدة البيانات:

# إنجليزي
/arib-build add full-text search to the guest lookup endpoint
/arib-postgres review    # تحقق من الـ indexes والـ query plan

# عربي
/arib-build أضف full-text search لبحث النزلاء
/arib-postgres review
# مع تحديد
/arib-build add a reports dashboard query for monthly revenue by room type
/arib-postgres index     # اقترح indexes مناسبة للـ query الجديد

/arib-postgres يكشف: هل في N+1؟ هل الـ migration تُقفل جداول؟ هل الـ index في مكانه الصحيح؟

مع الاثنين

# بيلد كبير يمس الكود والقاعدة
/arib-build add a housekeeping task assignment system with real-time status tracking

# مراجعة طبقة المعمار
/arib-nestjs review apps/api/src/modules/housekeeping

# مراجعة طبقة البيانات
/arib-postgres review
/arib-postgres index

الجمع مع /arib-engine

/loop /arib-engine discover missing features    ← يكتشف ما يحتاج بناء
/arib-build <كل هدف يكتشفه>                  ← يُنجز كل هدف

/arib-engine يُجيب على “ماذا نبني؟” — /arib-build يُجيب على “كيف نبنيه؟”


الجمع مع /arib-wave-plan

لما الهدف كبير وتريد تقفل المتطلبات قبل التنفيذ:

# أولاً: ضع الخطة
/arib-wave-plan "redesign the multi-property billing system"
# → ينتج waves/<id>/PLAN.md

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

يُجنّبك أن يُعيد /arib-build تفسير الهدف في كل جولة.


سيناريوهات متكاملة

سيناريو ١: إضافة feature جديدة

# ١. البيلد
/arib-build add a guest loyalty points system — earn on checkout, redeem on booking

# ٢. مراجعة المعمار
/arib-nestjs review apps/api/src/modules/loyalty

# ٣. مراجعة قاعدة البيانات
/arib-postgres review

سيناريو ٢: تحسين أداء

# ١. اكتشف الأبطأ
/arib-engine find the top 5 performance bottlenecks in the reservations flow

# ٢. صلّح كل واحد
/arib-build optimize the availability check query — currently scanning 2M rows
/arib-postgres index    # تأكد من الـ indexes

سيناريو ٣: تأمين API موجود

# ١. البيلد
/arib-build add API key authentication to all public-facing endpoints

# ٢. مراجعة أمنية
/arib-nestjs review apps/api/src/modules/auth

# ٣. loop للتأكد من التغطية الكاملة
/loop /arib-build verify every endpoint in the API has the correct guard applied

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

في كل الأوامر السابقة، الدمج إلى main يستوجب:

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

زيادة تفاصيل الأمر لا تتجاوز البوابة — هي ثابتة بغض النظر عن الهدف.


المصدر

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

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


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