حقيبة أدوات أساس البيانات: الملفات التي يستعلم منها فريقك

أنهيت وحدة الأساس بثلاث وثائق: dataset-profile.md وmetrics.md وanalysis-brief.md لطلب حقيقي واحد. هذه الحقيبة تجعلها بنية تحتية. القاموس الذي كتبته مرة ينفعك مرة؛ أما القاموس الذي يستعلم منه فريقك — ويقرؤه Claude في كل مهمة — فينفع كل تقرير، إلى الأبد.

كل ما هنا قابل للنسخ. استبدل بمواضع «ميزان» (علامة مسك الدفاتر الخليجية التي ترافقك محلّلة أعمالها مايا حدّاد في الوحدة) بياناتِك أنت، واحفظ الملفات في المجلد الذي يعمل فيه فريقك، وافتحه في Claude Desktop. من تلك اللحظة، تبدأ كل مهمة تحليل في ذلك المجلد من أعمدتك الحقيقية، وتعريفات مؤشراتك الحقيقية، وعادات ضبط النطاق عندكم — بدل تخمين كل محلّل على حدة.

الحزمة كلها أربعة ملفات وحفنة prompts. وهذا هو المقصود — أساسٌ صغير بما يكفي ليُستعلم منه فعلًا يغلب أساسًا بديعًا يسكن وثيقة لا يفتحها أحد. وأبقِ بيانات العملاء الخام خارجه: هذا المجلد يحمل تعريفات فريقك وأعرافه، لا تصديرًا حيًّا مليئًا بالأسماء والبريد أبدًا.

ملف CLAUDE.md الخاص بالبيانات

هذا هو السياق الدائم الذي يقرؤه Claude تلقائيًا حين يفتح مجلد مشروعك، فلا يعيد أحدٌ شرح مؤشر أو جدول مصدر في كل محادثة. أبقِه قصيرًا ومحدَّثًا — يشير إلى وثائق الأساس ولا يكررها.

# CLAUDE.md — بيانات وتحليلات [اسم الفريق]

## ماذا نفعل
[اسم الفريق] يجيب عن أسئلة البيانات لـ [الشركة] — [وصف المنتج في
سطر]. مصادرنا الرئيسية هي [اذكرها: مثل «جدولا subscriptions
وcustomers، وتصديرات CSV أسبوعية من أداة التسويق»].

## ملفات مصدر الحقيقة الثلاثة — اقرأها أولًا
- metrics.md          ← «ماذا» تعني أرقامنا (منطق حرفي، ومالك،
                        وحالات حدّية لكل مؤشر نبلّغ عنه)
- dataset-profile.md  ← «ماذا» يحتوي مصدرٌ بعينه فعلًا (ملف لكل
                        مصدر، يُعاد توصيفه كلما تغيّر المخطط)
- analysis-brief.md   ← «ماذا» يسأل هذا الطلب بالتحديد (القرار،
                        والسؤال الدقيق، والنطاق) — واحد لكل طلب
                        قائم، لا ملفًا دائمًا واحدًا
راجع metrics.md دائمًا قبل حساب مؤشر له تعريف قائم. وإن احتاج
طلبٌ مؤشرًا ليس في القاموس بعد، فاقترح إضافته — ولا تخترع
تعريفًا عابرًا في محادثة.

## القاعدة الذهبية
وصّف قبل أن تستعلم. طابِق قبل أن تبلّغ. كل إجمالي يغادر هذا
المجلد يُفحص على مصدر ثانٍ — عدد صفوف، أو تقرير سابق، أو رقم
مالية — قبل أن يراه صاحب القرار. الرقم الذي لا تستطيع مطابقته
رقمٌ لا تستطيع الدفاع عنه.

## ثوابت التحقق
- اذكر عدد الصفوف وكيف تحققت منه، في كل مرة تفتح ملفًا جديدًا.
- اقرأ قيمًا حقيقية لكل عمود قبل أن تثق بما يوحي به اسمه.
- سمِّ نسبة الفراغ وعدد التكرارات لأي ملف تبني عليه إجماليًا.
- لا تبلّغ رقمًا أبدًا دون ذكر الـ query أو الملف الذي جاء منه.

