دليل · موارد GAOBA AI

7 قواعد تحمي مشروعك مع AI Agents

دليل عملي بالعربية: 7 قواعد تحمي مشروعك عندما يعدّل وكيل الذكاء الاصطناعي ملفاتك، ومع كل قاعدة أمر جاهز تنسخه وتلصقه في Claude Code أو Cursor.

فتح ملف PDFتحميل PDF

إذا لم يُفتح ملف PDF داخل Instagram، اضغط ⋯ أعلى الشاشة واختر «فتح في المتصفح».

غلاف دليل «7 قواعد تحمي مشروعك مع AI Agents» من GAOBA AI

«الوكيل» (AI Agent) يعني ذكاءً اصطناعيًا يعدّل ملفات مشروعك بنفسه، لا يكتفي بالإجابة عن أسئلتك.

عندما يعدّل الذكاء الاصطناعي مشروعك بسرعة، تحتاج نظامًا يرتّب التعديلات ويحميك من الفوضى: كل مهمة في فرع خاص بها، وإذا أخطأ الوكيل لا تدمج تعديلاته.

هذه هي الفكرة نفسها التي عرضها ريل Pando على حساب GAOBA AI. حوّلناها إلى 7 قواعد بسيطة، ومع كل قاعدة أمر (Prompt) جاهز تنسخه وتلصقه للوكيل. لا تحتاج أن تكون مبرمجًا.

ماذا ستستفيد

  • نقطة رجوع آمنة قبل كل تعديل، فتعود إلى النسخة السليمة خلال ثوانٍ.
  • كل مهمة في فرع منفصل، فتبقى النسخة الأصلية سليمة حتى توافق.
  • خطة قبل التنفيذ، ومراجعة التغييرات بكلام بسيط قبل الدمج.
  • زر طوارئ واضح عندما يخرب المشروع، وحماية مفاتيح API وكلمات السر.
  • خطوات خاصة بـ Claude Code وCursor، وملف قواعد دائم تضعه مرة واحدة.
  • قائمة سريعة من 6 نقاط تراجعها قبل كل جلسة.

قبل ما تبدأ (مرة وحدة بس)

تأكد أن مشروعك محفوظ في Git. ‏Git هو «سجل الحفظ» لمشروعك: كل نقطة حفظ تستطيع الرجوع إليها.

انسخ والصق

تأكد إن المشروع فيه Git. إذا ما فيه، شغّل git init، وجهّز ملف .gitignore مناسب للمشروع، واعمل أول حفظ (commit) باسم "start". لا تعدّل أي كود ثاني. بعدها قل لي ايش سويت بجملتين.

القواعد 7

  1. القاعدة 1

    نقطة رجوع قبل كل طلب

    قبل أي تعديل كبير، احفظ النسخة التي تعمل. إذا خرب شيء، تعود إليها خلال ثوانٍ.

    انسخ والصق

    قبل ما تبدأ هذي المهمة، اعمل commit بالحالة الحالية باسم "before: <اسم المهمة>". لا تبدأ التعديل إلا بعد ما تأكد لي إن الحفظ تم.

  2. القاعدة 2

    كل مهمة في فرع خاص

    الفرع (branch) نسخة جانبية من مشروعك. يعمل الوكيل فيها، وتبقى النسخة الأصلية سليمة حتى توافق. وهي نفس فكرة «المسار الخاص» في Pando.

    انسخ والصق

    سوّ فرع جديد باسم task/<اسم-المهمة> واشتغل فيه بس. لا تلمس الفرع الرئيسي (main) أبداً، ولا تدمج إلا لما أقول لك "ادمج".

  3. القاعدة 3

    خطة أول، تعديل بعدين

    اجعل الوكيل يخبرك بما سيفعله قبل أن يلمس أي ملف.

    • Claude Code: شغّل وضع التخطيط (Plan Mode) قبل المهام الكبيرة.
    • Cursor: اطلب الخطة في المحادثة أولًا.
    انسخ والصق

    لا تعدّل أي ملف ذلحين. اكتب لي خطة قصيرة: ايش الملفات اللي بتغيّرها، وليش، وايش ممكن يخرب. انتظر موافقتي قبل التنفيذ.

  4. القاعدة 4

    مهمة صغيرة وحدة في كل مرة

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

    انسخ والصق

    نفّذ الخطوة الأولى من الخطة بس، واعمل commit لها، ووقف. لا تكمل الخطوة الثانية إلا لما أراجع.

  5. القاعدة 5

    راجع قبل ما تدمج

    لا تحتاج أن تكون مبرمجًا: اطلب من الوكيل أن يشرح التغييرات بكلام بسيط.

    انسخ والصق

    اعرض لي ملخص كل التغييرات في هذا الفرع مقارنة بـ main (git diff)، بكلام بسيط: ايش تغيّر، وليش، وهل فيه أي ملف انحذف أو أي إعداد تغيّر. لا تخفي شي.

  6. القاعدة 6

    زر الطوارئ

    إذا خرب المشروع، لا تترك الوكيل «يصلّح» فوق الخراب. ارجع إلى آخر نسخة تعمل.

    • Claude Code: فيه نقاط رجوع (checkpoints) تعود إليها بالأمر ⁦/rewind⁩.
    • Cursor: فيه زر استرجاع نقطة الحفظ (Restore Checkpoint) بجانب رسائل المحادثة.
    انسخ والصق

    وقف التعديل. ارجع المشروع لآخر commit اسمه يبدأ بـ "before:" بدون ما تحذف السجل، وقل لي بالضبط ايش رجّعت.

  7. القاعدة 7

    المفاتيح والأسرار ما ترتفع أبداً

    مكان مفاتيح API وكلمات السر هو ملف ⁦.env⁩، وهذا الملف لا يدخل Git.

    انسخ والصق

    تأكد إن .env وكل ملفات المفاتيح موجودة في .gitignore. افحص المشروع: هل فيه أي مفتاح API أو كلمة سر مكتوبة داخل الكود أو محفوظة في Git؟ إذا لقيت، قل لي فين بالضبط وكيف أنقلها لـ .env. لا ترفع أي شي.

