قالب الموجز والمواصفات

This content is not available in your language yet.

كل مشروع في حسنات مجلد في مستودع hasanat-dev/projects، باسم يبدأ برقمه مثل 04-project-name. في المجلد ملفان:

brief.md: الموجز المختصر. منه يُولَّد brief.pdf ونص رسالة واتساب whatsapp.txt.
spec.md: المواصفات التفصيلية: النسخة الأولى ومعايير قبولها، والتجربة، والأدوار، والأسئلة المفتوحة.

لبدء مشروع جديد انسخ مجلد _template في المستودع، أو انسخ الملفين من هذه الصفحة. اجعل number في الموجز مطابقًا لرقم المجلد.

كيف نكتب

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

الموجز

جدول الأدوار عمودان: الدور، وماذا ستفعل. يمكن إضافة عمود ثالث للوقت إن كان التقدير موثوقًا.

يتوقّف توليد الموجز برسالة واضحة إن نقص قسم مطلوب أو تغيّر عنوانه، لتبقى كل الموجزات على القالب نفسه. لذلك لا تغيّر عناوين الأقسام.

---
number: 0
stage: تشكيل الفريق
duration: 6 أسابيع
team: 3–4 متطوّعين
lead: اسم قائد المشروع
join_by: 2026-10-09
updated: 2026-10-01
---

# اسم المشروع

جملة واحدة تقول ماذا يفعل المشروع ولمن.

## المشكلة

من يعاني من ماذا اليوم، ولماذا تستحق المشكلة العمل عليها؟ جملتان أو ثلاث بلغة بسيطة، دون مصطلحات تقنية.

## الفكرة

الفكرة الأساسية للحل، كما يراها المستخدم.

## الرؤية بعيدة المدى

جملة عن الاتجاه الذي نطمح إليه. ليست ضمن النسخة الأولى.

## ما الموجود اليوم

- ما القائم الآن: منتج يعمل، أو موقع قديم، أو كود، أو وثائق، أو مستخدمون
- أو: لا شيء بعد، نبدأ من الفكرة

## النسخة الأولى

- أبسط ما يُكمل الدورة الأساسية للمستخدم
- وظيفة ثانية لا تكتمل الأولى دونها
- وظيفة ثالثة فقط إن كانت ضرورية

## نؤجّله لمراحل لاحقة

- فكرة جيدة نؤجّلها حتى نتعلّم من التجربة
- فكرة أخرى نؤجّلها

## التجربة الأولى

- مع من نجرّب، وكم، وإلى متى
- ماذا نراقب
- متى نعدّ التجربة ناجحة

## الأدوار المطلوبة

| الدور | ماذا ستفعل |
| --- | --- |
| تطوير | بناء النسخة الأولى بمساعدة وكلاء البرمجة. يكفي متطوّع واحد |
| تنسيق التجربة | تنظيم التجربة مع المستخدمين، وجمع ملاحظاتهم |

## طريقة العمل

- الوقت مرن: يتّفق كل متطوّع مع الفريق على ما يناسبه
- لقاء أسبوعي قصير عبر الإنترنت
- مجموعة واتساب للفريق، والمهام على GitHub

المواصفات

المواصفات للفريق ولوكلاء البرمجة، وهي المرجع في النطاق والقرارات. أهم أقسامها:

5. النسخة الأولى: لكل وظيفة معايير قبول يمكن فحصها.
6. نؤجّله لمراحل لاحقة: ما لن نبنيه الآن حتى لو طُلب.
7. التجربة الأولى: مع من، وكيف، وماذا نقيس، ومتى تنجح.
11. أسئلة مفتوحة: لا يفترض أحد إجابتها؛ يُسأل القائد ثم يُسجَّل القرار.
12. للبدء مع وكيل البرمجة: رسالة جاهزة لبدء العمل.

# اسم المشروع — المواصفات

