مختصر كتابي: Clone Sanad, Run npm test, First Read-Only Session

ماذا تفعل قبل أول تعديل مع Claude Code في «سند»؟

أراد كريم أن يطلب من Claude Code تعديل «سند» منذ اليوم الأول، فسألته سلمى: هل شغّلت الاختبارات قبل ذلك؟ لم يفعل، وإن فشل شيء بعد التعديل فلن يعرف أكان الفشل قبله أم بسببه. لذلك تبدأ بنقطة قياس، ثم بأول جلسة قراءة فقط.

اجعل المشروع نسختك أنت على GitHub:

cd sanad
git remote rename origin template
gh repo create sanad --private --source=. --remote=origin --push

ثم شغّل npm ci وnpm test. يجب أن تنجح الاختبارات كلها، فهي تغطي الـ API (تسجيل الدخول، وكل مستخدم يرى طلباته فقط، وقراءة جسم الطلب) والتخزين وسجل النشاط. دوّن رقم الناجح من جهازك. ثم شغّل npm start وافتح العنوان الذي يطبعه الـ Terminal؛ العنوان localhost يُرفض عمدًا. جرّب مريم (طلبان) ثم عمر (طلب واحد لا يرى طلبات مريم). هذه نسخة البداية وليس فيها زر لإعادة فتح الطلب.

بعد ذلك افتح Claude Code في Plan Mode من البداية:

claude --permission-mode plan

تأكد من أن الـ Mode الظاهر هو Plan، واسأل عن من يحدد المستخدم الحالي، وكيف تُقرأ بيانات الطلب، واطلب في كل سؤال اسم الملف ورقم السطر. وإن طلب منك موافقة على Plan فلا توافق. والأهم: لا تصدّق الإجابة المقنعة، بل افتح الملف بنفسك عند السطر المذكور. ثم اكتب /context وسجّل النسبة، واخرج بـ exit، وتأكد أن git status فارغ.

• شغّل الاختبارات قبل أي تعديل لتعرف نقطة البداية.
• Plan Mode يقرأ ويجيب دون تعديل ملفات.
• اطلب اسم الملف ورقم السطر ثم افتحهما بنفسك.
• خطأ Claude في إجابة ليس فشلًا؛ تسجيله دليل قوي على مراجعتك.
• لا تحفظ ملف /export داخل مجلد سند حتى يبقى الـ Repo نظيفًا.

طبّق على جهازك: شغّل الاختبارات، واسأل Claude في Plan Mode ثلاثة أسئلة عن سند (منها لماذا يُرفض localhost، وهل يرى عمر طلبات مريم)، وافتح مكانين على الأقل بنفسك، واكتب evidence/L004.md ثم شغّل npm run check -- L004 حتى تحصل على PASS.

الخلاصة: اعرف حالة المشروع بالاختبارات أولًا، ثم اسأل Claude في Plan Mode وتحقق من كل إجابة بنفسك.