## أمان البيانات (DATA SAFETY) — غير قابل للتفاوض
بيانات هوية العملاء — الأسماء، والبريد، ومعرّفات الحسابات غير
المجمَّعة أصلًا — تبقى في مساحة العمل هذه. يقرؤها Claude ليحسب
المجاميع والأنماط؛ ولا يُطلب منه أبدًا تصدير صفوف خام، أو لصق
سجلات كاشفة للهوية في مستند مشترك، أو معالجة بيانات شخصية خارج
هذا المجلد. الرسوم والتقارير لا تغادر هذا المجلد إلا مجمَّعة.

## ما الآمن في هذا المجلد
- آمن: metrics.md، وdataset-profile.md (وصف على مستوى الأعمدة،
  لا صفوف خام)، ونتائج queries مجمَّعة، وعيّنات مجهولة الهوية،
  وصور الرسوم.
- لا يوجد هنا أبدًا: تصديرات عملاء خام بأسماء/بريد، أو سجلات
  تذاكر أو فوترة كاملة، أو أي شيء يحدد شخصًا بعينه. أخبرني إن
  بدا ملفٌ حاملًا لها قبل أن نستخدمه.

على Desktop تنشئ هذا الملف وتعدّله من لوحة الملفات — بلا أي أوامر. ووضع Ask permissions هو ما توصي به وثائق Anthropic للمستخدمين الجدد؛ أبقِه مفعّلًا، وأول مرة يقرأ Claude ملف بيانات ستوافق على القراءة من النافذة.

قالب dataset-profile.md

المقابلة التي يخضع لها كل ملف جديد قبل أن تثق بإجمالي مبني عليه. انضباط «مفحوص على القيم» هو ما يفصل هذا عن لمحة على عناوين الأعمدة.

# dataset-profile.md — [اسم الملف]

## عدد الصفوف
[N] صفًّا. التحقق: [عدّاد أداة التصدير نفسها / العدد الذي توقعه
صاحب الطلب / عدد الفترة الماضية ± فرق معقول]. صرّح بالتطابق أو
بالفجوة صراحةً — لا تقفز فوق هذا السطر.

## الأعمدة
[column_name]
  المعنى: [ما يحتويه فعلًا، مفحوصًا على 20–30 قيمة حقيقية
  معيّنة — لا مفترضًا من العنوان]
  الفراغات: [فارغ في N%، أو «لا شيء»] — [إن وُجدت، فاذكر ما يوحي
  به فحصٌ عشوائي للصفوف الفارغة، وكيف ستعاملها فيما بعد]
  انتبه إلى: [كل ما فاجأك — عمود يكذب، أو طابع زمني ليس ما
  يدّعيه، أو قيم خارج النطاق المتوقع]

[كرر لكل عمود. سطر «انتبه إلى» أعلى سطور الوثيقة قيمةً — إنه
الالتقاطة التي تمنع رسمًا فاسدًا.]

## نطاق التواريخ
من [البداية] إلى [النهاية]. مؤكَّد على: [مرشِّح التصدير المستخدم /
حدث معروف ينبغي أن يقع في النطاق].

## التكرارات
[N] صفًّا مكررًا بالحرف ([صف التطابق: المفتاح نفسه + الطابع
الزمني نفسه، إلخ]). و[N] شبه مكرر (المفتاح نفسه بطابع زمني
مختلف — صرّح: أهو متوقع، كسجلّ تحديثات، أم عيب). القرار: [حُذفت
قبل التبليغ / أُبقيت معلَّمة / يلزم تأكيد مالك نظام المصدر أيها
الصحيح].

## ما يصلح هذا الملف للإجابة عنه، وما لا يصلح
[جملة أو جملتان: بناءً على ما سبق، ما الذي تبنيه من هذا الملف
بثقة، وما الذي يحتاج مصدرًا آخر أو أنظف أولًا.]

