YallaFlow
1.4.1اضبط المشروع مرة، وبعدها دوس «شغّل» ←

مفتوح المصدر · لـClaude Code وCodex

YallaFlowادّي الذكاء الاصطناعي مشروعك، مش بس طلبك.

YallaFlow بيدّي وكيل البرمجة بتاعك ذاكرة متراجعة للكود بتاعك، وطريقة شغل على قد كل طلب، وأدلة قبل ما أي حاجة تتقال إنها خلصت.

npm install -g yallaflow
  • رخصة MIT
  • على جهازك، من غير تتبّع
  • Node.js ≥ 20.16.0
  • عربي وإنجليزي
رسم توضيحي لجلسة، مش شاشة من YallaFlow.

٧ أسابيع، ٧ إصدارات، وكل تغيير متثبت

  • 7إصدارات عامة على npm
  • 78شغلانة، كل واحدة متابَعة بـYallaFlow نفسه
  • 348عملية تحقّق متسجّلة
  • 1,023اختبار أوتوماتيك على Node 20 و22 و24
  • 30kسطر JavaScript صافي، من غير build
  • 4مكتبات تشغيل بس، ومن غير أي تتبّع

الأرقام محسوبة من المستودع عند v1.4.1، من أول commit يوم ١٩ سبتمبر ٢٠٢٦ لحد 1.4.1 يوم ٨ نوفمبر ٢٠٢٦.

الكونسول

مشاريعك، وطلباتك، والأبلكيشن وهو شغّال، في شاشة واحدة

yallaflow console بيفتح أبلكيشن ويب على جهازك، بالعربي أو الإنجليزي، فاتح أو غامق. اكتب طلباتك بكلامك، وتابع كل طلب لحد ما يخلص متثبت، وشغّل الأبلكيشن بتاعك بزرار واحد. دي شاشات حقيقية.

شغلانة ١٠٠٪: كل المحطات خلصت، واتحقّقت بالدليل V-001، واتسجّلت
«خلص» يعني متثبتكل طلب بيمشي على افهم، وقرّر، ونفّذ، واتحقّق، وافتكر. النسبة YallaFlow بيحسبها من الأدلة، وعمره ما بيقفل شغلانة علشان الوكيل قال إنها خلصت.
شاشة «شغل جديد» وفيها طلب مكتوب بكلام عادي
اكتب الطلب بكلامكاوصفه زي ما بتقوله لزميلك، وارفق صورة أو BRD. مفيش وكيل بيبدأ لوحده.
لوحة الشغل وفيها الشغلانات بمحطاتها وخطوتها الجاية ونسبة الإنجاز
تابع كل طلب وهو ماشيكل شغلانة بتوريك محطاتها، وخطوتها الجاية ومين صاحبها، واللي مستنيك.

شغل حقيقي، مش ديمو

مشروع حقيقي شغّال بـYallaFlow كل يوم

DmagAI هو استوديو الإنتاج بتاع قناة «دماغ AI» على يوتيوب: فيديوهات بالمصري معمولة بـClaude Code وRemotion وffmpeg، والأدوات اللي حواليها. من ٢١ أكتوبر ٢٠٢٦، كل تغيير فيه بيعدّي على YallaFlow. الشاشات دي من المشروع ده، من غير أي تعديل.

  • 64شغلانة في ٣ أسابيع
  • 61خلصت، كل واحدة بدليلها
  • 216عملية تحقّق متسجّلة
  • 238متطلب ومعيار قبول
  • 66حقيقة حالية في ذاكرة المشروع
  • 155commit
DmagAI في كونسول YallaFlow: لوحة التدفق، و61 شغلانة خلصت، و3 مفتوحة، ومفيش ولا واحدة فيها مشكلة
المشروع كله في نظرةكل طلب على محطته من «جديد» لحد «خلص»، ومفيش حاجة بتخلص من غير إثبات.
شغلانة معمارية ١٠٠٪: تصميم ومواصفات وخطة، وتنفيذ، وتحقّق مع مراجعة كود، و24 حقيقة اتحفظت في ذاكرة المشروع
فيتشر واحدة، وكل قرار محفوظتصميم ومواصفات وخطة، والتنفيذ، ومراجعة مستقلة مسكت مشكلة كانت هتوقف الشغل، و24 حقيقة اتحفظت للجلسة الجاية.
لوحة الشغل في DmagAI وفيها الشغل المفتوح بمحطاته ونسبته وخطوته الجاية
الشغل المفتوح، بصراحةكل شغلانة مفتوحة بتقول بالظبط إيه اللي مستني، زي «implementation checkpoint is pending».

