أعِدّ مساعدك والعادات التي تحوّله إلى شريكٍ موثوق — لا آلة حظّ.
الوحدة 2 · الإعداد، والسياق، والصياغة، والتوجيه.
مبتدئ سير العمل يتضمّن مختبرًا ~50 دقيقةالمتطلبات المسبقة: الوحدة 1 — ينبغي أن يكون لديك مستودع snippet-vault من المختبر الأول.
تأتي مساعدات البرمجة بالذكاء الاصطناعي في شكلين عريضين. ستعتمد على أحدهما محرّكًا رئيسيًّا، لكن من المفيد معرفة كليهما:
| النوع | ماذا يفعل | أمثلة |
|---|---|---|
| مساعد محادثة | تلصق الشيفرة وتنسخ الإجابات. بسيط، لكنه لا يرى مشروعك ولا يشغّل شيئًا. | claude.ai، ChatGPT |
| وكيليّ / داخل المحرّر | يقرأ ملفاتك ويعدّلها مباشرةً، ويشغّل الأوامر، ويعمل عبر المستودع كلّه. هنا تصبح البرمجة بالإحساس قوية. | Claude Code، Cursor، Copilot |
Claude Code مساعد وكيليّ يعيش في الطرفية (Terminal) — يقرأ مستودعك، ويعدّل الملفات، ويشغّل الأوامر بموافقتك. مناسبٌ لدورةٍ عن الإطلاق، لأن الطرفية هي مكان البناء والاختبار والنشر. وكل ما تتعلّمه هنا ينطبق مباشرةً على Cursor أو Copilot — سير العمل نفسه، تختلف الأزرار فقط.
لا تتعلّق بأداة واحدة. المساعدات تتغيّر شهريًّا؛ أمّا العادات في هذه الوحدة — السياق، والطلبات الواضحة، والتغييرات الصغيرة المُراجَعة — فهي ما يجعلك منتجًا فعلًا، وتنتقل معك إلى أيّ أداة تالية.
لا يعرف المساعد إلا ما في نافذة سياقه — طلبك، مع ما يراه من ملفات الآن. لا يقرأ أفكارك، ولا يتذكّر الأسبوع الماضي، ولا يخمّن أعرافك. ومعظم لحظات «الذكاء الاصطناعي كتب شيفرةً سيّئة» هي في الحقيقة لحظات سياقٍ ناقص.
العلاج ملفٌ صغير في جذر مستودعك يقرأه المساعد تلقائيًّا، يصف المشروع مرّة واحدة كي لا تكرّر نفسك كل طلب. ولكل أداة اسمها له:
| المساعد | ملف السياق |
|---|---|
| Claude Code | CLAUDE.md |
| Cursor | .cursorrules |
| Copilot | .github/copilot-instructions.md |
الجيّد منه قصيرٌ وملموس — التقنية، والبنية، والأعراف، وبعض «الممنوعات»:
إن وجدت نفسك تكتب الشرح ذاته للمساعد مرّتين، فمكانه ملف السياق. اكتبه مرّة؛ يقرأه المساعد في كل مرّة.
الطلب الغامض يعطي تطبيقًا غامضًا. والطلب الجيّد له أربعة أجزاء — وقاعدةٌ ذهبية واحدة:
| الجزء | ماذا تقول |
|---|---|
| الهدف | ما تريده، في جملة واحدة. |
| القيود | التقنية، والأسلوب، والمكتبات المطلوبة أو الممنوعة. |
| معايير القبول | كيف ستعرف أنه اكتمل — السلوك الذي ستتحقّق منه. |
| خارج النطاق | ما لا يُمَسّ أو يُبنى. |
القاعدة الذهبية: لأيّ أمرٍ غير تافه، اطلب خطةً قبل الشيفرة. اقرأ الخطة، صحّحها، ثم دعه يبني. فإصلاح خطةٍ أرخص بكثير من إصلاح كومة ملفاتٍ مولّدة.
«اصنع لي تطبيق مقتطفات.» → ستحصل على شيءٍ ما، بإطارٍ ما، بخياراتٍ لم تتّخذها ولا يمكنك توقّعها.
«الهدف: بناء هيكل خزنة المقتطفات كـmonorepo. القيود: React في web/، وNestJS في api/، وTypeScript. القبول: يبدأ كل تطبيق بأمرٍ واحدٍ موثَّق؛ بلا ميزاتٍ بعد. خارج النطاق: لا تنفّذ المقتطفات أو التنسيق بعد. أولًا، أرِني خطة المجلدات — ولا تكتب شيفرةً حتى أقول go.»
الفرق بين المحترف والمقامر ليس الطلب — بل ما يحدث بعده. أربع عادات تُبقيك مسيطرًا:
| العادة | لماذا |
|---|---|
| اقرأ كل تغيير | لا تقبل شيفرةً لم تنظر إليها. هذه العادة وحدها تمنع معظم الكوارث. |
| أبقِ التغييرات صغيرة | شأنٌ واحد في المرّة، ثم أودِع. التغييرات الصغيرة قابلة للمراجعة؛ والضخمة تخفي العلل. |
| صحّح مبكرًا | اتجاهٌ خاطئ؟ توقّف وأعد التوجيه عند أول علامة، لا بعد عشرة تعديلاتٍ فوقه. |
| أعد الضبط عند التشوّش | إن ناقض المساعد نفسه أو دار في حلقة، امسح السياق وابدأ المهمّة من جديد. ذاك تآكل السياق — موطن الفشل رقم 5. |
لا تقبل تغييرًا لم تقرأه. «لقد اشتغل، إذًا لا بأس» هو بالضبط كيف تُشحن العلل الصامتة والثغرات الأمنية. أنت المراجِع؛ والذكاء الاصطناعي هو المبتدئ. الوحدات اللاحقة (الاختبارات، بوابات الجودة) تضيف نسخًا احتياطية آلية — لكن عيناك أولًا.
ستثبّت أدواتك، وتُعرّف المساعد بالمشروع عبر ملف سياق، ثم تستخدم طلبًا منظَّمًا لبناء هيكل خزنة المقتطفات الحقيقية — مراجعًا ومودِعًا وأنت تمضي. وستسلّم المستودع المحدَّث.
مستودع snippet-vault من الوحدة 1، بالإضافة إلى Node.js LTS ومساعدٍ وكيليّ (Claude Code مُستحسَن؛ وCursor أو Copilot يفيان).
لـClaude Code، ثبّته وشغّله داخل مجلد المشروع:
تستخدم Cursor أو Copilot؟ افتح مجلد snippet-vault في المحرّر فحسب — وبقيّة المختبر متطابقة.
أنشئ ملف سياق في جذر المستودع (CLAUDE.md لـClaude Code، أو ما يقابله في أداتك) مستخدمًا القالب من قسم السياق أعلاه. عدّله ليلائم مشروعك.
الصق الطلب المنظَّم أدناه. حين يردّ المساعد بخطة مجلدات، اقرأها واعترض على ما لا يعجبك. عندها فقط قل «go».
دعه ينشئ الهيكل. اقرأ التغيير قبل القبول. ثم شغّل كل تطبيق للتأكّد من عمله (سيخبرك المساعد بالأوامر الدقيقة، غالبًا بنحو):
أودِع الهيكل وملف السياق:
ثم أضِف إلى REFLECTION.md: الصق ملف سياقك وطلبك؛ ودوّن شيئًا واحدًا أخطأ فيه المساعد أو افترضه وكيف وجّهته؛ وفي سطرٍ واحد، كيف تفوّق طلبك المنظَّم على «اصنع لي تطبيق مقتطفات». ثم أودِعه.
مستودع snippet-vault المحدَّث. تحقّق من نفسك قبل التسليم:
CLAUDE.md / .cursorrules / تعليمات Copilot)web/ وapi/ موجودان ويبدأ كل تطبيق بأمرٍ واحدREFLECTION.md يتضمّن طلبك، والخطة التي وافقت عليها، وتوجيهًا واحدًا قمت به| المصطلح | المعنى المبسّط |
|---|---|
| نافذة السياق | كل ما يستطيع النموذج «رؤيته» الآن — طلبك مع الملفات الظاهرة. وخارجها يكون النموذج أعمى. |
| مساعد وكيليّ | ذكاء اصطناعي يقرأ/يعدّل الملفات ويشغّل الأوامر مباشرةً، لا مجرّد محادثة. |
| ملف السياق | ملفٌ في المستودع (CLAUDE.md، .cursorrules…) يقرأه المساعد ليتعلّم مشروعك مرّة واحدة. |
| الهيكل (Scaffold) | الهيكل الفارغ للمشروع — مجلّدات، إعداد، «hello world» — قبل الميزات الحقيقية. |
| Monorepo | مستودع Git واحد يضمّ عدّة تطبيقات (هنا: web/ وapi/). |
بيئةٌ تعمل، ومساعدٌ وكيليّ يعرف مشروعك عبر ملف سياق، ووصفةُ طلبٍ قابلة للتكرار (هدف / قيود / قبول / خارج النطاق، والخطة أولًا)، وعادات التوجيه التي تُبقيك مسيطرًا — مع هيكل monorepo (React + NestJS) مُودَع.
التالي: الوحدة 3 — التخطيط أولًا. قبل بناء الميزات، نحوّل الفكرة الغامضة «خزنة مقتطفات» إلى مواصفةٍ واضحةٍ قابلة للتنفيذ يتّبعها المساعد دون تِيه.