يفترض أنك أمسكت بعد الفصلين الأول والثاني بماهية Claude Code وطريقة عمله. والذي نبنيه في هذا الفصل إيقاع تديره كل يوم بالصورة نفسها ― أربع نقرات: استكشاف ثم تخطيط ثم تنفيذ ثم التزام.
وسبب الحاجة إلى قالب واضح: أن سبب الأيام التي لا تسير فيها الأمور هو في الغالب «تخطّي نقرة». كتبتَه قبل أن تُقرئه، أو فوّضت إليه بلا وسيلة تحقّق، أو تركته يجري بلا فواصل ― تختلف الأعراض ويبقى موضع الرجوع واحداً.
قالب اليوم ― أربع نقرات تدور
أقرئه الملفات ذات الصلة واجعله يصف الوضع الحالي بالكلمات. ولا تدعه يكتب بعد.
اجعله يخرج الخطوات أولاً وصحّحها أنت. وهذا موضع التصحيح الرخيص الوحيد.
دعه يكتب ويشغّل التحقّق في الحال. واجعله يُتمّ دورة الفصل الأول كاملة.
متى نجح، ثبّت نقطة تستطيع الرجوع إليها. ومنها يبدأ الاستكشاف التالي.
ومقياس حجم الدورة الواحدة: «إن عجزت عن تذكّر ما جرى في أثنائها فهي أكبر من اللازم». وأربع دورات مدّة كل منها ساعة أثبتُ دائماً تقريباً من دورة واحدة تمتدّ نصف يوم.
وليس المعنى «افعل كل شيء في كل مرة». فإصلاح خطأ مطبعي لا يحتاج إلى خطة. والذي تحكم فيه هو أي نقرة يمكن حذفها، والوضع الابتدائي «افعلها كلها».
قبل أن تبدأ، سلّمه وسيلة التحقّق
قبل الدخول في النقرات الأربع هناك شيء تفعله مرة واحدة: أن تسلّمه مسبقاً وسيلة يتحقّق بها من نفسه بنفسه.
فكما رأينا في الفصل الأول، الداخل حلقة جمع ثم تنفيذ ثم تحقّق. وقوّته من وجود STEP 3، إذ يواصل الإصلاح بنفسه حتى تنجح الاختبارات. وبالمقابل إن غابت وسيلة التحقّق توقّفت الحلقة عند دورة واحدة ― يكتب، ويقول «الأرجح أنه صحيح»، وينتهي. تماماً كأداة المحادثة.
تكفي جملة «مرّر الاختبارات». ومخرجات الفشل تصير المدخل التالي، فـتدور الحلقة وأنت لا تنظر.
تشغّل أنت، وتنقل النتيجة، ثم تطلب الكتابة من جديد. وتصير أنت عنق الزجاجة. وما فوّضت شيئاً في الحقيقة.
وما تسلّمه إياه لا يلزم أن يكون كبيراً. يكفي سطر واحد معناه «إن نفّذت هذا الأمر عرفتَ أصحيح هو أم لا». وكتابته في ملف أوثق من قوله شفاهاً ― لأن CLAUDE.md الموضوع في جذر المشروع يُعاد قراءته من القرص حتى بعد الضغط.
ما يستحقّ أن يوضع في CLAUDE.md (أمثلة)
- الأوامر التي تُمرَّر بعد أي تغيير: الاختبارات / فحص الأنواع / المدقّق
- لا تُبلغ بأن العمل «انتهى» وهي ما زالت تفشل
- المواضع التي لا تُلمس: الملفات المولَّدة وإعدادات الإنتاج ونحوها
وحين تكتب ذلك، يبدأ بالتحقّق من نفسه بعد كل تغيير دون أن تقول «شغّل الاختبارات» في كل مرة. وليس المعنى أنك تعطي تعليمات أقلّ، بل أن المواضع المحتاجة إلى تعليمة صارت أقلّ ― وهكذا يؤتي القالب ثماره (وطريقة الكتابة في الفصل السادس). والمهام التي وضعها الفصل الأول في جانب «لا تناسبها» تسقط هنا أيضاً، لأنه لا توجد وسيلة تحقّق تسلّمها.
الاستكشاف ― أقرئه قبل أن تكتبه
النقرة الأولى. والعمل واحد ― أقرئه الملفات ذات الصلة واجعله يشرح كيف تقف الأمور الآن. ولا كتابة بعد. فإن تخطّيت هذا ملأ Claude ما لم يقرأه بالتخمين. تعود شيفرة معقولة الظاهر، مختلفة اختلافاً دقيقاً عن أسلوب ما حولها، ولا تنتبه إلى الفجوة إلا في المراجعة أو في الإنتاج.
استكشاف سيّئ: «أصلح ما يتعلّق بالمصادقة»
والنتيجة: يبدأ التعديل فوراً، ولا ترى على أي شيء بنى
استكشاف جيّد: «ابحث عن الملفات المتعلّقة بالمصادقة واقرأها.
واشرح كيف تُعالَج عملية الدخول الآن،
مع قائمة بالملفات ذات الصلة.
ولا تغيّر شيئاً بعد.»
والنتيجة: تظهر الافتراضات على الشاشة، فإن مالت صحّحتها هنا
والشرح الذي يعود إليك اقرأه. فهذا أرخص موضع للتدخّل. وجملة «هذا الملف لم يعد مستعملاً» تكلّف سطراً واحداً، وهو جزء يسير مما يكلّفه اكتشاف تنفيذ خاطئ في المراجعة.
وللاستكشاف ثمن أيضاً. فكل ملف يقرؤه يحطّ في السياق، وكلما وسّعت الاستكشاف ضاقت مساحتك لاحقاً ― وسطر الفصل الأول عن البطء ونسيان أول الحديث يبدأ من هنا. وثلاث طرق لكبح ذلك.
- حدّد النطاق ― «جانب المصادقة وحده الآن». فأنت تحتاج إلى صورة الكل لا إلى كل ملف فيه
- اقرأ الملفات الضخمة أجزاءً ― فقراءتها كاملةً تملأ السياق سريعاً. ونطاق أسطر أو دالّة واحدة يكفي غالباً
- افصل الاستقصاءات كثيرة المخرجات ― تنقيب السجلات والبحث الواسع يذهب إلى وكيل فرعي. فله سياقه الخاص ولا يعيد إلا ملخّصاً، فلا ينتفخ السياق الأصلي (الفصل السادس)
التخطيط ― متى ينفع نمط التخطيط ومتى يثقل
النقرة الثانية. اجعله يخرج ما سيغيّره وبأي ترتيب قبل أن يبدأ الكتابة. ولـClaude Code نمط تخطيط مخصّص لهذه النقرة، يبحث ويعرض خطة ثم يتوقّف، ولا يمضي إلى الكتابة حتى توافق. وطريقة التبديل تختلف باختلاف النسخة، فتأكّد من مساعدة نسختك.
وجوهره نقل بوابة الأذونات من «كل تعديل» إلى «مدخل العمل». فالوضع الافتراضي يستأذن عند كل استدعاء أداة، أما نمط التخطيط فيجمع ذلك في استئذان واحد ويقدّمه. وما توافق عليه لم يعد «هذا السطر» بل «منهج هذا العمل».
يمتدّ العمل عبر عدة ملفات / هناك طريقتان فأكثر لتنفيذه / يلزم موافقة التصميم القائم / التراجع عن الخطأ متعب / وأنت نفسك لم تحسم بعد أفضل خطوة
لا يوجد إلا عمل واحد / الخطوات محسومة سلفاً / يمكن التراجع فوراً عند الفشل / قراءة الخطة تستغرق أطول من التنفيذ نفسه
وما في الجانب الآخر تخطّاه بلا تردّد. فـالخطة ليست مجانية، إذ تستهلك وقت صنعها ووقت قراءتها والسياق. وما إن تتسلّمها حتى تنظر في ثلاثة أمور فقط. أولاً هل الافتراضات صحيحة (فإن مالت النقرة الأولى مالت الخطة كلها). ثانياً هل التحقّق مضمَّن (فإن غاب «مرّر الاختبارات» فأضفه). ثالثاً هل التقطيع دقيق بما يكفي (فالخطة التي تفعل كل شيء بخطوة واحدة لا تدلّك على السبب عند الفشل).
وفي الأعمال الطويلة، أنزل الخطة إلى ملف. فالخطة التي لا وجود لها إلا في المحادثة يسحقها التلخيص متى طالت الجلسة. أما إن أمليتها في موضع مثل PLAN.md فيمكنك قراءتها من جديد بعد طيّ السياق، وتصلح نقطة استئناف حين تترك مكانك ثم تعود.
التنفيذ ― قطّعه صغيراً وأصلح وأنت تشغّل
النقرة الثالثة. وهنا أخيراً تدعه يكتب. والأصلان اثنان.
الأول: شغّل التحقّق بعد كل خطوة. فإن جمعت خمسة تغييرات ثم اختبرت، ولد لك عمل جديد عند السقوط هو تمييز «أيّها السبب». أما إن كتبت واحداً ومرّرت واحداً، فالسبب هو الخطوة الأخيرة قطعاً. وهذا أدب لأجلك أنت أكثر مما هو لأجل Claude.
الثاني: سلّمه مخرجات الفشل كما هي. فلا حاجة إلى تلخيصها وإعادة صياغتها. إذ إن STEP 3 هو «اقرأ المخرجات وعُد إلى STEP 1»، والمخرجات الخام أغزر المدخلات معلومةً. وتبسيطها يقلّل القرائن لا يزيدها.
دورة واحدة أثناء التنفيذ (كرّرها بخطوات صغيرة)
تعديل: أعد كتابة بند واحد فقط من الخطة
↓
تشغيل: شغّل الاختبارات أو فحص الأنواع
↓
أخضر ← إلى البند التالي (أو إلى الالتزام)
أحمر ← اقرأ المخرجات ثم عُد إلى التعديل
وإن توالى الأحمر ثلاث مرات في الموضع نفسه، فكفّ عن طلب الإصلاح
والصواب: ارفع يدك وانتقل إلى التشخيص (الفصل الرابع)
والسطر الأخير قاعدة تجريبية. فـحين يبدأ الفشل نفسه بالتكرار، يكون ذلك في الغالب لا علامة على «اقترب الإصلاح» بل علامة على أن افتراضاً ما خاطئ.
وحين يطول التحقّق ― بناء طويل أو انتظار انتهاء التكامل المستمر ― يمكنك أن تفوّضه بدل الجلوس أمامه. فـClaude Code يستطيع تكرار تعليمة على فترة محدّدة، وإن تركت الفترة دون تحديد قرّر Claude بنفسه متى يعود للنظر، وأوقف الحلقة متى رأى العمل قد تمّ. وآلية ذلك وحدوده في ما أمر /loop. وانتبه إلى أن إغلاق الجلسة يوقفه.
الالتزام ― الفواصل تضعها بنفسك
النقرة الرابعة. متى نجحت الاختبارات فالتزم في الحال. لا «بعد أن أبلغ موضعاً مناسباً» ― بل لحظة النجاح هي الموضع المناسب.
- تصير نقطة رجوع ― فإن فشلت الخطوة التالية، عدتَ إلى موضع كان أخضر بيقين
- تصير الفروق بحجم يمكن قراءته ― فتغييرات نصف يوم لا تُقرأ. والفروق التي لا تُقرأ لا تُراجَع فعلياً
- يصير قطع المحادثة مباحاً ― فمتى صار الإنجاز محفوظاً، لم يعد إسقاط الجلسة مخيفاً
ولا بأس أن تجعله يكتب رسالة الالتزام أيضاً، لكن لا توافق دون النظر في الفروق. وإن عزمت على أن تنظر لا في «ماذا غُيِّر» بل في «هل اختلط بها شيء لم تكن تنوي تغييره»، لم تنزلق عينك.
وتذكّر أن الالتزام والدفع قراران منفصلان. أما حدود تفويض العمليات التي يصعب التراجع عنها مثل النشر فيتناولها الفصل الخامس.
كيف تطوي الجلسة وكيف تتراجع
بعد بضع دورات من النقرات الأربع، ستصطدم حتماً بمشكلة امتلاء السياق. فإن ظهر عرَضا الفصل الأول ― بطء الاستجابة ونسيان أول الحديث ― فقد حان الطيّ. والوسيلتان الضغط أو البدء من جديد، والفاصل بينهما واحد.
إن كان التالي «تكملةً» فاضغط ― إذ تنقل المسار ملخّصاً، والفرق بينه وبين الضغط التلقائي أنك تستطيع تحديد ما يبقى. وإن كان التالي «أمراً آخر» فابدأ من جديد ― فما دمت لا تحتاج حتى إلى ملخّص، فلا داعي لدفع كلفة صنعه. ويزيد دقّتك أنك لا تجرّ خلفك عملاً لا صلة له.
وللتوقيت قالب أيضاً. اضغط عند فاصل العمل لا بحسب الساعة أو النسبة ― أي حين تنتهي دورة وقبل الدخول مباشرةً في عمل طويل. فإن ضغطت في المنتصف، سحق التلخيصُ تفاصيل ستستعملها بعد قليل. والحجّة في هل ينبغي تشغيل /compact دورياً.
وقبل الطيّ، أخرج إلى ملف كل ما يضرّك ضياعه. فـCLAUDE.md الموضوع في جذر المشروع والذاكرة التلقائية يُعاد قراءتهما من القرص، فيبقيان مهما طويت. أما القرارات التي لا وجود لها إلا في المحادثة فيميّعها التلخيص.
وثمة آلية أخرى تغيّر طريقة التفويض نفسها. فـClaude Code ينشئ تلقائياً نقطة رجوع عند كل مطالبة، فإن اختلّ شيء أمكنك التراجع إليها. وتختار الهدف من بين الشيفرة وحدها أو المحادثة وحدها أو كليهما، وأكثرها استعمالاً «أرجِع الشيفرة وأبقِ المحادثة» ― فتُلغى التغييرات وأنت محتفظ بذاكرة ما كان خاطئاً فتعيد صياغة طلبك.
والذي ينفع هنا ليس سهولة العملية بقدر ما هو طريقة تحمّلك للمخاطرة. فإن ظننت أنك لا تستطيع الرجوع، صرت تراجع خطوة خطوة وضعف معنى استعمال وكيل أصلاً. أما إن علمت أنك تستطيع الرجوع، فوّضت مساحات أوسع وصار أن تجرّب وتُسقط ما لم ينجح خياراً وارداً.
لكن الذي يرجع هو «الملفات التي أعاد Claude كتابتها بأداة التعديل» فقط. فالملفات التي أنشأتها أو حذفتها أوامر الصدفة، وتعديلاتك أنت، وحالة قاعدة البيانات ― كل ذلك لا يرجع. وهو لا يغني عن Git، والأصل استعماله إلى جانب التزامات عند المفاصل. ويمكن رسم الخط هكذا: الأعمال التي تنتهي عند تعديل الملفات فوّضها على اتّساع. والأعمال التي تغيّر الحالة عبر الصدفة التزم قبل تفويضها. والتفصيل في نقاط التفتيش والتراجع.
اجعله يراجع ― افصل من كتب عمن يقرأ
ليست الشيفرة التي نجحت اختباراتها شيفرةً جيّدة بالضرورة. فالاختبار يضمن «أنها لم تنكسر» ولا يجيب عن «أكان هذا الأسلوب صواباً».
والأصل واحد: افصل سياق الكتابة عن سياق القراءة. فإن قلت «راجِع» في المحادثة نفسها التي فرغ فيها للتوّ من كتابة ذلك التنفيذ، مال إلى تصديق حكمه هو. فالحال التي ترى فيها كل أسباب اختيارك حال لا تصلح للتنقيب عن العيوب. وثلاثة أمور بالتحديد.
- أقرئه في جلسة أخرى ― التزم لتولّد الفروق، ثم سلّم الفروق وحدها إلى محادثة نظيفة. فتُقرأ بعين لا تعرف المسار
- حدّد زاوية النظر ― لا «حسّنه» بل «الحالات الحدّية» و«الاتّساق مع أسلوب ما هو قائم». فالطلب الغامض يولّد ملاحظات غامضة
- لا تبتلع الملاحظات كما هي ― تحقّق من صحّتها على الواقع. واقرأ أولاً قبل أن تأمر بالإصلاح
والثالثة متّصلة بمواضع أخرى من هذا الفصل. فـالمراجعة نموذج بارز لـ«المهمة التي لا وسيلة للتحقّق منها»، ولأن الصواب فيها لا يُحسم تلقائياً، فقد يقول Claude كلاماً بعيداً عن الهدف بنبرة واثقة. وإن مرّرت ذلك مباشرةً إلى أمر بالتعديل أفسدت شيفرة كانت صحيحة ― فعامل الملاحظات على أنها مرشّحات واحكم عليها واحدة واحدة. ومتى وجدت نفسك تريد إدارة الزاوية نفسها في كل مرة، فتلك إشارة إلى إنزالها في آلية (الفصل السادس).
الجلسات المتعدّدة ― إلى أي حدّ تربح
أن تمضي في عمل آخر بينما يدير أحدهما اختباراً طويلاً ― فكرة تخطر طبيعياً. ولـClaude Code آلية تُقيم عدة جلسات مستقلّة في الخلفية وتديرها في شاشة واحدة. وجوهرها العزل، إذ إن جلسات الخلفية تنتقل إلى دليل عمل خاص بها قبل أن تعدّل الملفات. فتصير القراءة مشتركة والكتابة منفصلة، ولا يقع بنيوياً حادث تكاتب على الملف نفسه. والتفصيل في عرض الوكلاء والتوزيع.
المهامّ مستقلّة بعضها عن بعض / لا حاجة إلى متابعة المسار / يكفي أن تحكم بعد تسلّم النتيجة / أحدها عمل طويل الانتظار
تعتمد على قرار تصميم واحد / تحتاج إلى إعادة توجيه في المنتصف / تتضمّن عمليات لا تُلغى / عددها أكبر مما تستطيع فحص نتائجه أصلاً
وآخر ما في الجانب الثاني هو أقوى القيود. فـالتوازي يزيد مجموع المراجعة. إذ إن إطلاق ثلاث مهامّ يعيد إليك ثلاثة أسئلة «أحقّاً كذلك؟»، وجهد التأكّد لا يتوازى. وسقف ما يجوز إطلاقه هو العدد الذي تستطيع التحقّق من نتائجه. والكلفة ترتفع أيضاً ― فليس كونها في الخلفية يجعلها أرخص (الفصل السابع).
وقبل أن تبدأ التوازي، راجع إعداد الأذونات. فالجلسات التي تجري في الخلفية ترث أذوناتها من الإعداد لا من اختيار تجريه في اللحظة. ومن اعتاد إرخاء القيد يولّد بعدد الجلسات «جلسات بأذونات مرخاة لا يراقبها أحد». فالفصل الخامس أولاً.
وأكثر ما يقع فيه الحوادث على تواضعه هو التنظيف بعد الفراغ. فمساحة العمل التي أنشأتها جلسة الخلفية تُحذف معها متى حذفت الجلسة. و«انتهى» غير «دمجته» ― فالتزم قبل الحذف.
الخلاصة
- إيقاع اليوم أربع نقرات: استكشاف ثم تخطيط ثم تنفيذ ثم التزام. وسبب الاضطراب غالباً تخطّي نقرة
- قبل البدء سلّمه وسيلة التحقّق. فبدونها تتوقّف حلقة الجمع والتنفيذ والتحقّق عند دورة واحدة
- في الاستكشاف أقرئه قبل أن تكتبه. لكن ما يقرؤه يقتطع من مساحتك، فـحدّد النطاق
- التخطيط آلية تجمع بوابة الأذونات عند مدخل العمل. ويثقل في الأعمال التي تنتهي بخطوة واحدة
- في التنفيذ تحقّق بعد كل خطوة، وعند الفشل ثلاث مرات انتقل إلى التشخيص. والالتزام لحظة النجاح
- الفاصل بين الطيّ والبدء من جديد هو «أهو تكملة أم أمر آخر». وقبل الطيّ مباشرةً أخرج ما تحتاجه إلى ملف
- التراجع يرجع تعديلات الملفات فقط. وما تغيّر عبر الصدفة لا يرجع، فـاستعمله مع الالتزام
- المراجعة تُفصل عن سياق الكتابة، والملاحظات تُعامَل بوصفها مرشّحات. وسقف التوازي هو ما تستطيع التحقّق منه
وحتى مع اكتمال القالب، يبقى التعثّر واقعاً. فلنملك في الفصل التالي ترتيب التشخيص. انتقل إلى الفصل الرابع «الخروج من التعثّر».