> للفريق ولوكلاء البرمجة. الموجز المختصر في [brief.md](brief.md).
>
> الحالة: مسودة · آخر تحديث: 2026-10-01 · يعتمد التغييرات: قائد المشروع

## 1. المشكلة ولماذا تستحق العمل

من يعاني من ماذا، وما الذي يفعله اليوم بدلًا من ذلك، ولماذا يستحق الأمر جهد المتطوّعين. اكتب الفرضية التي نختبرها إن وُجدت.

## 2. الفكرة الأساسية

الحل في فقرة، وأدوار المستخدمين فيه.

## 3. الرؤية بعيدة المدى

ليست ضمن النسخة الأولى. تساعد على فهم الاتجاه فقط.

## 4. ما الموجود اليوم

ما القائم الآن: منتج يعمل، أو موقع قديم، أو كود، أو بيانات، أو وثائق، أو مستخدمون. اذكر الروابط وما يمكن إعادة استخدامه، أو اكتب أنه لا شيء بعد.

## 5. النسخة الأولى

أبسط نسخة تُكمل الدورة الأساسية وتختبر الفكرة. لكل وظيفة معايير قبول يمكن فحصها:

### 5.1 اسم الوظيفة

- [ ] معيار قبول يمكن فحصه
- [ ] ...

## 6. نؤجّله لمراحل لاحقة

ما لن نبنيه الآن حتى لو طُلب. أي إضافة تحتاج موافقة قائد المشروع أولًا.

- ...

## 7. التجربة الأولى مع مستخدمين حقيقيين

- **مع من:** ...
- **كيف:** ...
- **ماذا نقيس:** ...
- **متى تنجح:** ...

## 8. الأدوار

نفترض متطوّعًا تقنيًا واحدًا يبني معظم النسخة الأولى بمساعدة وكلاء البرمجة. الأدوار الأخرى، كالمحتوى والمجتمع وتنظيم التجربة، لا يُستغنى عنها. لا نحدّد ساعات ثابتة: يتّفق كل متطوّع مع الفريق على ما يناسب وقته.

| الدور | المهمة |
| --- | --- |
| تطوير | ... |

## 9. البيانات والخصوصية

ما الذي نحفظه، ومن يراه، وما الذي لا نجمعه أبدًا.

## 10. نقطة البداية التقنية

الفريق يقرّر. الاقتراح الافتراضي: [قالب حسنات](https://github.com/hasanat-dev/starter) (Astro وCloudflare).

## 11. أسئلة مفتوحة

لا تفترض إجابة: اسأل قائد المشروع، ثم سجّل القرار هنا.

- [ ] ...

## 12. للبدء مع وكيل البرمجة

```text
اقرأ AGENTS.md في جذر المستودع، ثم brief.md وspec.md في مجلد المشروع.
ابنِ «النسخة الأولى» فقط، والتزم «نؤجّله لمراحل لاحقة».
لا تفترض إجابة لأي «سؤال مفتوح»: اسألني أولًا.
ابدأ بخطة قصيرة، ثم بخطوة صغيرة واحدة يمكن فحصها في المتصفح.
```

توليد الموجز

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

npm install
npm run brief -- 04-project-name

يُنشئ الأمر brief.pdf وwhatsapp.txt في مجلد المشروع، وتضيف --png صورة للمعاينة. الخط المستخدم IBM Plex Sans Arabic، برخصة OFL.

مع وكيل البرمجة

يقرأ وكيل البرمجة ملف AGENTS.md في جذر المستودع أولًا. يمكنك أن تبدأ برسالة مثل:

اقرأ AGENTS.md، ثم _template/brief.md و_template/spec.md.
ساعدني في كتابة موجز ومواصفات لمشروع جديد بالقالب نفسه.
اسألني عن المشكلة ومن يعاني منها قبل أن تقترح حلًّا، ولا تخترع أرقامًا أو مصادر.

حين تكتمل المسودة، أرسلها طلب سحب. انظر من المواصفات إلى النسخة الأولى.