أنهيت وحدة الأساس بوثيقتين: stakeholder-map.md وrequirements.md لمبادرتك. هذا الدليل يحوّلهما إلى بنية تحتية. ملف كتبته مرة واحدة يفيدك مرة واحدة؛ ملف يثبّته فريقك — يقرأه Claude في كل مهمة — يفيد كل مبادرة، إلى الأبد.
كل شيء هنا قابل للنسخ. استبدل عناصر Mizan النموذجية (مبادرة “الاعتراض على رسوم” من الوحدة) بمبادرتك الخاصة، احفظ الملفات في المجلد الذي يعمل فيه فريقك، وافتحه في Claude Desktop. من تلك اللحظة، كل مهمة متطلبات في ذلك المجلد تبدأ من أصحاب مصلحتك الفعليين والنطاق المتّفق عليه بدل تخمين كل شخص.
الحزمة كاملة ثلاثة ملفات وحفنة من الـ prompts. هذا هو الهدف — أساس صغير بما يكفي ليُثبَّت فعلاً يتفوّق على أساس جميل يعيش في وثيقة لا يفتحها أحد.
ملف CLAUDE.md الخاص بـ Business Analyst
هذا هو السياق الثابت الذي يقرأه Claude تلقائيًا عند فتح مجلد مشروعك، حتى لا يعيد أحد شرح المبادرة كل محادثة. أبقِه قصيرًا ومحدَّثًا — يشير إلى الوثيقتين المرجعيتين بدل تكرارهما.
ترجمة:
# CLAUDE.md — متطلبات [اسم المبادرة]
## من نحن
نحن وظيفة Business Analyst التي تدير المتطلبات لـ [المبادرة — سطر واحد،
مثال: "ميزة اعتراض على الرسوم موجّهة للعملاء تلامس Support وFinance
وData وEngineering"]. أصحاب المصلحة يمتدون عبر [الفرق/الأدوار].
## الوثيقتان المرجعيتان — اقرأهما أولاً
- stakeholder-map.md → من هو معني (القائمة، جدول RACI، اسم Accountable
واحد لكل قرار)
- requirements.md → ماذا نبني (النطاق، المتطلبات الوظيفية وغير
الوظيفية، كل واحدة متتبّعة إلى صاحب مصلحة مسمّى)
- requirements-ar.md → وثيقة المتطلبات العربية (مؤلَّفة، لا مترجمة)،
حيث تحتاجها مجموعة أصحاب مصلحة
اقرأ الملفات ذات الصلة دومًا قبل صياغة أي شيء تالٍ. إن تعارضت مسودة معها،
الملفات تفوز — أشِر إلى التعارض، لا تتجاوزه بهدوء.
## كيف نعمل معك
- أنت تسوّد؛ صاحب مصلحة مسمّى يقرر. لا تختلق أبدًا ما قد يقوله صاحب
مصلحة — إن لم تكن حاجته مؤكَّدة، أشِر إليها كفجوة مفتوحة، لا تملأها
من انطباع عام.
- اسأل قبل أن تفترض. تخمين متنكّر في شكل متطلب هو الخطأ الأعلى تكلفة
الذي يمنعه هذا الملف.
- القاعدة الأساسية: كل متطلب يتتبّع إلى اسم. لا استثناءات — سطر غير
قابل للتتبّع هو علامة تحذير، لا متطلبًا نهائيًا.
## ما هو آمن في هذا المجلد
- آمن: ملاحظات مقابلات تحمل أسماء زملاء بصفتهم المهنية، مسودات متطلبات،
خرائط عمليات، مقاييس إجمالية.
- ممنوع أبدًا هنا: بيانات عملاء شخصية تتجاوز ما يحتاجه المتطلب للإشارة
إليه، الرواتب، شكاوى الموارد البشرية، أي شيء تحت اتفاقية سرية. أخبرني
إن بدا ملف يحتوي عليها.
## القواعد الأساسية
- كل متطلب، وظيفي أو غير وظيفي، يسمّي صاحب مصلحته المصدر — أو يبقى
مُعلَّمًا بوضوح حتى يفعل.
- كل قرار في جدول RACI يحمل اسم Accountable واحدًا بالضبط، مؤكَّدًا من
ذلك الشخص، لا مفترَضًا من مسمّاه الوظيفي.
# CLAUDE.md — [Initiative name] requirements
## Who we are
We're the BA function running requirements for [initiative — one line,
e.g. "a customer-facing dispute-a-charge feature touching Support,
Finance, Data, and Engineering"]. Stakeholders span [teams/roles].
## The two source-of-truth files — read these first
- stakeholder-map.md → WHO is in this (roster, RACI, one Accountable
name per decision)
- requirements.md → WHAT we're building (scope, functional +
non-functional requirements, each traced to a
named stakeholder)
- requirements-ar.md → the Arabic requirements doc (authored, not
translated), where a stakeholder group needs it
Always read the relevant ones before drafting anything downstream. If a
draft conflicts with them, the files win — flag the conflict, don't
quietly override it.
## How we work with you
- You draft; a named stakeholder decides. Never invent what a
stakeholder would say — if their need isn't confirmed, flag it as
open, don't fill it in from a general impression.
- Ask before assuming. A guess dressed up as a requirement is the
single most expensive mistake this file exists to prevent.
- The house rule: every requirement traces to a name. No exceptions —
an untraceable line is a flag, not a finished requirement.
## What's safe in this folder
- Safe: interview notes with names of colleagues in their professional
capacity, requirements drafts, process maps, aggregate metrics.
- Never here: customer PII beyond what a requirement needs to reference,
salaries, HR complaints, anything under NDA. Tell me if a file looks
like it contains them.
## House rules
- Every requirement, functional or non-functional, names its source
stakeholder — or stays visibly flagged until it does.
- Every RACI decision has exactly one Accountable name, confirmed by
that person, not assumed from a title.على Desktop تنشئ هذا الملف وتعدّله في لوحة الملفات — بلا أوامر. مستندات Anthropic تصف وضع “Ask permissions” بأنه الموصى به للمستخدمين الجدد؛ أبقِه مفعّلاً، وفي أول مرة يقرأ فيها Claude هذا الملف ستوافق عليه في النافذة.
قالب stakeholder-map.md
الخريطة التي تُخطئها الفرق بتقييم الأهمية بدل التأثير والاهتمام كلًا على حدة، وبتسمية Accountable حسب الأقدمية بدل من يستطيع فعلاً جعل القرار ثابتًا. هذا القالب يفرض التمييزين صراحةً.
ترجمة:
# stakeholder-map.md — [المبادرة]
## القائمة (غير مصفّاة — كل شخص أو مجموعة معنية)
- [الاسم، الدور] — [ملاحظة سطر واحد عن علاقته بالمبادرة]
- [الاسم، الدور] — [...]
(أدرِج الجميع قبل ترتيب أي أحد. الشخص الذي تستبعده هنا هو من يمنع
الموافقة لاحقًا.)
## التأثير / الاهتمام / الحاجة
| صاحب المصلحة | التأثير | الاهتمام | ما يحتاجه تحديدًا |
|---|---|---|---|
| [الاسم] | مرتفع/متوسط/منخفض | مرتفع/متوسط/منخفض | [بكلماته، لا مفترَض] |
⚠ تأثير مرتفع / اهتمام منخفض (أشِر صراحةً — لن يلاحقك):
- [الاسم] — [لماذا يهم رغم هدوئه الآن]
## RACI — اسم Accountable واحد بالضبط لكل قرار
| القرار | Responsible | Accountable | Consulted | Informed |
|---|---|---|---|---|
| [مثال: النطاق النهائي] | [الاسم] | [اسم واحد] | [أسماء] | [أسماء] |
| [مثال: تاريخ الإطلاق] | [الاسم] | [اسم واحد] | [أسماء] | [أسماء] |
## الفجوات المفتوحة (لا تخمينات)
- [صاحب المصلحة] — [ما هو غير مؤكَّد، ومن يتابعه]
# stakeholder-map.md — [Initiative]
## Roster (unfiltered — every person or group connected)
- [Name, role] — [one-line note on their connection to the initiative]
- [Name, role] — [...]
(List everyone before ranking anyone. The person you cut here is the
one who blocks sign-off later.)
## Influence / interest / need
| Stakeholder | Influence | Interest | What they specifically need |
|---|---|---|---|
| [Name] | High/Med/Low | High/Med/Low | [in their words, not assumed] |
⚠ High-influence / low-interest (flag explicitly — they won't chase you):
- [Name] — [why they matter even though they're quiet right now]
## RACI — one Accountable name per decision
| Decision | Responsible | Accountable | Consulted | Informed |
|---|---|---|---|---|
| [e.g. final scope] | [name] | [ONE name] | [names] | [names] |
| [e.g. go-live date] | [name] | [ONE name] | [names] | [names] |
## Open gaps (not guesses)
- [Stakeholder] — [what's unconfirmed, and who's chasing it]قالب requirements.md
الوثيقة التي تجعل قابلية التتبّع بنيويّة، لا طموحة. عمود التتبّع هو الانضباط — متطلب بلا عمود تتبّع لا يُسلَّم كمحسوم.
ترجمة:
# requirements.md — [المبادرة]
## سجل المراجعات
| التاريخ | الإصدار | ما تغيّر | وافق عليه |
|---|---|---|---|
## الخلفية
[3-4 جمل: لماذا توجد هذه المبادرة، ما المشكلة التي تحلّها، ما الذي أطلقها.]
## النطاق
داخل النطاق:
- [...]
خارج النطاق:
- [...] (كن محددًا هنا مثل داخل النطاق تمامًا — هذا هو الخط الذي
يمنع أكبر عدد من النزاعات)
يحتاج قرار نطاق (لم يُحسم بعد):
- [...]
## المتطلبات الوظيفية
FR-01 يجب أن يقوم النظام/العملية بـ [...].
يتتبّع إلى: [الاسم، الدور] — "[ما قاله فعلاً]"
FR-02 [...]
⚠ مُعلَّم — مُصاغ من انطباع عام، لا من صاحب مصلحة مسمّى. أكِّد مع:
[من].
## المتطلبات غير الوظيفية
NFR-01 [الأداء / الأمان / الامتثال / سهولة الاستخدام / التوفّر]
يتتبّع إلى: [الاسم] — [...]، أو مُعلَّم كسؤال مفتوح إن لم يتطرّق
له أحد في المقابلات.
## الأسئلة المفتوحة (مرتّبة بالأولوية — الأكثر تعطيلاً أولاً)
1. [السؤال] — المالك: [الاسم]. يمنع: [أي عمل تالٍ].
2. [...]
# requirements.md — [Initiative]
## Revision log
| Date | Version | What changed | Approved by |
|---|---|---|---|
## Background
[3–4 sentences: why this initiative exists, what problem it solves,
what triggered it.]
## Scope
In scope:
- [...]
Out of scope:
- [...] (be as specific here as in-scope — this is the line that
prevents the most disputes)
Needs a scope decision (not yet resolved):
- [...]
## Functional requirements
FR-01 The system/process shall [...].
Traced to: [Name, role] — "[what they actually said]"
FR-02 [...]
⚠ FLAGGED — drafted from general impression, not a named
stakeholder. Confirm with: [who].
## Non-functional requirements
NFR-01 [performance / security / compliance / usability / availability]
Traced to: [Name] — [...], or flagged as an open question if
nobody addressed it in interviews.
## Open questions (prioritized — blockers first)
1. [Question] — owner: [Name]. Blocks: [what downstream work].
2. [...]مكتبة الـ prompts المحفوظة (الأساس)
المهام المتكررة في الأساس، كـ prompts تعيد استخدامها. الصقها في المحادثة مع فتح الملفات المناسبة؛ في مسار Terminal & Automation تتحوّل هذه إلى أوامر شرطة مائلة (slash commands) فتصبح ضغطة زر واحدة، لكنك لا تحتاج شيئًا من ذلك لاستخدامها اليوم.
ترجمة:
صياغة وثيقة متطلبات من ملاحظات خام
"اقرأ ملاحظات المقابلة هذه وstakeholder-map.md. صُغ المتطلبات الوظيفية
وغير الوظيفية — واحد لكل سطر، كل واحد متتبّع إلى صاحب المصلحة المحدد
الذي يُلبّي حاجته، مع اقتباس أو إعادة صياغة ما قاله فعلاً. أشِر إلى
أي متطلب صيغ من انطباع عام لا من شيء قاله شخص مسمّى تحديدًا."
رصد المتطلبات غير المتتبَّعة
"اقرأ requirements.md. أدرِج كل متطلب وظيفي وغير وظيفي لا يحمل تتبّعًا
إلى صاحب مصلحة مسمّى، أو يحمل تتبّعًا غامضًا ('الشركة'، 'المستخدمون' —
لا اسم حقيقي). لكل واحد، أخبرني بالضبط من أحتاج تأكيده معه قبل أن
يُعامَل كمحسوم."
اختبار جدول RACI تحت الضغط
"اقرأ stakeholder-map.md. لكل قرار في جدول RACI، أكِّد وجود اسم
Accountable واحد بالضبط — أشِر إلى أي قرار بلا اسم أو بأكثر من اسم.
أشِر أيضًا إلى أي صاحب مصلحة قُيِّم عالي التأثير منخفض الاهتمام ولم
يُسمَّ بوضوح كخطر يجب مراقبته."
ترجمة هذا لصاحب مصلحة ناطق بالعربية
"اقرأ requirements.md وملاحظات المقابلة العربية هذه لـ [مجموعة أصحاب
المصلحة]. ألّف requirements-ar.md من الملاحظات العربية مباشرة — لا
ترجمة للملف الإنجليزي — بسجل تقرأه هذه المجموعة كأنه أصلي، وأكِّد أن
كل متطلب لا يزال يتتبّع إلى نفس الشخص والاقتباس كنظيره الإنجليزي."
إغلاق قائمة الفجوات
"اقرأ قائمة الأسئلة المفتوحة في requirements.md وقائمة الفجوات في
stakeholder-map.md. أعِد ترتيب الاثنتين حسب مدى تعطيلهما للموافقة
التالية، وأخبرني، لكل واحدة، بالضبط من أحتاج أن أسأله — لا تقترح
افتراضًا لملء الفجوة بدلاً من ذلك."
Draft a requirements doc from raw notes
"Read these interview notes and stakeholder-map.md. Draft functional
and non-functional requirements — one per line, each traced to the
specific stakeholder whose need it satisfies, quoting or paraphrasing
what they actually said. Flag any requirement drafted from a general
impression rather than something a named person specifically said."
Spot untraced requirements
"Read requirements.md. List every functional and non-functional
requirement that has no named stakeholder trace, or whose trace is
vague ('the business', 'users' — not a real name). For each, tell me
exactly who I need to go confirm it with before this can be treated
as settled."
Pressure-test the RACI
"Read stakeholder-map.md. For every decision in the RACI, confirm
there is exactly one Accountable name — flag any decision with zero,
or more than one. Also flag any stakeholder scored high-influence but
low-interest who isn't clearly named as a risk to watch."
Translate this for an Arabic-speaking stakeholder
"Read requirements.md and these Arabic interview notes for [stakeholder
group]. Author requirements-ar.md from the Arabic notes directly — not
a translation of the English file — in a register this stakeholder
group would read as native, and confirm every requirement still traces
to the same person and quote as its English counterpart."
Close the gap list
"Read the open-questions list in requirements.md and the gap list in
stakeholder-map.md. Reorder both by how much they block downstream
sign-off, and tell me, for each, exactly who I need to go ask —
don't suggest an assumption to fill the gap instead."تثبيته (Desktop، بلا إعداد)
- احفظ الملفات الثلاثة —
CLAUDE.md،stakeholder-map.md،requirements.md(إضافةrequirements-ar.mdلمجموعات أصحاب المصلحة ثنائية اللغة) — في المجلد الذي يعيش فيه عمل Business Analyst لديك. - افتح ذلك المجلد في Claude Desktop ووافق على القراءة في نافذة “Ask permissions”.
- ابدأ أي مهمة بفتح الوثائق المناسبة؛ الـ prompts أعلاه تتولى الباقي.
هذا هو التثبيت بأكمله. الأساس الذي بنيته في الوحدة أصبح الآن بنية تحتية مشتركة — والوحدة 2 من المسار توسّع هذه الحزمة نفسها بقوالب تحليل الفجوات وتحليل الخيارات المبنية عليها. إن كنت تُطبّق هذا عبر فريق بدلاً من نفسك، اقرأ دليل التشغيل لطبقة أمان البيانات والموافقة التي تقع تحت كل هذا.