متسجّل في جلسات حقيقية

وكيلين، وشغلانة واحدة

Codex كمّل من مكان ما Claude Code وقف

Claude Code بنى المرحلة الأولى من سياسة اعتماد المصروفات، و24 اختبار عدّوا. بعدها Codex خد جملة واحدة بس: Continue the work in progress. قرا سجلات YallaFlow، وبنى الباقي، وخلّص بـ29 اختبار و9 من 9 معايير قبول متحقّقة.

اختبار مابيحسبش غير اللي اشتغل فعلاً

9 من 9 سيناريوهات في المتصفح عدّت

الوكيل خطّط الاختبار من معايير القبول وشغّله في متصفح حقيقي. الـ9 سيناريوهات كلهم عدّوا، ومنهم طلب مزوّر السيرفر رفضه، والوكيل قال بصراحة إيه اللي ماغطّاهوش.

تغيير رأيك آمن

اتفتحت تاني، واتراجع أثرها، وخلصت تاني

بعد المراجعة، شغلانة خلصانة اتفتحت تاني بسبب مكتوب. YallaFlow طلّع تقييم أثر، والمتطلبات اتعدّلت الأول، وبعدها الشغلانة اتحقّقت تاني واتقفلت.

القصص دي من عرض تقني اتسجّل جوه DmagAI (الشغلانة PF-0051)، والأرقام محسوبة من سجلات YallaFlow بتاعة DmagAI نفسه يوم ٨ نوفمبر ٢٠٢٦.

الجديد في 1.4.1

اضبط المشروع مرة واحدة، وبعدها دوس «شغّل» وبس.

تشغيل الأبلكيشن بقى جزء من الكونسول، حتى لو الـDocker stack في فولدر فوق المشروع، ومعاه قاعدة البيانات ومواقع *.localhost.

  1. 1

    اسأل الوكيل المشروع بيشتغل إزاي

    الوكيل بيقرا الإعدادات الحقيقية (Compose، وvhosts، والفولدرات اللي فوق المشروع)، ويقترح الخدمات وترتيب التشغيل والمنافذ والروابط، ومع كل حاجة درجة تأكدها ودليلها. تحقيقه للقراءة بس، وعمره ما بيفتح .env.

  2. 2

    راجع ووثّق، مرة واحدة

    بتشوف بالظبط الأمر والفولدر والملفات اللي التوثيق مربوط بيها، وبعدها بتكتب اسم الخدمة. أي تغيير بعد كده بيلغي التوثيق لحد ما تراجعها تاني.

  3. 3

    ▶ شغّل المشروع

    صفحة الإعداد بتبقى لوحة التشغيل: حالة واحدة، وشغّل ووقّف، والتطبيقات اللي تفتحها، وسطر لكل خدمة بسجلّها. الخدمات بتشتغل بترتيب الاعتماد.

  • مفيش حاجة بتشتغل لوحدها
  • الـstack المشترك عمره ما بيتوقف بالغلط
  • مفيش أسرار في الخطط ولا السجلات
الإعداد: «اسأل الوكيل» مُقترح، وخطة الوكيل فيها خدمتين بدرجة التأكد والدليل
خطة الوكيل، بالأدلةالاقتراح بيوصل مختار جاهز، فحفظه دوسة واحدة. واللي مقدرش يتأكد منه بيتعلّم «مش محسوم».
تشغيل المشروع: المشروع شغّال، وفيه زرار شغّل ووقّف المشروع، وروابط الفتح، وسطر لكل خدمة
صفحة واحدة تشغّله منها«وقّف المشروع» بيوقف بس اللي YallaFlow شغّله، وعمره ما بيوقف stack بتستخدمه مشاريع تانية.

شوف

YallaFlow في ٣٠ ثانية

