أنت لا تكتب كودًا، فيتحوّل كل سؤال «كيف يعمل هذا فعلًا؟» إلى اجتماع مع مهندس. لكن الكود هناك تمامًا، وClaude يستطيع قراءته. هذا النظام يوجّه Claude إلى الـ repository الخاص بك ويجعله يشرح، بالإنجليزية البسيطة، ما يحدث حين يفعل مستخدم X، أي ملفات تعمل وبأي ترتيب، وأين ستندرج ميزة جديدة تقريبًا. لا تلمس Terminal — في Claude Desktop تفتح مجلد الـ repo وتسأل في المحادثة كما تسأل زميلًا. العائد ليس استبدال مهندسيك — بل أن تدخل المحادثة بـ«ها هو شكل الأمر»، كي يُنفَق الوقت الهندسي على الحُكم، لا على سرد الـ codebase لك.
- الـ repository الفعلي — في Claude Desktop، افتح المجلد الجذر للمشروع كي يقرأ Claude الشيء الحقيقي، لا وصفًا له. (لا حاجة لـ Terminal؛ فقط وجّهه إلى المجلد.)
- التدفّق الواحد الذي تريد فهمه، بمصطلحات المستخدم — «ماذا يحدث حين يُسجّل أحدهم»، «أين يُخزَّن مقال محفوظ».
- دفتر ملاحظات (أو ملف
notes.md) لالتقاط الخريطة بالإنجليزية البسيطة التي يعطيك إياها Claude، كي تبدأ منها محادثة الهندسة التالية.
-
احصل على المشهد العام أولًا
قبل تعقّب تدفّق محدّد، اجعل Claude يصف شكل الـ repo كله — المجلدات الرئيسية وما لكلٍ منها. التوجيه أولًا يمنع Claude (وأنت) من الضياع في ملف واحد.
أنت تطلبهذا codebase الخاص بنا. بالإنجليزية البسيطة، أعطني خريطة: ما المجلدات الرئيسية وما المسؤول عنه كلٌ منها؟ أين يعيش الـ frontend مقابل الـ backend مقابل البيانات؟ أبقها نظرة عامة بحجم شاشة واحدة — لا كود بعد، فقط شكل الأمر.ما تحصل عليه خريطة بنيوية قصيرة — «مجلد
app/هو الـ web UI، وapi/يعالج الـ requests، وdb/هو طبقة البيانات، وauth/يعالج تسجيل الدخول». كافية لتعرف أي حيّ يعيش فيه أي سؤال.اطلب الشكل قبل أي تفصيل. خريطة تفهمها تجعل كل إجابة لاحقة تهبط في مكان ما، بدل أن تطفو.
-
تعقّب تدفّقًا حقيقيًا واحدًا من البداية للنهاية
اختر فعل مستخدم ملموسًا واجعل Claude يتبعه عبر الملفات بالترتيب. «ماذا يحدث حين يُسجّل مستخدم» يحوّل العمارة المجرّدة إلى قصة تستطيع متابعتها.
أنت تطلباشرح لي، بالإنجليزية البسيطة، ما يحدث بالضبط حين يُسجّل مستخدم — خطوةً خطوة، مسمّيًا الملفات الحقيقية بالترتيب الذي تعمل به، من النقر على الزر إلى حيث تنتهي بيانات المستخدم الجديد. أين أنظر لو كانت التسجيلات تفشل؟ما تحصل عليه تعقّب مرقّم يسمّي ملفات حقيقية — «1. الـ form في
SignupForm.tsxيرسل (POST) إلىapi/auth/register.ts؛ 2. ذاك يتحقّق ويستدعيcreateUserفيdb/users.ts؛ 3. الصف يهبط في جدولusers؛ إن فشلت التسجيلات، ابدأ فيregister.ts». مسار تستطيع اتباعه فعلًا. -
اسأل الأسئلة التي قد تُحرَج من طرحها في اجتماع
هذه هي الغرفة الآمنة. لن يحكم Claude على سؤال أساسي، والإجابة عنها على انفراد تعني أن محادثات الهندسة تعمل على مستوى أعلى.
أنت تطلبثلاثة أسئلة بسيطة: أين تُخزَّن كلمة مرور المستخدم فعلًا، وهل هي مُجزّأة (hashed)؟ ماذا يحدث لمقالات المستخدم المحفوظة إن حذف حسابه؟ وأي ملف أُغيّره لأعدّل صياغة بريد تأكيد التسجيل الإلكتروني؟ما تحصل عليه إجابات مباشرة راسخة في الكود — «كلمات المرور مُجزّأة بـ bcrypt في
register.ts، لا تُخزَّن خامة أبدًا؛ حذف الحساب يتعاقب (cascade) ويزيل المحفوظات عبرdb/users.ts؛ نص البريد الإلكتروني يعيش فيemails/welcome.ts». الأساسيات، مُجابة بلا اجتماع. -
اعثر على أين ستعيش ميزة جديدة
الآن وجّهه إلى الأمام. سؤال أين ستذهب الميزة يحوّل القراءة إلى نطاق تستطيع أخذه إلى الهندسة — «ها هو تقريبًا ما يمسّه» بدل صفحة بيضاء.
أنت تطلبلو بنينا ميزة «حفظ المقالات للقراءة لاحقًا»، أي ملفات موجودة سيمسّها مهندس على الأرجح، وما الملفات الجديدة التي ستلزم على الأرجح؟ فقط الشكل التقريبي للعمل وما يتصل به — سأستخدم هذا لتحديد نطاق محادثة الهندسة، لا لكتابتها بنفسي.ما تحصل عليه نطاق راسخ — «يمسّ على الأرجح component قائمة المقالات و
db/لجدولsaved_articlesجديد؛ يحتاج عرض Saved جديدًا وAPI route للحفظ/إلغاء الحفظ». تدخل الهندسة بشكل العمل، لا بعلامة استفهام.التقط هذا في ملاحظاتك — إنه الفرق بين سؤال الهندسة «هل هذا صعب؟» وسؤال «هل مسّ هذه الملفات يطابق كيف ستفعلها؟»
- onboarding نفسك: جديد على شركة أو codebase موروث؟ شغّل الخطوات 1-3 عبر عدة تدفّقات لبناء نموذجك الذهني بسرعة، قبل أن تقابل من كتبه.
- تحديد نطاق ميزة حقيقية: اربط هذا مباشرةً خارج اختبر فكرة تحت الضغط إلى spec للـ v1 — الـ spec يقول ماذا، وهذا يقول أين تعيش وكم حجمها تقريبًا — كلاهما يغذّي الـ playbook الجامعة، من طلب العميل إلى الجاهزية للـ roadmap.
- اجعله روتينًا: لـ repo ستعود إليه باستمرار، ملف
CLAUDE.mdفي الجذر (انظر تبويب Capabilities) يعلّم Claude أعراف المشروع كي تكون كل قراءة مستقبلية أحدّ.
- Claude يشرح الكود؛ المهندس ما زال يمتلك ما إذا كان صحيحًا. تعقّب بالإنجليزية البسيطة قد يكون مخطئًا بثقة في بِتٍ دقيق — عامله كخريطة للتحقّق منها مع الهندسة، لا كحُكم للتصرّف عليه.
- عامل الـ codebase على أنه سري. إن احتوى الـ repo على secrets أو keys أو بيانات عملاء، فأنت تقرأ مادة مملوكة — أبقها في بيئتك المُعتمَدة ولا تلصق مقتطفات في أي مكان عام.
- القراءة للفهم، لا لتعديل كود حيّ. اطلب من Claude أن يشرح ويحدّد النطاق؛ ودع مطوّرًا يمتلك أي تغيير فعلي على النظام العامل.
ستحصل في النهاية على خريطة بالإنجليزية البسيطة لـ codebase الخاص بك — كيف يعمل تدفّق حقيقي، والأساسيات مُجابة بلا اجتماع، ونطاق تقريبي لميزة جديدة — كي تبدأ محادثات الهندسة من فهم مشترك بدل صفحة بيضاء.
أسئلة يطرحها الناس
- هل أحتاج فهم الكود لاستخدام هذه الـ playbook؟
- لا. في Claude Desktop تفتح مجلد الـ repo وتطرح الأسئلة بلغة عادية — ماذا يحدث حين يُسجّل مستخدم، وأين ستعيش ميزة ما — بلا Terminal وبلا مهندس في الغرفة. Claude يقرأ الملفات الفعلية ويشرحها لك بلغة بسيطة، فلا تحتاج أن تقرأ الكود بنفسك.
- هل من الآمن فتح الـ codebase في Claude Desktop لهذا الغرض؟
- عامل الـ codebase على أنه سري. إن احتوى الـ repo على secrets أو API keys أو بيانات عملاء، فأبقِ الجلسة في بيئتك المُعتمَدة ولا تلصق مقتطفات كود في أي مكان عام. فتح مجلد الـ repo في Claude Desktop محليًا ليس كإرساله لخدمة خارجية — لكن راجع سياسة شركتك إن كنت غير متأكد.
- ما مدى دقة شرح Claude للكود؟
- دقيق بما يكفي لتوجيهك وتحسين محادثات الهندسة، لكن لا يُعامَل كحُكم تتصرف عليه مباشرةً. قد يكون Claude مخطئًا بثقة في تفاصيل تنفيذية دقيقة — عامل تعقّبه كخريطة تتحقق منها مع مهندسك، لا كإجابة قاطعة عن كيفية تصرف النظام في الإنتاج.
- هل أستطيع استخدام هذا على codebase لم أبنه — كمشروع موروث؟
- نعم، وهو أحد أفضل استخدامات هذه الـ playbook. تشغيل الخطوات 1-3 عبر عدة تدفّقات في codebase غير مألوف أو موروث يمنحك نموذجًا ذهنيًا عاملًا بسرعة، قبل أن تقابل من كتبه. التقط المُخرَج في ملف `notes.md` كي لا تضطر لإعادة طرح الأسئلة نفسها.