Claude Code وCursor

أين تستخدم كل أداة في هذه القواعد.

  • Claude Code

    • وضع التخطيط (Plan Mode) قبل المهام الكبيرة.
    • نقاط رجوع (checkpoints) تعود إليها بالأمر ⁦/rewind⁩.
    • ملف القواعد الدائم يوضع في CLAUDE.md داخل مجلد المشروع.

  • Cursor

    • اطلب الخطة في المحادثة قبل أي تعديل.
    • زر استرجاع نقطة الحفظ (Restore Checkpoint) بجانب رسائل المحادثة.
    • ملف القواعد الدائم يوضع داخل ⁦.cursor/rules⁩ أو في AGENTS.md.

ملف القواعد الدائم (الصقه مرة وينفّذه الوكيل كل مرة)

ضع هذه القواعد في ملف داخل مشروعك، فيلتزم بها الوكيل في كل جلسة دون أن تكرّرها.

  • Claude Code: ضعه في ملف CLAUDE.md في مجلد المشروع.
  • Cursor: ضعه في ملف قواعد داخل ⁦.cursor/rules⁩ أو في AGENTS.md.
انسخ والصق

# قواعد العمل في هذا المشروع - قبل أي مهمة: commit باسم "before: <المهمة>". - اشتغل دائماً في فرع task/<اسم-المهمة>، ولا تعدّل main مباشرة. - اعرض الخطة وانتظر الموافقة قبل تعديل أكثر من ملف واحد. - نفّذ خطوة وحدة، واعمل commit، ووقف للمراجعة. - لا تحذف ملفات، ولا تغيّر إعدادات قاعدة البيانات أو الدفع، إلا بموافقة صريحة. - لا تكتب مفاتيح API أو كلمات سر داخل الكود. استخدم .env. - لا تدمج في main إلا لما أقول "ادمج". - بعد كل خطوة: لخّص التغييرات بكلام بسيط.

قائمة سريعة قبل كل جلسة

  • آخر نسخة شغالة محفوظة (commit)
  • الوكيل في فرع خاص، مش في main
  • شفت الخطة ووافقت عليها
  • المهمة صغيرة ووحدة
  • راجعت ملخص التغييرات قبل الدمج
  • ⁦.env⁩ موجود في ⁦.gitignore⁩

ماذا تحتاج

  • Claude Code أو Cursor، أو أي وكيل ذكاء اصطناعي يعدّل ملفات مشروعك.
  • مشروع محفوظ في Git (الدليل يشرح كيف تجهّزه بأمر واحد).

احتفظ بالدليل معك

كل القواعد والأوامر في هذه الصفحة، في ملف PDF واحد تحفظه على جوالك أو جهازك.

تحميل PDF