ليه وكيل البرمجة السريع لسه محتاج سياق مشروعك، وإزاي YallaFlow بينظّم الشغل حواليه. (الفيديو بالإنجليزي.)

  1. 0:00الذكاء الاصطناعي بيكتب كود بسرعة، بس الكود جزء من الشغل وبس.
  2. 0:06المتطلبات والقرارات وقواعد البيزنس بتتوه.
  3. 0:12اتعرّف على YallaFlow: افهم، حدّد، ابني، اتحقّق.
  4. 0:19من المتطلبات للتحقّق، والقرارات متسجّلة.
  5. 0:25مفتوح المصدر ومعمول للمطوّرين.

عايز الشرح كامل، من الإعداد للتسليم؟ شوف الديمو كامل على LinkedIn (بيفتح في تاب جديدة) ٨ دقايق

نظرة متحركة في ٣٠ ثانية. أهم نقطها مكتوبة على الشاشة وفي قايمة الفصول هنا، وبيخلص بمستودع YallaFlow على GitHub.

ليه YallaFlow

السياق اللي ناقص وكيلك

إنت بتوصف المطلوب. YallaFlow بيحفظ الحالة الدايمة حوالين الوكيل، والوكيل بيفكّر ويكتب الكود.

ذاكرة دايمة للمشروع

فهم متراجع للكود بتاعك، بأدلة، وبينبّهك لما الأدلة دي تتغيّر.

شغل على قد الطلب

الباج، والفيتشر، والتحقيق، كل واحد ليه دورة على قد حجمه. الصغير بيفضل خفيف.

تسليم متثبت

مفيش حاجة بتخلص من غير دليل تحقّق جديد، ومتقارن باللي اتطلب.

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

كل جلسة جديدة وكل زميل بيبدأ من الفهم المعتمد واللي اتسجّل من شغل.

بيشتغل إزاي

من الطلب لنتيجة متسجّلة

كل يوم إنت بتكلّم وكيلك. YallaFlow نفسه مابيكلّمش أي موديل ذكاء اصطناعي، ومابيبعتش أي بيانات تتبّع.

  1. جهّز المشروع

    yallaflow init بيربط Claude Code وCodex، وملفات التعليمات الموجودة بتفضل زي ما هي.

  2. اوصف الشغل

    اطلب من وكيلك بكلام عادي. مش محتاج تقول «استخدم YallaFlow».

  3. وافق مرة واحدة المشاريع القايمة

    الوكيل بيرسم خريطة الكود من غير ما يغيّر حاجة، ويوريك لقى إيه وفاته إيه، ويستنى موافقتك Approve.

  4. وجّه وابني

    الطلب بياخد طريقة الشغل المناسبة، من تصليح سريع لخطة متراجعة.

  5. اتحقّق وافتكر

    الدليل الأول. واللي اتعلّم بيبقى معرفة متراجعة للمشروع.

بعد الموافقة الأولى، طلبك الأصلي بيكمل لوحده. اقرا الدليل الكامل (بالإنجليزي).

الإمكانيات

YallaFlow بيغطّي إيه

الأساسيات شغّالة على طول. اللي عليه اختياري بيشتغل بس لما تطلبه.

  • Claude Code وCodex

    ربط رسمي من خلال ملف التعليمات بتاع كل وكيل.

  • التعرّف على المشروع

    فهم أساسي بيعتمده إنسان، وبيقول بصراحة غطّى إيه وحدوده فين.

  • حفظ المعرفة

    الحقايق والقواعد والقرارات ملفات جوه الريبو بتاعك. ذاكرة المشروع

  • متابعة الشغل

    دورات تقدر تكمّلها بعدين، للباجات والفيتشرز والتعديلات وغيرها. طرق الشغل

  • التحقّق والأدلة

    سجل بيتضاف عليه بس، للفحوصات اللي اشتغلت فعلاً.

  • المشاريع المشتركة

    فهم واحد للفريق كله، عن طريق Git العادي. المشاريع المشتركة

  • كونسول بالعربي والإنجليزي

    شغل جديد، والتدفق، وأدلة كل شغلانة، والأرقام، كله في المتصفح. الكونسول

  • شغّل مشروعك

    خدمات بيقترحها الوكيل، وبتوثّقها مرة، وتشغّلها وتوقفها من صفحة واحدة. التشغيل

  • معالج المشروع الجديد

    الفكرة، والتقنية، والبيئة، ومراجعة دقيقة قبل ما أي حاجة تتعمل. مشروع جديد

  • متطلبات من التيكتات اختياري

    استورد تيكت GitHub أو Jira أو Azure DevOps كمصدر محفوظ.

  • اختبار بالذكاء الاصطناعي مع Playwright اختياري

    فحوصات في المتصفح من معايير القبول، ومحدش بيعدّي إلا لو اشتغل فعلاً.

  • ديمو ذكي اختياري

    إنت بتوافق على السيناريوهات قبل أي تسجيل. وهو مش دليل اختبار. التيكتات والاختبار والديمو

