قبل أي كود: اكتب موجز المشروع

الهدف

بعد هالدرس تقدر تكتب project brief من صفحة وحدة، تحدد 3 user personas، وتسمي الـ value proposition بجملة وحدة. هذا يحميك من الـ feature creep ويخليك تبني الشي الصح من البداية.

ليش هذا الحين؟

أكثر ناس يبدأون بالكود مباشرة، وبعدين يكتشفون إنهم بنوا الشي الغلط. الـ brief ما يأخذ وقت — يوفر وقت. لو ما عندك clarity على المشكلة والمستخدم والـ value، كل قرار بعدها راح يكون تخمين. هالدرس هو الـ foundation اللي ينبني عليه كل شي جاي.

الفكرة

الـ project brief وثيقة بسيطة — صفحة وحدة — تجاوب على أسئلة أساسية قبل ما تكتب سطر كود.

ليش brief ومو كود على طول؟ لأن الكود رخيص، والوقت غالي. لو بنيت feature غلط، تحتاج تهدمها وتبنيها من جديد — وهذا وجع. الـ brief يخليك تفكر قبل ما تبني.

المكونات الأساسية للـ brief:

Problem — مين عنده المشكلة؟ وشنو هي؟
Solution — كيف نحلها؟
Target user — مين بالضبط؟ (مو "الكل")
Value prop — ليش يختارون منتجك وما غيره؟
Success metrics — كيف تعرف إنك نجحت؟
Out of scope (v1) — شنو ما تبنيه الحين؟

الـ user personas: مو مجرد "شخص يستخدم التطبيق". الـ persona له اسم، عمر، وظيفة، pain points محددة، وأهداف واضحة. كلما كان أدق، كلما قراراتك صارت أوضح.

الـ value proposition: جملة وحدة: "لـ [مستخدم]، [منتجنا] هو أسرع طريقة لـ [نتيجة]." لو ما تقدر تكتبها، المنتج مو واضح بعد.

الـ scope discipline: قائمة "out of scope" مهمة نفس أهمية قائمة "in scope". كل feature تحذفها من v1 = وقت توفره.

سوّها

افتح editor وسوي ملف BRIEF.md في جذر المشروع. ترى هذا أهم ملف في المشروع — أهم من أي كود.

# [اسم المشروع]

## Problem
[جملة وحدة: مين عنده المشكلة؟]

## Solution
[جملة وحدة: كيف نحلها؟]

## Target user
[persona وحدة — محدد جدا]

## Value prop
For [user], [product] is the fastest way to [outcome].

## Success metrics
- 100 signups in 30 days
- 30% activation rate
- $500 MRR by day 90

## Out of scope (v1)
- Mobile app
- Team features
- Custom domains
- Real-time collaboration
- API integrations

اكتب 3 personas — المفروض تكون محددة مو عامة:

## Personas

### Primary: سارة، 28 سنة، مصممة فريلانس في الكويت
- **Pain**: تنسى عادات شغلها اليومية
- **Goal**: تتابع إنجازاتها بدون تعقيد

### Secondary: أحمد، 35 سنة، مدير مشاريع
- **Pain**: يبدأ عادات جديدة بس ما يكملها
- **Goal**: يشوف progress واضح

### Edge case: نورة، 22 سنة، طالبة جامعة
- **Pain**: تحتاج reminder بس ما تبي app ثقيلة
- **Goal**: شي بسيط يشتغل بسرعة

اكتب الـ value prop بجملة وحدة:

For busy professionals in Kuwait, [AppName] is the fastest way to build daily habits without the overhead of complex apps.

الحين اقرأها بصوت عالي. لو ما صارت واضحة في 5 ثواني، اكتبها من جديد.

اكتب 5 أشياء ما تبنيها في v1 — هذي أهم خطوة:

## Out of scope (v1)
1. Mobile app (web first)
2. Social features / sharing
3. Custom branding
4. Team / group habits
5. API integrations

خوش، الحين عندك boundaries واضحة. كل مرة جاك "خل نضيف feature"، ترجع للـ brief وتقول "مو v1".

احفظ الملف وراجعه — المفروض تقدر تقرأه كامل في أقل من دقيقتين. لو أطول من جذي، بسّط.

تأكّد

BRIEF.md موجود في جذر المشروع ✓
عندك Problem + Solution بجملة وحدة لكل واحد ✓
عندك 3 personas كل وحدة بـ name/age/role/pain/goal ✓
الـ value prop جملة وحدة واضحة ✓
قائمة "out of scope" فيها ≥5 بنود ✓
تقدر تقرأ كل الـ brief في دقيقتين ✓

إذا خرب شي

"ما عرفت أملأ الـ problem" — علامة إن الفكرة مو واضحة بعد. اقعد ويا واحد من الـ target audience واسأله عن يومه. المشكلة راح تطلع.

"كتبت personas بس كلها متشابهة" — يعني ما فكرت عدل. كل persona المفروض تأثر على قرارات design مختلفة. لو ما تأثر، اجمعهم في وحدة.

"الـ value prop طويلة وما تخلص" — صورة المنتج مو مرتبة في راسك. ارجع للـ Problem واسأل: "شنو أسرع طريقة أحل هذا؟" الجواب هو الـ value prop.

"اخترت 10 success metrics" — كثير. اختار 3 بس: واحد للـ acquisition، واحد للـ activation، وواحد للـ revenue. غير جذي كله distraction.

"ما أقدر أحدد out of scope" — يعني عندك FOMO على features. تذكر: كل feature تضيفها = وقت + complexity. الـ v1 مفروض يكون أصغر من اللي تتصوره.

شنو بعد؟

الدرس الجاي نبدأ الكود فعلا — نبني scaffold كامل لتطبيق Next.js من الصفر ونشغله محليا في أقل من 15 دقيقة.