جهز الـ coding agent

أعط Claude Code أو Codex أو Cursor كل ما يلزمه لكي ينشر عنك: الـ CLI، والقواعد، والصفحات التي يقرؤها.

كل الصفحات

التجهيز

  1. ثبت الـ CLI وسجل الدخول حيث يعمل الـ agent.

    يستعمل الـ agent تسجيل دخولك.

  2. أضف ملفات الـ agent إلى الـ repo الخاص بك، لكي يقرأ الـ agent هذه القواعد في كل مرة.
  3. دع الـ agent يتعلم كل الأوامر والـ flags من مرجع الـ CLI، أو بنداء واحد في الـ CLI:
    تيرمينال
    ghaym help all --json

قواعد للـ agents

  • سجل الدخول عبر صاحب الحساب. يستعمل الـ CLI تسجيل دخول من يشغله. إذا فشل ghaym whoami، فاطلب منه أن يشغل ghaym login في التيرمينال الخاص به، ولا تطلب منه أبدا أن يلصق مفتاحا في المحادثة.
  • استعمل الـ CLI، لا نداءات API تكتبها بيدك.
  • الـ push يبدأ النشر. الـ push على الـ branch الذي تتابعه الخدمة يبنيها وينشرها. ولا ينجح النشر إلا عندما يقول سجل البناء ذلك.
  • استمع على كل العناوين، وعلى الـ port الذي يحدده غيم. اربط التطبيق على 0.0.0.0 لا على localhost، واقرأ الـ port من PORT. وإلا فلن يصل فحص الجاهزية إلى التطبيق ويفشل النشر.
  • كل تغيير ينتظر حتى يطبق. المتغيرات وإعدادات البناء والحجم والنسخ والتوزيع والوصول تبقى تغييرات مجهزة حتى ghaym cloud changes apply، أو --apply على الأمر الذي جهزها. وتطبيق تغيير على متغير أو على ربط مخزن أو على الـ branch أو على إعداد بناء ينشر الخدمة.
  • جرب التغيير أولا. كل أمر يغير شيئا يأخذ --dry-run، ولا يغير عندها شيئا. أوامر services create وdomains add وsessions rollback تعيد الخطة مع سعرها الشهري التقريبي؛ والباقي يطبع الطلب الذي كان سيرسله.
  • تعتمد الأسعار على الموقع. اقرأها بالأمر ghaym cloud regions sizes <region>.
  • الطلبات المتتالية تبقي الخدمة مستيقظة. الخدمات خارج الـ production تنام عندما لا يصلها شيء، ولا يحسب الـ compute إلا وهي مستيقظة.
  • الترافيك الخارج الذي يتجاوز الكمية الشهرية مدفوع.
  • التسجيل يحتاج إلى شخص. والنشر يفتح بعد أن تعتمد غيم الحساب.

أي أمر لأي مهمة

  • نشر الكود: ghaym cloud projects create، ثم ghaym cloud services create --project <project> --type git --repo <owner/name> --size <size> --site <slug>، ثم push على الـ branch الذي تتابعه الخدمة، كما تقول صفحة انشر أول خدمة. ghaym cloud regions list يعرض المواقع.
  • تجربة تغيير بعيد عن الـ production: ghaym cloud environments create مع branch خاص بها، ثم push على هذا الـ branch.
  • معرفة سبب فشل البناء: ghaym cloud deployments logs <id>، لا نتيجة الـ push.
  • تغيير الإعدادات: ghaym cloud vars set. لا تحفظ في الـ repo ملف إعدادات فيه قيم.
  • انتظار موافقة أحد: الأمر الذي يحتاج إلى موافقة يخرج بالرمز 6 ومعه رقم الموافقة. شغل ghaym cloud approvals wait <id> بدلا من إعادة المحاولة.
  • معرفة ما حدث: ghaym cloud audit list و ghaym cloud sessions list، مع --json.

صفحات يقرؤها الـ agent

  • /docs/errors: صفحة لكل نوع خطأ في الـ API. رابط docs في الخطأ يشير إلى هنا.
  • /docs/verified-prompts: prompts تجهز repo موجودا للنشر.
  • /llms.txt: فهرس موقع غيم بصيغة llms.txt.
  • كل صفحة تحت /docs موجودة أيضا بصيغة Markdown: أضف .md إلى المسار، مثل /docs/agents.md.
  • أضف ?lng=en إلى أي رابط لتحصل على النسخة الإنجليزية. ومن دونه، تظهر الصفحات بالعربية.