التثبيت والترقية

ابدأ في ٣ خطوات

بيشتغل على مشروع جديد أو قايم، ومحتاج Node.js ≥ 20.16.0. سطّبه كأداة، وعمره ما يتسطّب كـdependency في الأبلكيشن بتاعك.

  1. npm install -g yallaflow
  2. yallaflow init
  3. describe the work · اوصف الشغل
  4. yallaflow console

Terminalسطّب مرة، واربط كل مشروع

$ npm install -g yallaflow
$ cd your-project
$ yallaflow init
$ yallaflow console      # optional: open it in your browser · اختياري

بتبدأ من الصفر؟ استخدم كل المشاريع ← مشروع جديد في الكونسول بدل init.

Promptوبعدها اطلب من Claude Code أو Codex

  • صلّح إجماليات الفواتير.
  • ابني منصة استبيان مجهول للموظفين.

دي رسايل لوكيلك، مش أوامر ترمينال.

Upgradeلما تنزل نسخة جديدة، إنت اللي بتقرر إمتى تترقّى

  1. npm install -g yallaflow@latest
  2. yallaflow upgrade status
  3. yallaflow agent refresh
  4. yallaflow doctor
  5. restart the console · أعد تشغيل الكونسول
$ npm install -g yallaflow@latest   # or an exact version: yallaflow@1.4.1
$ yallaflow upgrade status          # read-only: what, if anything, needs attention
$ yallaflow agent refresh           # only if the agent contract is reported outdated
$ yallaflow doctor

YallaFlow عمره ما بيحدّث نفسه. شغلك وذاكرة المشروع والمصادر بتفضل زي ما هي. أعد تشغيل yallaflow console علشان المتصفح يحمّل النسخة الجديدة. التفاصيل (بالإنجليزي)

متبني على المكشوف

YallaFlow متبني بـYallaFlow

كل تغيير في YallaFlow بيعدّي على YallaFlow: شغلانة متوجّهة، ومراحلها، ودليل تحقّق جديد، ومراجعة للمعرفة قبل ما يتقال إنه خلص. والسجلات كلها مفتوحة في فولدر .yallaflow/ في المستودع.

  • 78 شغلانة، من أول إصدار تجريبي لحد 1.4.1
  • 348 عملية تحقّق، بما فيها اللي فشلت، في سجل بيتضاف عليه بس
  • 77 حقيقة حالية في ذاكرة المشروع بتاعه، كل واحدة بدليلها
  • 13 إصدار تجريبي داخلي قبل أول نسخة عامة

تصفّح سجلات الشغل

  1. 1.4.1إعداد المشروع وتشغيله: الوكيل يقترح إزاي يشتغل، وإنت تدوس «شغّل»
  2. 1.4.0مساحة الشغل الهندسي: معالج المشروع الجديد، ونظرة المشروع، ودورة الشغل
  3. 1.3.0مساحة الوكيل: اشتغل مع Codex من الكونسول
  4. 1.2.0كونسول التدفق، وعقد القراءة، وقفل مساحة الشغل
  5. 1.1.0متطلبات من التيكتات، واختبار بالذكاء الاصطناعي، وديمو ذكي
  6. 1.0.1توجيه الشغل الهندسي قبل أول تعديل
  7. 1.0.0أول إصدار عام على npm

اللي عمله

من تطوير محمد عامر

عملت YallaFlow علشان الوكيل السريع من غير سياق المشروع بيسلّم الحاجة الغلط برضه. ومتبني بنفس الطريقة اللي بيطلبها منك: مع وكلاء البرمجة بالذكاء الاصطناعي (Claude Code وCodex)، وYallaFlow ماسك كل تغيير.