الدرس 9. الأتمتة ما بعد الكود — Agent Operable System

نصائح ذهبية — هذا كل ما تحتاج معرفته

الكود ليس كل شيء. لتفويض البناء والنشر والمراقبة للوكيل، يجب أن يكون النظام كله مقروءاً للوكيل.

للوكيل: “أضف endpoint /health للخادم. يرجع حالة اتصال DB، نسبة الأخطاء، ووقت التشغيل بـ JSON.”

هذا يعطي الوكيل عيوناً لقراءة حالة النظام آلياً. /health موجود = الوكيل يتحقق آلياً “هل الخادم حي؟”

للوكيل: “أنشئ docker-compose.yml لهذا المشروع. خادم التطبيق وDB يجب أن يكونا فيه. docker compose up يشغّل الكل.”

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

للوكيل: “اضبط التراجع التلقائي عند فشل النشر. إذا فشل /health ارجع للنسخة السابقة.”

الوكيل يخطئ حتماً. يجب أن يمكن التراجع عن أخطائه. هذه العبارة هي شبكة الأمان.

4 شروط لـ Agent Operable System

1. Observability — كل حالة مرصودة آلياً (/health, سجلات JSON)
2. Declarative — كل سلوك معرّف إعلانياً (Docker Compose, Terraform, Makefile)
3. Reversible — كل تغيير قابل للتراجع (git revert, صورة سابقة, migration down)
4. Human-in-the-loop — بوابات موافقة صريحة (نشر الإنتاج = موافقة بشرية)

خط أنابيب كامل: من “أضف ميزة” إلى النشر

1. تحرير SSOT
2. yongol validate → 0 errors
3. yongol generate → كود
4. go test + Hurl → PASS
5. docker build → نجاح
6. نشر staging → /health → سليم
7. نشر إنتاج (بوابة موافقة) → /health → سليم
8. مراقبة. تراجع تلقائي عند مشكلة.

ما فعله الإنسان: “أضف ميزة” + “موافقة” مرتين. الوكيل فعل الباقي.

مقالات ذات صلة

• Reins Engineering — ذكاء اصطناعي بلجام
• yongol — عارضة AI للبرمجة كخدمة

سلسلة دروس Reins Engineering الكاملة