قالب metrics.md

القاموس الذي يستشهد به كل query ورسم وتقرير. سطر «المنطق» هو الانضباط كله — إن لم يصلح لأن يصير query دون سؤال لاحق، فهو لم يكتمل بعد.

# metrics.md — [اسم الفريق]

## [اسم المؤشر]
المعنى:  [جملة واحدة بلغة واضحة يفهمها غير المحلّل]
المنطق:  [الترشيح/المعادلة/هيكل الـ SQL الحرفي — بدقة تكفي لأن
         يكتب غريبٌ الـ query من هذا السطر وحده]
المالك:  [شخص مسمًّى أو وظيفة مسمّاة — من يعتمد تغييرات هذا
         التعريف]
حالات حدّية:
  - [حالة حدّية حقيقية وكيف تُحسم — لا «حسب التقدير»]
  - [حالة حدّية حقيقية ثانية وكيف تُحسم]
آخر مراجعة: [التاريخ] — حدّثه واذكر ما تغيّر كلما عُدّل المنطق.
  التقارير القديمة تبقى صحيحة للفترة التي غطّتها؛ والجديدة تستخدم
  التعريف الحالي.

[كرر لكل مؤشر. ابدأ بالمؤشرات الأربعة إلى الستة التي تظهر في
تقريركم الأكثر تكرارًا — هناك يكسب القاموس قيمته أسرع.]

قالب analysis-brief.md

‏brief واحد لكل طلب قائم — ليس وثيقة دائمة، بل قالبًا تملؤه من جديد كلما طلب أحدهم تحليلًا. قسم «خارج النطاق» هو ما يمنع أشيع أنواع إعادة العمل.

# analysis-brief.md — [الطلب، في خمس كلمات أو أقل]

الطلب الأصلي (نصًّا):
  «[الصق رسالة Slack / البريد / عبارة الاجتماع كما هي — لا تُعِد
  الصياغة؛ تريد أن ترى الغامض فيها بالضبط]»

القرار الذي يخدمه: [ما الذي سيفعله أحدهم فعلًا بشكل مختلف بحسب
  الجواب — لا السؤال نفسه]

السؤال الدقيق: [الطلب مترجمًا إلى مفردات metrics.md — سمِّ
  المؤشر (المؤشرات) بالضبط، لا إعادة قول لكلماتهم]

المصادر: [الجداول أو الملفات التي سيُبنى منها]

الشرائح: [كيف يُفصَّل الجواب، إن لزم]

خارج نطاق هذه الجولة:
  - [شيء قد يفترض شخص عاقل أنه داخل، مسمًّى صراحةً مستبعَدًا،
    بسبب من سطر واحد]
  - [استبعاد ثانٍ، إن وُجد]

النطاق مؤكَّد مع صاحب الطلب: [نعم/لا — أكّده قبل أن تبني أي
  شيء يتجاوز نظرة أولى سريعة]

مكتبة الـ prompts المحفوظة (الأساس)

مهام الأساس المتكررة، بصيغة prompts تعيد استخدامها. الصقها في المحادثة والملفات المعنية مفتوحة؛ وفي مسار الـ Terminal والأتمتة تتحول إلى slash commands تستدعيها بضغطة — لكنك لا تحتاج شيئًا من ذلك لتستخدمها اليوم.

وصّف ملفًا جديدًا
  «اقرأ [اسم الملف] من هذا المجلد. أخبرني: عدد الصفوف وكيف أتحقق
   منه من مصدر آخر، ومعنى كل عمود فعلًا بناءً على قيم حقيقية
   معيّنة (لا العنوان وحده)، ونطاق التواريخ الحقيقي، ونسبة الفراغ
   لكل عمود، وأي صفوف مكررة تامّة أو شبه تامّة. وعلّم كل ما يبدو
   مخالفًا لما يوحي به اسم عموده.»
  "Read [file name] from this folder. Tell me: the row count and how I
   could verify it against another source, what every column actually
   means based on real sampled values (not just the header), the real
   date range, the blank rate per column, and any exact or near-duplicate
   rows. Flag anything that looks like it doesn't match what its column
   name implies."

