中文版本 →

محاضرات مرتبطة: المحاضرة 03. اجعل المستودع مصدر الحقيقة الوحيد · المحاضرة 04. قسّم التعليمات عبر ملفات ملفات القوالب: templates/

المشروع 02. اجعل المشروع قابلًا للقراءة واستأنف من حيث توقفت

ما الذي ستفعله

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

ستنفذه مرتين: الأولى دون مساعدة، والثانية مع وضع ARCHITECTURE.md و PRODUCT.md و session-handoff.md مسبقًا في المستودع.

استخدم المشروع الموجود في المستودع

مسار المستودع: projects/project-02/

المجلد	ماذا يحتوي	ماذا تقارن
starter/	كود Project 01 مع import المستندات، عرض التفاصيل، و persistence غير مكتملة بعد. توجد وثائق لكنها أخف، ولا يوجد session-handoff.md.	مقدار السياق الذي تحتاج الجلسة الثانية من الوكيل إلى اكتشافه من جديد.
solution/	نفس جزء المنتج مكتمل، مع وثائق handoff تحت projects/project-02/solution/، بالإضافة إلى feature_list.json و session-handoff.md.	هل تستطيع جلسة جديدة المتابعة اعتمادًا على حالة المستودع فقط.

الأدوات

• Claude Code أو Codex
• Git
• Node.js + Electron

آلية harness

Workspace قابل للقراءة من الوكيل + ملفات حالة دائمة