حوّل فكرةً غامضة إلى خطةٍ قابلة للتنفيذ يتّبعها المساعد — دون تِيه.
الوحدة 3 · قرّر ماذا تبني، قبل أن تبنيه.
مبتدئ التخطيط يتضمّن مختبرًا ~45 دقيقةSPEC.md خفيفٍ وحيّSPEC.md لخزنة المقتطفات، والذكاء الاصطناعي يصوغ وأنت تقرّرالمتطلبات المسبقة: الوحدة 2 — مستودع snippet-vault بهيكله وملف سياقه.
تبدو البرمجة بالإحساس بلا خطةٍ سريعةً — لعشرين دقيقة تقريبًا. ثم يبدأ المساعد بتخمين مقصدك، ويضيف ما لم تطلبه، ويناقض خيارًا سابقًا، فتصبح تُطفئ الحرائق بدل أن تبني. والمواصفة ببساطة هي القرارات متّخذةً مرّةً واحدة، مكتوبةً، كي لا تعيد أنت ولا الذكاء الاصطناعي تخمينها.
| بلا مواصفة | مع مواصفة |
|---|---|
| يخترع الذكاء الاصطناعي نطاقًا لم تُرِده | النطاق ثابتٌ وظاهر — يسهل قول «ليس الآن» |
| «الاكتمال» شعورٌ يُتنازَع عليه لاحقًا | «الاكتمال» معايير قبولٍ يمكنك فحصها |
| تآكل السياق: ينسى النموذج القرارات السابقة | المواصفة ذاكرةٌ دائمة يعيد النموذج قراءتها |
| طلبٌ واحدٌ ضخمٌ غامض، ونتيجةٌ لا تُتوقّع | مهامّ صغيرة مقتطعة من الخطة، واحدةً تلو الأخرى |
هي SPEC.md قصيرٌ وحيّ في مستودعك — صفحة أو صفحتان. إنها العقد المشترك بينك وبين المساعد. ستحدّثها كلّما تعلّمت؛ وهذا متوقّع. وظيفتها أن تجعل سؤال «ماذا نبني؟» قابلًا للإجابة بنظرة.
أبقِها خفيفة. ستة أقسامٍ تغطّي أيّ تطبيقٍ صغير تقريبًا:
| القسم | يُجيب عن |
|---|---|
| المشكلة والهدف | ماذا نحلّ، ولمن؟ |
| قصص المستخدم | ماذا يستطيع المستخدم فعله؟ |
| ضمن النطاق / ليس هدفًا | ما سنبنيه — وما لن نبنيه صراحةً — الآن. |
| نموذج البيانات | الأشياء الأساسية التي نخزّنها وحقولها. |
| API / الشاشات | نقاط النهاية أو الصفحات التي تحقّق القصص. |
| المراحل | الترتيب الذي نبني به، أصغر شريحةٍ مفيدة أوّلًا. |
وهذا الهيكل الذي ستملؤه في المختبر:
تلتقط قصّة المستخدم شيئًا واحدًا يستطيع المستخدم فعله، من وجهة نظره، مع كيفية معرفتك أنه يعمل. الصيغة الكلاسيكية:
بصفتي [مَن]، أريد [ماذا]، حتى [لماذا].
ثم: معايير القبول — الشروط القابلة للفحص لـ«الاكتمال».
لخزنة المقتطفات:
أسطر القبول هذه ليست بيروقراطية — بل تصير حالات اختبارك في الوحدة 6، وتخبر المساعد متى يتوقّف بالضبط. ويكفّ «الاكتمال» عن كونه جدالًا.
لا تسلّم المساعد المواصفة كاملةً وتقول «ابنِها». قطّعها إلى مراحل عمودية رفيعة — كلٌّ منها زيادةٌ صغيرة تعمل وقابلة للشحن. ابنِ أصغر شيءٍ مفيد أوّلًا (الحدّ الأدنى)، ثم أضِف طبقة فوق طبقة.
أسرع طريقٍ للإنهاء هو أن تبني أقلّ. كل «ألن يكون رائعًا لو…» يذهب تحت ليس هدفًا، لا إلى M1. يمكنك دائمًا ترقية «ليس هدفًا» لاحقًا — أمّا مرحلةٌ أولى متضخّمة فهي كيف تتعثّر المشاريع.
استخدامٌ ممتاز للمساعد: أعطِه موجزك والهيكل، واطلب منه أن يقترح قصص المستخدم ونموذج البيانات وتقطيع المراحل. ثم حرّر أنت — اقطع النطاق، صحّح النموذج، أعد الترتيب. المساعد صائغٌ سريع؛ وقرارات المنتج تبقى لك.
ستُنتج ملف SPEC.md حقيقيًّا — يصوغه الذكاء الاصطناعي وتقرّره أنت — بقصص مستخدمٍ ومعايير قبولٍ ونموذج بياناتٍ صغير وتقطيع مراحل. وستسلّم المواصفة المُودَعة.
مستودع snippet-vault من الوحدة 2 (الهيكل + ملف السياق)، ومساعدك.
بكلماتك: أيّ مشكلةٍ تحلّها خزنة المقتطفات ولمن. جملتان أو ثلاث تكفي.
الصق هذا، ثم راجع ما يعود:
حرّر المسوّدة. انقل كل ما ليس جوهريًّا إلى ليس هدفًا. أبقِ 3–5 قصص مستخدم، لكلٍّ معايير قبولٍ ملموسة. وأكّد أن نموذج البيانات هو فقط Snippet: id, title, language, code, createdAt.
رتّب العمل أصغر-مفيدٍ-أوّلًا كقائمة مهامّ بمربّعات (M1 إنشاء+عرض، M2 بحث، M3 حذف…). هذه القائمة تقود كل وحدةٍ متبقّية.
ثم أضِف إلى REFLECTION.md: أيّ «ليس هدفًا» قطعته لإبقاء M1 صغيرة، وأين تضخّمت مسوّدة الذكاء الاصطناعي فقلّمتها؟ ثم أودِعه.
مستودع snippet-vault مع SPEC.md. تحقّق من نفسك قبل التسليم:
SPEC.md فيه الأقسام الستّة كلّها، والحدّ الأدنى مُبقًى صغيرًا| المصطلح | المعنى المبسّط |
|---|---|
| المواصفة (Spec) | مستندٌ قصيرٌ حيّ لما تبنيه ولماذا (SPEC.md). |
| قصّة المستخدم | قدرةٌ واحدة من وجهة نظر المستخدم: بصفتي… أريد… حتى… |
| معايير القبول | الشروط القابلة للفحص التي تجعل القصّة «مكتملة». |
| ليس هدفًا | شيءٌ تختار عمدًا ألّا تبنيه الآن. |
| مرحلة / شريحة | زيادةٌ رفيعة تعمل يمكنك بناؤها وشحنها وحدها. |
| MVP | المنتج الأدنى القابل للتطبيق — أصغر نسخةٍ مفيدةٍ فعلًا. |
ملف SPEC.md مُودَع: المشكلة، وقصص المستخدم بمعايير قبولها، ونموذج بياناتٍ صغير، وواجهة API، وتقطيع مراحل. صار للمساعد عقدٌ دائمٌ يبني عليه — وصار لديك تعريفٌ لـ«الاكتمال».
التالي: الوحدة 4 — التحكم بالإصدارات من السطر الأول. قبل بناء M1، نصقل عادات Git — فرعٌ لكل مرحلة، وإيداعاتٌ نظيفة، ومراجعة كل تغييرٍ مولَّدٍ بالذكاء الاصطناعي كأنه طلب دمج.