اصُغ تعريف مؤشر أو حدّثه
  «اقرأ metrics.md. نحتاج تعريفًا لـ: [اسم المؤشر، مثل 'معدل
   التحويل من التجربة إلى الدفع']. اقترح: معنًى واضحًا في جملة،
   والمنطق الحرفي ترشيحًا/معادلة، و2–3 حالات حدّية مع حسم كلٍّ
   منها. وعلّم إن كان هذا يتداخل مع مؤشر قائم في الملف أو يكرره.»
  "Read metrics.md. We need a definition for: [metric name, e.g. 'trial-
   to-paid conversion rate']. Propose: a one-sentence plain meaning, the
   exact logic as a filter/formula, and 2-3 edge cases with how each
   should resolve. Flag if this overlaps with or duplicates an existing
   metric in the file."

حوّل طلبًا فضفاضًا إلى brief
  «هذا طلب وصلني للتوّ: [الصقه نصًّا]. باستخدام metrics.md
   مفرداتٍ، سوّد analysis-brief.md: أي قرار يخدمه هذا على
   الأرجح، والسؤال الدقيق مترجمًا إلى أسماء مؤشراتنا، والمصادر
   والشرائح، وشيء واحد على الأقل قد يفترض شخص عاقل أنه داخل
   النطاق وينبغي أن نستبعده صراحةً هذه الجولة.»
  "Here's a request I just got: [paste it verbatim]. Using metrics.md as
   the vocabulary, draft an analysis-brief.md: what decision this likely
   informs, the precise question translated into our metric names, the
   sources and segments, and at least one thing a reasonable person might
   assume is in scope that we should explicitly exclude this round."

طابِق رقمًا قبل أن يخرج
  «هذا إجمالي أوشك أن أبلّغ عنه: [الصق الرقم وكيف حُسب]. افحصه
   على [مصدر ثانٍ / إجمالي معروف / رقم الفترة الماضية]. أخبرني
   هل يُطابَق، وإن لم يُطابَق فامشِ بي على أرجح أسباب الفجوة
   (اختلاف ترشيح، أو حدّ تاريخ، أو صفوف مكررة، أو دمج أسقط
   سجلات أو كررها).»
  "Here's a total I'm about to report: [paste the number and how it was
   computed]. Check it against [a second source / a known total / last
   period's figure]. Tell me if it reconciles, and if not, walk through
   the most likely reasons for the gap (filter mismatch, date boundary,
   duplicate rows, a join that dropped or duplicated records)."

اختبر تعريف مؤشر تحت ضغط الحالات الحدّية
  «اقرأ تعريف المؤشر هذا: [الصقه]. جِد 3 مواقف واقعية قد يعالجها
   هذا المنطق خطأً أو بالتباس — عميل يفعل شيئًا غير معتاد، أو
   حالة توقيت حدّية، أو status لا تنطبق بنظافة. ولكلٍّ، أخبرني
   بما سيحسبه المنطق الحالي وهل ذلك هو الجواب الصحيح فعلًا.»
  "Read this metric definition: [paste it]. Find 3 real-world situations
   this logic might handle wrong or ambiguously — a customer who does
   something unusual, a timing edge case, a status that doesn't cleanly
   fit. For each, tell me what the current logic would compute and
   whether that's actually the right answer."

التثبيت (على Desktop، بلا تهيئة)

1. احفظ الملفات الأربعة — CLAUDE.md، وdataset-profile.md (واحد لكل مصدر تستعلم منه بانتظام)، وmetrics.md، وanalysis-brief.md (قالب يُملأ من جديد لكل طلب) — في المجلد الذي يعمل فيه فريقك.
2. افتح ذلك المجلد في Claude Desktop ووافق على القراءة من نافذة Ask permissions.
3. ابدأ أي مهمة بفتح الوثائق المعنية؛ والـ prompts أعلاه تتكفل بالباقي.

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