ثنائية Plan vs Act: إزاي تخلي الـ Agent يفكر ويخطط قبل ما يلمس أي كود؟

الفرق الجوهري بين شخص بيجرب أدوات الذكاء الاصطناعي بشكل عشوائي وشخص بيبني أنظمة برمجية مستقرة بيعتمد على مبدأ معماري واحد: ثنائية التخطيط والتنفيذ (Plan vs. Act).

أغلب البنائين الجدد لما بيستخدموا أدوات زي Claude Code، Cursor، أو أي AI Agent، بيكتبوا البرومبت ويدوسوا Enter ويسيبوا الـ Agent يعدل في 10 ملفات في نفس اللحظة. النتيجة الحتمية بعد نص ساعة: الـ Codebase اتكسرت، ملفات اتمسحت بالخطأ، والـ Agent دخل في حلقة مفرغة (Hallucination Loop) بيحاول يصلح خطأ بيولد خطأ تاني.

في المقال ده، هنشرح منهجية Plan-Then-Act اللي بتستخدمها الفرق المتقدمة لمنع انهيار المشاريع وضمان جودة الكود.

ليه الـ Agents بتكسر الكود لما بتنفذ فوراً؟

الـ LLM بطبيعته مصمم إنه "يرضي المستخدم فوراً بأسرع رد ممكن". لو طلبت منه: "ضيف ميزة حفظ المقالات في لوحة التحكم"، أول حاجة هيعملها إنه هيكتب كود التعديل في أسرع مكان يلاقيه، حتى لو المكان ده:

1. بيكسر معمارية المشروع الحالية.
2. بيستخدم مكتبات قديمة مش مثبتة عندك في package.json.
3. بيتجاهل قواعد الأمان وصلاحيات قاعدة البيانات.

منهجية Plan-Then-Act في 3 مراحل صارمة

المرحلة الأولى: وضع الخطة (Plan Mode)

في المرحلة دي، الـ Agent ممنوع يكتب أو يعدل أي سطر كود. وظيفته فقط هي:

• قراءة الملفات المرتبطة بالمهمة وفهم السياق بالكامل.
• تحديد نقاط التأثير: إيه الملفات اللي هتتغير؟ إيه الـ Routes اللي هتتأثر؟
• كتابة خطة عمل مرقمة ومحددة خطوة بخطوة، مع ذكر المسارات الدقيقة لكل ملف.

المرحلة الثانية: مراجعة واعتماد الباني (Human Gate)

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

1. هل الخطة دي بتعدل ملفات مالهاش علاقة بالمطلوب؟
2. هل فيه مسار أبسط لحل نفس المشكلة من غير إضافة حزم خارجية معقدة؟
3. هل فيه خطوة اختبار وتحقق واضحة لكل مرحلة؟

المرحلة الثالثة: التنفيذ والاختبار الصارم (Act & Verify)

بعد اعتماد الخطة، الـ Agent بيبدأ ينفذ خطوة واحدة فقط في المرة. بعد كل خطوة:

npx tsc --noEmit && npm test

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

قالب برومبت جاهز لاستخدامه في مشاريعك

الصق التعليمات دي في ملف قواعد الـ Agent عندك (.cursorrules أو AGENTS.md):

"أنت مهندس برمجيات محترف. قبل كتابة أي كود جديد أو تعديل ملف موجود:

1. اقرأ الملفات ذات الصلة أولاً بدون أي تعديل.

2. اكتب خطة عمل دقيقة من خطوات محددة مع ذكر المسارات الدقيقة للملفات.

3. انتظر موافقتي الصريحة على الخطة قبل تعديل أي سطر في الكود.

4. نفذ خطوة واحدة فقط، وتأكد من نجاح Typecheck والاختبارات قبل الانتقال للخطوة التالية."

الخلاصة

الذكاء الاصطناعي بيديك سرعة فائقة في كتابة الكود، لكن النظام والمعمارية والتخطيط هما اللي بيضمنوا إن المشروع يفضل شغال ومستقر ويكبر معاك بكرة وبعد سنة.