تم منح الوصول

    Claude Code
    دليل مصغّر

    كيف تستخدم Claude Code لتصبح أكثر إنتاجية بمئة ضعف. دليل نظام متكامل لعمّال المعرفة.

    Iwo Szapar

    من يعلّمك هذا

    Iwo Szapar

    شاركت في تأسيس AI Maturity Index (استحوذت عليها ISG، Nasdaq: III في يناير 2026). ساعدت أكثر من 3000 شركة على تغيير طريقة عملها. ظهرت في Financial Times و Forbes، وأدير عملي بالكامل عبر النظام نفسه الذي أنت على وشك تعلّمه.

    المؤهلات:

    • • أكثر من 1164 يومًا من الاستخدام اليومي للذكاء الاصطناعي
    • • أكثر من 30 وكيلًا مخصصًا في بيئة الإنتاج
    • • بناء 3 منتجات مدعومة بالذكاء الاصطناعي
    • • مستشار لفرق ضمن Fortune 500

    ما الذي يميّزني:

    • • هندسة السياق، لا حيل المطالبات
    • • نظام حقيقي يضم أكثر من 30 وكيلًا (لا مجرّد نظريات)
    • • تركيز على غير المختصّين تقنيًا

    كيف تتنقّل في هذا الدليل

    هذا الدليل منظّم في 6 مراحل متدرّجة، إضافةً إلى طبقة جديدة من هندسة الـ harness من أجل عمل موثوق بالذكاء الاصطناعي.

    المرحلتان 1-2: الأساسيات (15 دقيقة)

    افهم ماهية Claude Code وثبّته

    المرحلتان 3-4: القوة الجوهرية (30 دقيقة)

    الكشف التدريجي والـ hooks والوكلاء والمهارات والتعلّم التراكمي

    المرحلة 5: المستوى المتقدّم (20 دقيقة)

    عمليات تكامل MCP لربط أدوات عملك

    المرحلة 6: التطبيق (10 دقائق)

    طريقك إلى الأمام مع قوالب جاهزة

    نصيحة احترافية: انقر على عناوين الأقسام للتوسيع أو الطيّ. وفّر وقتك بالتركيز على ما تحتاجه أكثر.

    البداية السريعة: أوّل 10 دقائق لك

    أتريد رؤية السحر قبل قراءة النظرية؟ اختر إعدادك وافعل هذا الآن.

    1

    ثبّت Claude Code (دقيقتان)

    curl -fsSL https://claude.ai/install.sh | bash
    2

    افتح الطرفية وصادِق على هويتك وابدأ

    claude login
    claude
    3

    قل هذا (انسخه والصقه حرفيًا):

    "Research the top 3 competitors in my space and
    summarize their pricing models. Run them in parallel
    with subagents."
    4

    شاهد Claude يطلق عدة وكلاء تلقائيًا

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

    أتستخدم Claude Code فعلًا؟ انتقل مباشرةً إلى المرحلة 4: الوكلاء والمهارات والـ hooks والـ harnesses لأنماط التنسيق المتقدّمة.

    المرحلة 1

    الفهم: التحوّل من المحادثة إلى ذكاء اصطناعي مبني على المستودع

    مقدّمة في 30 ثانية

    Claude Code هو وكيل برمجة بالذكاء الاصطناعي من Anthropic، يعمل عبر طرفيتك وبيئة التطوير المتكاملة وتطبيق سطح المكتب والمتصفّح. ما زالت الجلسات تبدأ من جديد في كل مرة، لكن مستودعك يستطيع حمل سياق دائم عبر ملفات مثل CLAUDE.md و .claude/rules/ والمهارات والوكلاء ووثائق المشروع.

    «Claude Code هو أكثر أدوات الذكاء الاصطناعي بخسًا حقّها لدى غير المختصّين تقنيًا.»

    واجهات Anthropic الحالية

    ثلاث طرق للعمل مع Claude

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

    علامة تبويب Chat · المتصفّح أو التطبيق

    Claude Chat

    • • الأفضل للأسئلة والصياغة والعصف الذهني
    • • لا يتطلّب سير عمل قائمًا على مستودع
    • • الملفات مرفقات، لا دماغ مشروع يعمل
    • • استخدمها حين تكون المهمة لمرّة واحدة

    الأفضل لـ: التفكير السريع، لا الأنظمة القابلة لإعادة الاستخدام

    علامة تبويب Cowork · تطبيق سطح المكتب

    Claude Cowork

    • • وكيل خلفي مستقل يعمل على جهاز افتراضي سحابي
    • • جيّد لمهام المعرفة الأطول
    • • إعداد أقل من أسلوب الطرفية
    • • نقطة انطلاق رائعة إن كنت تريد نتائج لا بنية تحتية

    الأفضل لـ: المستشارين والمحلّلين والمشغّلين

    علامة تبويب Code وCLI وبيئة التطوير والويب

    Claude Code (هذا الدليل)

    • • وكيل برمجة للملفات والمستودعات وGitHub والأتمتة
    • • يعمل في الطرفية وبيئات التطوير وتطبيق سطح المكتب والمتصفّح وSlack وCI/CD
    • • المهارات والوكلاء الفرعيون والـ hooks وMCP والمهام الروتينية والجلسات الخلفية
    • • أقوى ما يكون حين يعيش عملك داخل مستودع منظّم

    الأفضل لـ: المستخدمين المتمرّسين الذين يبنون نظام تشغيل قابلًا لإعادة الاستخدام

    أنت تقرأ الدليل الخاص بهذا ↗

    غير متأكّد؟ استخدم Chat للتفكير لمرّة واحدة، وCowork للعمل الخلفي بإعداد قليل، وClaude Code حين تريد ذاكرة مشروع وأسلوب عمل مخصّصًا وhooks وMCP وأنظمة قابلة للتكرار.

    لأي عامل معرفة:

    • يؤدّي عملًا متكرّرًا يتبع أنماطًا (تقارير، رسائل بريد، عروض، محتوى)
    • يدير مشاريع مستمرّة يهمّ فيها السياق على مدى أسابيع وأشهر
    • يوازن بين أدوات متعدّدة (CRM، بريد، تقويم، تحليلات، منصّات محتوى)
    • يريد ذكاءً اصطناعيًا يزداد ذكاءً مع الوقت، لا واحدًا ينسى كل شيء بعد كل محادثة

    المستشارون

    تقارير العملاء والعروض والأطر

    مديرو المنتجات

    وثائق متطلّبات المنتج وخرائط الطريق وقصص المستخدم

    المسوّقون

    تقاويم المحتوى والحملات

    المؤسّسون

    الاستراتيجية وتحديثات المستثمرين والعمليات

    المبيعات والإيرادات

    خط الأنابيب والتواصل وأتمتة الـ CRM

    الباحثون والمحلّلون

    تجميع البيانات واستخبارات المنافسة

    ليس مثاليًا لـ:

    الأسئلة العابرة دون متابعة، أو جلسات العصف الذهني البسيطة، أو المهام التي لا تتكرّر أبدًا. لهذه، تكفي محادثة Claude العادية.

    «أنا لست مبرمجًا. أنا لا أكتب أي كود. لذا من المذهل أن يكون هذا النوع من الأشياء متاحًا ويمكن أن يحدث فعلًا.»

    — Dominic، مستشار سحابي • بنى منصّة اشتراكات باستخدام Claude Code من دون أي خلفية برمجية

    قبل أن نبدأ

    شاهد إلى أين تبني

    يعلّمك هذا الدليل كل مفهوم خطوة بخطوة. لكن إن أردت رؤية شكل نظام كامل في الواقع، إليك مقطعًا من 3 دقائق من جلسة مباشرة.

    أمر واحد. يقرأ الذكاء الاصطناعي رسائل بريدك ورسائل WhatsApp ومهامك وCRM، ثم يخبرك بما يجب التركيز عليه اليوم. كل ما تراه هنا ستتعلّم كيف تبنيه في المراحل أدناه.

    عرض مباشر: التخطيط اليومي بالذكاء الاصطناعي (يبدأ عند 3:20)
    من جلسة عمل مشترك للـ Second Brain — يسحب الذكاء الاصطناعي من 4 مصادر بيانات ويرتّب أولويات يومك في أقل من 60 ثانية.

    المشكلة رقم 1: انعدام الذاكرة الدائمة

    الذكاء الاصطناعي التقليدي (ChatGPT، Claude Chat): كل محادثة تبدأ من الصفر. تعيد شرح مشروعك أكثر من 10 مرات في الأسبوع.

    حلّ Claude Code: المستودع كذاكرة دائمة. يُحمَّل ملف CLAUDE.md في بداية كل جلسة. ووثائق التطوير (plan.md، context.md، tasks.md) للمشاريع التي تمتدّ أسابيع.

    جلسة ذكاء اصطناعي تقليدي:

    Session 1:
    You: "I'm building a SaaS product..."
    [Explain project for 10 minutes]
    
    Session 2 (next day):
    You: "Remember my SaaS product?"
    AI: "What product? Please explain."
    [Re-explain AGAIN]

    جلسة Claude Code:

    Session 1:
    Claude reads CLAUDE.md
    "I see you're building a SaaS
    product. What would you like?"
    
    Session 2 (next day):
    Claude reads CLAUDE.md
    "Back to the SaaS project.
    What's next?"

    النقطة التعليمية: الذاكرة الدائمة تلغي عبء التبديل بين السياقات

    الأثر الحقيقي: أمضى Richard (مستشار إداري، أستراليا) أسبوعًا في إعداد Claude Code بمفرده. وبعد جلسة واحدة مدّتها ساعتان باستخدام قوالب Second Brain قال: «لقد حللت لي في هذه المكالمة ما كنت لا أزال أخطئ فيه، فقد كنت أتعامل معه وكأنه روبوت محادثة. أما باستخدام الأوامر والوكلاء، فيمكنك فعليًا أن تجعله يدير سير عملك اليومي نيابةً عنك. هذا أمر هائل. يستحق المال قطعًا لأنه وفّر عليّ ثلاثة أو أربعة أشهر من التخبّط وحدي.»

    المشكلة رقم 2: عنق الزجاجة المتسلسل

    الذكاء الاصطناعي التقليدي: لا يستطيع العمل إلا على شيء واحد في كل مرة. تحليل 10 ملفات؟ انتظِر كل واحد منها بالتتابع.

    حلّ Claude Code: ينفّذ الوكلاء الفرعيون عدة مهام بالتوازي داخل الجلسة. وللعمل المستقلّ الطويل، استخدم الجلسات الخلفية من Claude Code على الويب أو سطح المكتب أو Slack أو Agent View.

    مقارنة مرئية
    SEQUENTIAL (ChatGPT Way):
    [Agent 1: Research] → [Agent 2: Content] → [Agent 3: Analysis]
    15 min                 20 min               10 min
    Total: 45 minutes
    
    PARALLEL (Claude Code Way):
    [Agent 1: Research]  ─┐
    [Agent 2: Content]   ─┼─ All running simultaneously
    [Agent 3: Analysis]  ─┘
    Total: MAX(15, 20, 10) = 20 minutes
    
    Speedup: 45 min → 20 min = 2.25x faster

    الأثر الحقيقي: حلّل مستشار 5 منافسين (Asana، Monday، ClickUp، Notion، Airtable). استغرق ChatGPT 45 دقيقة وأنجز 3 فقط. أما Claude Code بالوكلاء الفرعيين فاستغرق 20 دقيقة وأنجز الخمسة في آنٍ واحد.

    النقطة التعليمية: الوكلاء الخلفيون يتيحون معالجة متوازية حقيقية

    الأثر الحقيقي: بنى Damian (مستشار ذكاء اصطناعي، سويسرا) سير محتوى متكاملًا لوسائل التواصل في يومين، وهو ما تبيعه أداة SaaS تجارية بمئات الدولارات شهريًا. سير عمله: التقاط الأفكار ← استخراج بصمة الصوت على LinkedIn ← توليد ملفات PDF متعدّدة الشرائح ← جدولة المنشورات. «أخبرني صديق للتوّ عن هذا الحلّ الجديد الرائع الذي اشتراه. كان ذلك بالضبط ما بنيته في يومين بالـ Second Brain. سحر خالص.»

    المشكلة رقم 3: ضريبة تبديل السياق

    الذكاء الاصطناعي التقليدي: انسخ المستندات ← الصق ← انتظِر. انسخ الكود ← الصق ← انتظِر. أكثر من 30 دقيقة تضيع في كل جلسة.

    حلّ Claude Code: يتّصل MCP (Model Context Protocol) مباشرةً بـ Gmail والتقويم والـ CRM والتحليلات. لا مزيد من النسخ واللصق بين التطبيقات.

    العملية اليدوية:

    1. 1. افتح HubSpot
    2. 2. صدّر 200 مشارك في الندوة الإلكترونية
    3. 3. نزّل ملف CSV
    4. 4. انسخ قائمة البريد
    5. 5. الصقها في ChatGPT
    6. 6. اطلب التحليل
    7. 7. انسخ النتائج عائدًا
    8. 8. ارفعها إلى HubSpot

    الوقت: 35 دقيقة

    عملية MCP:

    1. 1. «وسِم المشاركين في الندوة»
    2. 2. يتّصل Claude بـ HubSpot
    3. 3. تمّ.

    الوقت: 3 دقائق

    الأثر الحقيقي: انتقل مدير عمليات المبيعات من ساعتين أسبوعيًا في تحديث الـ CRM يدويًا إلى الصفر. كل ذلك مؤتمت عبر MCP.

    المشكلة رقم 4: عزلة الأدوات

    الذكاء الاصطناعي التقليدي: لا يستطيع الذكاء الاصطناعي الوصول إلى أدوات عملك الفعلية. نقل يدوي للبيانات في كل مكان.

    حلّ Claude Code: تنشط المهارات تلقائيًا بناءً على الكلمات المفتاحية. وتشغّل الـ hooks النصوص البرمجية تلقائيًا. ابنِ مرّة، وأعد الاستخدام للأبد.

    مثال: أتمتة التقرير الأسبوعي
    Traditional AI:
    You: "Generate weekly sales report"
    AI: "Please provide data..."
    You: [Copy sales from HubSpot]
    You: [Copy traffic from Analytics]
    You: [Copy revenue from Stripe]
    AI: [Generates report]
    You: [Format manually]
    You: [Send to team]
    Time: 45 minutes
    
    Claude Code with Skills:
    You: "Generate weekly sales report"
    Skill auto-loads:
      ├─ MCP: Fetch HubSpot deals
      ├─ MCP: Fetch GA4 traffic
      ├─ MCP: Fetch Stripe revenue
      └─ Generate formatted report
      └─ Save to reports/weekly-2025-01-11.md
    Time: 2 minutes

    الأثر الحقيقي: أتمتت مديرة تسويق 5 تقارير أسبوعية. انتقلت من 3.5 ساعة أسبوعيًا إلى 10 دقائق أسبوعيًا. أي أسرع بـ 21 ضعفًا.

    ما الذي استبدله فعلًا أداة واحدة + سياق منظّم

    هذا ليس كلامًا نظريًا. هذه صفحات إدارة حقيقية تعمل في بيئة الإنتاج في هذه اللحظة.

    فئة الـ SaaSالتكلفة الشهرية المعتادةمدمج الآن في Second Brain
    CRM (HubSpot/Pipedrive)$45-100/moخط مبيعات + تتبّع العملاء المحتملين
    التسويق عبر البريد (Mailchimp)$30-60/moتسلسلات مؤتمتة + نشرة بريدية
    جدولة المحتوى (Buffer)$15-30/moتقويم محتوى + إدارة قائمة انتظار
    إدارة المهام (Asana/Linear)$10-25/moتتبّع المهام + سير عمل الجلسات
    لوحة تحليلات$20-50/moذكاء الأعمال + إعداد التقارير
    بوابة تسليم للعملاءمخصّصمولّد مستودعات + تهيئة

    $120-265/شهريًا قبل

    $20/شهريًا بعد (Claude Pro)

    هذه ليست مقارنة بين Claude و HubSpot. فـ HubSpot أفضل بوصفه نظام CRM. لكن بالنسبة لرائد أعمال فردي أو فريق صغير، فإن Claude Code + سياقًا منظّمًا يتولّى 80% ممّا تستخدم تلك الأدوات لأجله فعلًا، بنسبة 10% من التكلفة.

    قائمة التحقّق للمرحلة 1

    أتريد الطريق المختصر؟

    تخطَّ 2-3 أسابيع من التجربة والخطأ. كل ما هو أدناه مبنيّ مسبقًا في Second Brain.

    اطّلع على الباقات
    المرحلة 2

    الإعداد: البداية

    1

    اشتراك Claude أو فوترة عبر API

    ينبغي لمعظم الناس البدء بخطة Claude Pro أو Max من أجل استخدام شهري يمكن توقّعه. كما تتوفّر الفوترة عبر API لأساليب العمل البرمجية أو الجماعية.

    2

    اختر كيف تستخدم Claude Code

    اختر الواجهة التي تناسب مستوى راحتك ونظام تشغيلك

    Claude Code على الويب

    معاينة بحثية. اربط GitHub على claude.ai/code. يعمل على جهاز افتراضي سحابي تديره Anthropic.

    علامة تبويب Code في تطبيق سطح المكتب

    تطبيق أصلي لنظامي macOS و Windows. واجهة رسومية لـ Claude Code مع شريط جانبي وطرفية ومحرّر ملفات ومقارنات فروق ومعاينات ومراقبة طلبات السحب.

    طرفية CLI (الأقوى)

    أكمل تحكّم في الملفات المحلية والـ shell وMCP والـ hooks والنصوص البرمجية وCI والأتمتة.

    امتداد بيئة التطوير

    VS Code و Cursor وبيئات تطوير من عائلة JetBrains. يعمل Claude Code داخل محرّرك، إلى جانب ملفاتك.

    3

    حساب GitHub (اختياري لكنه مُوصى به)

    اعتبره «Google Drive لدماغ ذكائك الاصطناعي» — ينسخ مستودعك احتياطيًا ويزامنه عبر الأجهزة.

    قائمة التحقّق للمرحلة 2

    أفضل طريقة لتبنّي Claude Code

    لا تحاول بناء النظام بأكمله دفعةً واحدة. أكبر خطأ يرتكبه الناس هو محاولة أتمتة كل شيء في اليوم الأول. وهذا لا ينجح أبدًا.

    اختر حالة استخدام واحدة في اليوم. هذا كل شيء.

    اليوم 1

    «ساعدني في البحث عن هذه الشركة.»

    اليوم 2

    «اكتب لي منشور LinkedIn عن X.»

    اليوم 3

    «راجِع صفحة الهبوط هذه.»

    اليوم 4

    «أنشئ مهارة لتقريري الأسبوعي.»

    شيئًا فشيئًا، يمتلئ مستودعك. وتزداد مهاراتك ووكلاؤك وقواعدك وملف CLAUDE.md ذكاءً. وبعد بضعة أسابيع تنظر إلى الوراء فتدرك أنك بنيت نظامًا كاملًا، قطعة صغيرة في كل مرة.

    خارطة طريق التبنّي خلال 4 أسابيع

    W1

    الوكلاء الفرعيون (دون أي إعداد)

    اطلب من Claude Code استخدام الوكلاء الفرعيين في 2-3 مهام بحث مستقلّة. لاحظ كيف تبقى محادثتك الرئيسية نظيفة بينما يعمل المتخصّصون بالتوازي.

    W2

    مهارتك الأولى

    اختر سير العمل الأكثر تكرارًا لديك (إنشاء المحتوى، مراجعة الكود، تحليل البيانات). أنشئ .claude/skills/my-workflow/SKILL.md مع وصف واضح وتعليمات خطوة بخطوة. اختبرها بأن تطلبها طلبًا طبيعيًا أو باستدعاء /my-workflow، ثم كرّر التحسين.

    W3

    المهارات + الوكلاء الفرعيون معًا

    داخل مهارتك، أضف خطوات تستخدم الوكلاء الفرعيين للبحث. اربط مهارتين معًا. واضبط ملف CLAUDE.md بسياق المشروع وتفضيلاتك.

    W4

    Harness + MCP + المتقدّم (اختياري)

    أضف بوّابات التخطيط والاختبار والمراجعة والموافقة حول أهمّ أساليب عملك. ثم اربط أدوات العمل عبر MCP. ينبغي لمعظم الناس بناء الـ harness قبل منح مزيد من الاستقلالية.

    المرحلة 3

    نظام الذاكرة: CLAUDE.md وبنية المستودع

    ملاحظة: ملف CLAUDE.md اختياري لكنه مُوصى به بشدّة لسياق دائم. فهو يلغي الحاجة إلى إعادة شرح مشروعك في كل جلسة.

    ملف Markdown خاص يحمّله Claude Code في بداية كل جلسة. اعتبره دليل تعليمات مشروعك، لكن للذكاء الاصطناعي، لا للبشر.

    بدون CLAUDE.md:

    • • كل جلسة: «إليك مشروعي...»
    • • إعادة شرح السياق أكثر من 10 مرات أسبوعيًا
    • • ينسى Claude تفضيلاتك
    • • مخرجات غير متّسقة

    مع CLAUDE.md:

    • • يقرأه Claude مرّة واحدة في الجلسة
    • • سياق فوري عن مشروعك
    • • يتذكّر الأسلوب والمتطلّبات
    • • جودة متّسقة
    قالب CLAUDE.md أساسي
    # CLAUDE.md
    
    ## Project Overview
    [One sentence: What you're building]
    
    **Mission**: [Your project's goal]
    **Target Users**: [Who uses this]
    
    ## Repository Structure
    - `company-brain/`: Business knowledge
    - `agents/`: AI agent templates
    - `data/`: Datasets and analysis
    
    ## Key Guidelines
    - [Important fact #1 Claude should always know]
    - [Important fact #2]
    - [Important fact #3]
    
    ## Output Standards
    - [How you want deliverables formatted]
    - [Your writing style preferences]
    
    ## Guardrails
    - [Things Claude should NEVER do]
    - [Data privacy rules]

    شاهده عمليًا

    كيف يبدو Second Brain حقيقي على GitHub

    انسَ النظرية لحظةً. إليك مستودع Second Brain حقيقي يضم أكثر من 30 وكيلًا ومهارات وأوامر وملفات معرفة — البنية التي تجعل كل ما في هذا الدليل يعمل.

    خلف الكواليس: جولة في مستودع GitHub حقيقي (يبدأ عند 42:30)
    من جلسة عمل مشترك مباشرة — تصفّح المجلّدات والوكلاء والمهارات والوثائق الحقيقية التي تشغّل Second Brain في بيئة الإنتاج.

    «كنت أضع كل شيء في CLAUDE.md — 500 سطر. وبدأ Claude يتجاهل نصفه. ثم تعلّمت عن الكشف التدريجي فاتّضح كل شيء.»

    — Andrew، مدير منتج

    الخطأ رقم 1 الذي يرتكبه الجميع

    يحشو الناس كل شيء في CLAUDE.md — سياق العمل ووثائق الـ API وأدلّة الأسلوب والمزالق والقوالب. وعند تجاوز 500 سطر، يبدأ Claude بتجاهل التعليمات. وتُظهر الأبحاث أن الالتزام بالتعليمات يتدهور بعد نحو 300 سطر ونحو 50 قاعدة. ومن المفارقة أن مزيدًا من التعليمات يؤدّي إلى التزام أسوأ بالتعليمات.

    الحلّ هو الكشف التدريجي: أبقِ CLAUDE.md قصيرًا (دون 200 سطر) مع جداول مؤشّرات تحمّل الوثائق التفصيلية عند الحاجة. اعتبره فهرسًا، لا موسوعة.

    أحادي الكتلة (ينهار عند التوسّع):

    CLAUDE.md (972 lines)
    ├─ Business context (50 lines)
    ├─ API documentation (200 lines)
    ├─ Database schema (150 lines)
    ├─ Style guide (100 lines)
    ├─ Email templates (120 lines)
    ├─ Gotchas list (80 lines)
    ├─ MCP configs (150 lines)
    └─ ... Claude ignores half of it

    متعدّد الطبقات (يتوسّع بلا حدود):

    CLAUDE.md (200 lines)
    ├─ Business context (always loaded)
    ├─ Tech stack (always loaded)
    ├─ Pointer table → docs/
    ├─ Critical gotchas (3-5 rules)
    └─ Self-improvement protocol
    
    .claude/docs/ (loaded on demand)
    ├─ api-guide.md
    ├─ database-ops.md
    ├─ email-system.md
    └─ gotchas.md

    الطبقات الثلاث

    الطبقة 1: CLAUDE.md (محمّل دائمًا — دون 200 سطر)

    السياق المنطبق عالميًا فقط هو ما ينتمي إلى هنا. سياق العمل، والمكدّس التقني، والمزالق الحرجة، وجدول مؤشّرات إلى كل ما عداها.

    نمط جدول المؤشّرات
    ## Architecture & Patterns
    | Area              | Read This File             |
    |-------------------|----------------------------|
    | Writing API code  | .claude/docs/api-guide.md  |
    | Database work     | .claude/docs/database.md   |
    | Email system      | docs/EMAIL_SYSTEM.md       |
    | Known gotchas     | .claude/docs/gotchas.md    |
    | Troubleshooting   | docs/TROUBLESHOOTING.md    |
    
    Read the relevant file BEFORE making changes
    in that area.

    حين يحتاج Claude إلى العمل على نظام البريد، يقرأ CLAUDE.md، فيرى المؤشّر، ويحمّل docs/EMAIL_SYSTEM.md عند الحاجة. وتبقى الوثائق الأخرى خارج السياق.

    الطبقة 2: ‎.claude/docs/‎ (محمّلة عند الحاجة)

    وثائق تفصيلية يقرأها Claude فقط حين يعمل في مجال محدّد. يبدأ كل ملف بمشغّل «متى تقرأ».

    مثال: ‎.claude/docs/api-guide.md‎
    # API Development Guide
    
    > When to read: Before writing or modifying
    > any API endpoint
    
    ## Pattern: Legacy Request/Response
    All endpoints MUST use VercelRequest/
    VercelResponse pattern. Web API pattern
    causes 30-second timeouts.
    
    ## Required: .js Extensions
    All imports in API files MUST include .js
    extension. Missing extensions cause silent
    build failures in production.
    
    ## Template
    export default async function handler(
      req: VercelRequest,
      res: VercelResponse
    ) { ... }

    الطبقة 3: ‎knowledge/‎ (سياق خاص بالوكلاء)

    مادة مرجعية عميقة لا يحتاجها سوى وكلاء أو مهارات محدّدة. لا تُحمَّل أبدًا في الجلسات العامّة.

    .claude/knowledge/
    ├─ content-creator/    # Voice DNA, templates
    │   ├─ brand-voice.md
    │   └─ content-types.md
    ├─ sales/              # CRM context, scripts
    │   ├─ objection-handling.md
    │   └─ email-sequences.md
    └─ data-analysis/      # Schema, query patterns
        └─ common-queries.md

    لماذا ينجح هذا:

    كفاءة السياق

    ملف CLAUDE.md نحيف بمؤشّرات يستهلك رموزًا أقلّ بكثير من ملف ضخم واحد. ويترك مساحةً للعمل الفعلي.

    التزام أفضل بالتعليمات

    50 قاعدة في ملف مركّز تتفوّق على 200 قاعدة في ملف متضخّم. في كل مرة.

    يتوسّع بلا حدود

    أضف وثائق جديدة دون أن تمسّ CLAUDE.md. فقط أضف صفًّا إلى جدول المؤشّرات.

    البداية السريعة: الكشف التدريجي في 3 خطوات

    1. 1. أنشئ مجلّد ‎.claude/docs/‎

      انقل أي قسم أطول من 20 سطرًا من CLAUDE.md إلى ملفه الخاص.

    2. 2. أضف جدول مؤشّرات إلى CLAUDE.md

      اربط كل مجال عمل بالملف الذي ينبغي لـ Claude قراءته قبل البدء.

    3. 3. أضف مشغّلات «متى تقرأ»

      ابدأ كل ملف وثائق بمشغّل من سطر واحد: «متى تقرأ: قبل العمل على [X]»

    بناء هذه البنية يستغرق 4-6 ساعات

    كتابة جداول المؤشّرات، وتنظيم الوثائق بمشغّلات «متى تقرأ»، واختبار أن Claude يحمّل الملف الصحيح في الوقت الصحيح. يأتي Second Brain بأكثر من 10 وثائق معدّة مسبقًا، وجداول مشغّلات، وبنية الكشف التدريجي الكاملة جاهزةً للاستخدام.

    تخطَّ الإعداد

    قائمة التحقّق للمرحلة 3

    المرحلة 4

    الأتمتة: الوكلاء والمهارات والـ hooks والـ harnesses والتعلّم

    «هذه هي الميزة الحقيقية لـ Claude Code. البرمجة المتوازية. تطلق 3 وكلاء بحث فيعودون جميعًا بنتائج بينما تواصل العمل على المسار الرئيسي.»

    — Wytze، عضو في المجتمع

    الوكلاء الفرعيون عمّال ذكاء اصطناعي متخصّصون بسياق معزول. كأن لديك محلّل بحث وكاتبًا في فريقك يعملان في آنٍ واحد.

    متى تستخدم الوكلاء الفرعيين:

    • ✅ تحليل متوازٍ (10 منافسين دفعةً واحدة)
    • ✅ الحاجة إلى خبرة متخصّصة
    • ✅ مهام فرعية مستقلّة
    • ✅ مشاريع كبيرة بمراحل متمايزة

    متى لا تستخدمهم:

    • ❌ مهام مفردة بسيطة
    • ❌ اعتماديات متسلسلة
    • ❌ مهام تتطلّب سياقًا مشتركًا

    مثال واقعي: تحليل المنافسة

    المهمة: تحليل 5 منافسين (Asana، Monday، ClickUp، Notion، Airtable)

    متسلسل (ChatGPT): 45 دقيقة

    حلّل واحدًا ← التالي ← التالي... 3 أُنجزت بإهمال، و2 تُخطّيا بسبب الإرهاق

    متوازٍ (Claude Code): 8 دقائق

    5 وكلاء فرعيون يعملون في آنٍ واحد. الخمسة مكتملون، بجودة عالية، وبتنسيق متّسق

    كيف يعمل الوكلاء الفرعيون - تدفّق مرئي
    USER PROMPT:
    "Analyze these 5 competitors: Asana, Monday, ClickUp,
    Notion, Airtable. For each, analyze pricing, features,
    target market."
    
    CLAUDE CODE SPAWNS 5 SUBAGENTS:
    ┌─────────────────────────────────────────────┐
    │ Main Claude                                 │
    │ ├─ Subagent 1: Analyze Asana              │
    │ ├─ Subagent 2: Analyze Monday             │
    │ ├─ Subagent 3: Analyze ClickUp            │
    │ ├─ Subagent 4: Analyze Notion             │
    │ └─ Subagent 5: Analyze Airtable           │
    │                                             │
    │ [All run in parallel]                       │
    │                                             │
    │ After 8 min: Aggregate results →           │
    │ Generate comparison table                   │
    └─────────────────────────────────────────────┘

    مراجعة واقعية للتكلفة

    يستهلك الوكلاء الفرعيون نوافذ سياقهم الخاصة. مهمّة متوازية بـ 3 وكلاء تستخدم نحو 3 أضعاف رموز إنجازها بالتتابع. وقد تبلغ فرق الوكلاء (5 فأكثر) 7 أضعاف أو أكثر. وهذا يهمّ إن كنت تدفع عبر فوترة الـ API.

    الاستراتيجيةكيفالتوفير
    نماذج أصغر للعمّالاستخدم Haiku للمهام البسيطة وOpus للقرارات60-80%
    حدّد نطاق الوكيلقيّد الأدوات والوصول إلى الملفات لكل وكيل30-50%
    استخدم وكلاء Explore للبحثللقراءة فقط، سريعون، استهلاك رموز ضئيل~70%
    خزّن مؤقتًا في CLAUDE.mdاحفظ النتائج كي لا يعيد الوكلاء البحثكبير
    اضبط max_turnsامنع حلقات الوكلاء الجامحةسقف صارم

    في اشتراك Claude Pro/Max (20-200 دولار/شهريًا)، يعمل الوكلاء الفرعيون ضمن حدود خطّتك — دون أي تكلفة إضافية لكل رمز. وعلى مستخدمي مفتاح الـ API مراقبة الاستهلاك بعناية أكبر.

    شاهده عمليًا

    ما الذي يوجد فعلًا داخل ملف الوكيل

    لقد قرأت للتوّ عن إعدادات الوكلاء. إليك واحدًا يُفتح مباشرةً — وكيل منشئ محتوى بوصول إلى الأدوات وشجرة قرار وإعدادات صوت وإشارات إلى ملفات المعرفة. إنه ملف نصّي، لا كود.

    عرض مباشر: داخل وكيل منشئ محتوى (يبدأ عند 11:54)
    من ندوة Second Brain الإلكترونية — فتح ملف الوكيل الحقيقي الذي يُظهر التعليمات وأذونات الأدوات وشجرة القرار وقواعد الكتابة.

    «لاحظت محتوى أفضل حين يكون لديّ وكيل مركزي ثم مجموعة مهارات يستطيع استدعاءها بنفسه. فبدلًا من أن أتذكّر سير العمل بالضبط في كل مرة، أقول فقط ‹اكتب منشور LinkedIn› فيسحب المهارة الصحيحة.»

    — Shaun، متخصّص في التسويق والنموّ

    الوكيل = النموذج + الـ harness

    يستمرّ معظم الناس في ترقية النموذج. أما المستخدمون المتمرّسون فيرقّون الـ harness المحيط بالنموذج. الـ harness هو نظام تشغيل العمل بالذكاء الاصطناعي: يحدّد الخطّة، ويمنح الوكيل أدوات آمنة، ويفحص المخرجات، ويطلب المراجعة، ويلتقط الدروس، وعندئذٍ فقط يدع العمل يُطلق.

    النموذج مجرّد مدخل واحد. أما الـ harness فهو كل ما عداه: المطالبات، وCLAUDE.md، والقواعد، والأدوات، وخوادم MCP، ونظام الملفات، وGit، وبيئات العزل، والـ hooks، والوكلاء الفرعيون، وسياسات السياق، والسجلّات، والمصحّحون، ومسارات التعافي، وبوّابات الإطلاق. فـ Claude Code و Cursor و Codex و Aider و Cline و Managed Agents كلها harnesses حول نماذج.

    السقّاطة: كل إخفاق يصبح إصلاحًا دائمًا

    تبدأ هندسة الـ harness حين تكفّ عن لوم النموذج تلقائيًا. إن كرّر الوكيل خطأً، فالمهمّة هي تغيير الـ harness بحيث يصبح ذلك الإخفاق بعينه أصعب أو مستحيلًا في المرّة التالية.

    الإخفاق المرصودإصلاح الـ harnessأين يقيم
    تجاهل عرفًا من أعراف المشروعأضف قاعدة قصيرة مكتسبة بالتجربةCLAUDE.md أو .claude/rules/
    نفّذ أمرًا مدمّرًااحجبه قبل التنفيذhook الـ PreToolUse
    تاه في مهمّة طويلةافصل أدوار المخطّط والمنفّذ والمراجعمهارة + وكلاء فرعيون
    انتهى بمخرجات معطوبةشغّل فحوصًا موضوعية وأعِد تغذية الإخفاقاتhook تحقّق أو مصحّح
    كرّر المسوّدة الضعيفة نفسهاأضف أمثلة ومعيارًا وأسئلة مراجعةملفات مرجع المهارة

    أضف القيود فقط حين تعود إلى إخفاق حقيقي. وأزِلها حين تصبح متقادمة. فالـ harness الجيّد قطعة حيّة، لا مقبرة مطالبات.

    1. بوّابة الخطّة

    قبل أن يتصرّف Claude، عليه أن يعيد صياغة الهدف والافتراضات والملفات أو المصادر التي سيمسّها ومعنى «منجَز».

    2. حدّ العمل

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

    3. بوّابة التحقّق

    تُفحص المخرجات مقابل معايير موضوعية: المصادر مُستشهَد بها، والأرقام متّسقة، وقائمة التحقّق مكتملة، والحقول المطلوبة موجودة.

    4. بوّابة المراجعة

    مرور منفصل يبحث عمّا تفوّته الأتمتة: تشخيص خاطئ، وإفراط في الهندسة، ونبرة غير ملائمة، وافتراضات خفية.

    5. بوّابة التراكم

    كل خطأ يصبح قاعدة أو قالبًا أو مثالًا أو بندًا في قائمة تحقّق. ويتحسّن النظام لأن الـ harness يتعلّم.

    6. بوّابة الإطلاق

    لا شيء يغادر النظام حتى توجد قطع الخطّة والتحقّق والمراجعة والموافقة. يستطيع Claude أن يقترح؛ والـ harness يقرّر.

    الأجزاء الحاملة في الـ harness

    الحالة

    نظام الملفات، وGit، وملفات المهام، وملفات الذاكرة، ومجلّدات المخرجات. هنا يبقى العمل حيًّا بعد نافذة السياق الحالية.

    الأدوات

    Bash، وتنفيذ الكود، وأتمتة المتصفّح، وخوادم MCP، وواجهات الـ API. أبقِ الأدوات مركّزة؛ فالأدوات المتداخلة تُربك النموذج وتضخّم السياق.

    سياسة السياق

    ما الذي يُحمَّل أو يُضغط أو يُفرَّغ أو يُسترجَع لاحقًا. وهذا يقرّر ما الذي يعبر حدود سياق النموذج.

    الإنفاذ

    الـ hooks، والأذونات، وبيئات العزل، وأوامر الاختبار، وبوّابات الموافقة. فهذه تحوّل التفضيلات إلى قيود.

    التقييم

    المعايير، والمصحّحون، ووكلاء المراجعة، ومعايير القبول. قيّم النتيجة، لا المسار الغريب الذي سلكه الوكيل.

    القابلية للملاحظة

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

    إدارة السياق هي تصميم الـ harness

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

    الاقتطاع

    اطرح المخرجات منخفضة القيمة أو السجلّ القديم حين لا يهمّ الاستمرار.

    الضغط

    لخّص الجلسة وتابع بالحالة المضغوطة.

    التفريغ

    احفظ السجلّات الطويلة ونتائج الأدوات والمسوّدات في ملفات؛ وأبقِ المعاينة المفيدة فقط في السياق.

    الكشف

    حمّل الوثائق التفصيلية والمهارات والأدوات فقط حين تحتاجها المهمّة فعلًا.

    قاعدة عملية: أبقِ السياق المحمّل دائمًا قصيرًا، وتصفّح الملفات الكبيرة بـ offset/limit، وابحث قبل قراءة الملفات كاملة، واحفظ مخرجات الأدوات الطويلة على القرص بدلًا من لصقها مجدّدًا في المحادثة.

    معايير النتائج: حدّد كيف يبدو «المنجَز»

    تجعل واجهة Managed Agents API من Anthropic هذا النمط صريحًا: حدّد نتيجة، وأرفق معيارًا، ودع مصحّحًا منفصلًا يقيّم القطعة، ثم أعِد تغذية الفجوات إلى الوكيل لجولة تكرار أخرى. ويمكنك استخدام الفكرة نفسها يدويًا في Claude Code.

    Outcome:
    Create a competitor pricing report for the 5 named companies.
    
    Rubric:
    - Includes all 5 companies
    - Every price claim has a source URL
    - Pricing tiers are normalized into one table
    - Unknown prices are marked "not published" instead of invented
    - Final section recommends what we should change
    
    Iteration rule:
    If any rubric item fails, revise once before showing me the final.

    الخطوة المهمّة هي الفصل: حلقة تنشئ القطعة، وأخرى تقيّمها مقابل المعيار. وهذا يقلّل المديح الذاتي ويلتقط الفجوات أسرع.

    قالب الـ harness لعامل المعرفة

    1. Track
       Capture the request in a task, client folder, or project log.
    
    2. Plan
       Ask Claude: "Before doing the work, give me the plan,
       assumptions, sources/tools needed, and acceptance criteria."
    
    3. Work
       Let Claude execute inside clear boundaries:
       read-only research, draft-only writing, no external sends.
    
    4. Verify
       Run a checklist that matches the work type:
       sources, calculations, brand voice, missing fields, risks.
    
    5. Review
       Ask a second pass: "Find what is wrong, overbuilt,
       unsupported, or not how we do things here."
    
    6. Learn
       Capture one reusable rule or template improvement.
    
    7. Ship
       Only publish, send, update CRM, or hand off after approval.

    مطالبة للنسخ واللصق: حوّل أي سير عمل إلى harness

    I want to turn this repeated workflow into a reliable AI harness:
    [describe the workflow]
    
    Create:
    1. The planning questions Claude must answer before starting
    2. The tool and permission boundaries
    3. The verification checklist
    4. The review questions a second pass should ask
    5. The human approval points
    6. The learning rule to update after each run
    
    Keep it practical for a non-technical knowledge worker.

    تدقيق أسبوعي للـ harness: اقطع الأعباء الخفية

    إن بدا Claude أبطأ أو أقلّ ذكاءً أو يستنزف حدودك، فدقّق الـ harness قبل أن تلوم النموذج. فمعظم الهدر يختبئ في السياق المحمّل دائمًا.

    الفحصما الذي تبحث عنهالإصلاح
    CLAUDE.md الحجمقواعد لم تعد مهمّة أو تنتمي إلى وثائق أضيقأبقِ السياق الجذري قصيرًا؛ وانقل التفاصيل إلى القواعد أو الوثائق أو المهارات
    الـ hookshooks الـ UserPromptSubmit أو SessionStart التي تحقن السياق في كل مرةعطّل كل ما ليس له مهمّة محدّدة
    خوادم MCPمخطّطات أدوات محمّلة لأدوات نادرًا ما تستخدمهاأبقِ الأدوات اليومية فقط نشطةً دائمًا؛ وفعّل غيرها حسب الجلسة
    المهاراتأوصاف واسعة تتسبّب في تحميل مهارات غير ذات صلةأحكِم الأوصاف أو عطّل المهارات غير المستخدمة
    طول المحادثةجلسات طويلة تعيد قراءة سجلّ متقادماضغط أو لخّص أو ابدأ من جديد بملاحظة تسليم

    أمثلة حسب الدور

    سير العملبوّابة التحقّقالبوّابة البشرية
    تقرير استشاريادّعاءات مربوطة ببيانات العميل، وتوصيات مرتبطة بالنطاق، ولا تسريب لأسماء سرّيةيراجع الشريك جودة الرؤى قبل الإرسال
    تواصل مبيعاتسجلّ الـ CRM مُتحقَّق منه، ومصدر التخصيص مُستشهَد به، ولا حدث مُثير مُختلَقأنت تُوافق قبل الإرسال عبر البريد أو LinkedIn أو WhatsApp
    تحليل ماليالمجاميع متّسقة، والافتراضات مُدرَجة، والشواذّ مُشار إليها، وملفات المصدر مُسمّاةأنت تُوافق على التفسير قبل المشاركة
    نشر محتوىفحص الصوت، والعبارات المحظورة مُزالة، والحقائق لها مصدر، ودعوة الإجراء موجودةأنت تُوافق على النسخة النهائية قبل قائمة الانتظار أو النشر

    ما لا يلتقطه أي harness بموثوقية

    • • التشخيص الخاطئ: حلّ السبب الجذري الخاطئ
    • • الإفراط في الهندسة: إضافة تعقيد لم يطلبه أحد
    • • سوء فهم التعليمات: أداء المهمّة المجاورة
    • • أعراف الفريق من نوع «نحن لا نفعلها هكذا هنا»
    • • الذوق والحكم والمفاضلات التنفيذية
    • • المساءلة الاجتماعية عن النتيجة النهائية

    القاعدة: أتمِت الكتابة والبحث والفحص والتنسيق. وأبقِ المسؤولية والحكم النهائي والالتزامات الخارجية مع إنسان.

    «أنا واقع في حبّ هذا النظام الجديد. أنجزت نحو 10 أيام من العمل في يوم واحد.»

    — Shaun، متخصّص في التسويق والنموّ • بنى أتمتة من الصوت إلى منشور اجتماعي في أسبوعه الأول

    لهذا علّق 5475 شخصًا بكلمة «BRAIN»

    يستخدم معظم الناس Claude كمساعد وحيد. تسأل سؤالًا، فتحصل على إجابة. لكن Claude Code يتيح لك بناء فريق كامل من المتخصّصين يسلّمون العمل فيما بينهم — بينما تراجع أنت.

    تمييز مهمّ: الوكلاء الفرعيون مقابل الوكلاء الخلفيين

    الوكلاء الفرعيون متخصّصون داخل جلسة Claude Code واحدة. لهم سياقهم الخاص وأذونات أدواتهم الخاصة، ثم يرفعون تقاريرهم إلى الجلسة الرئيسية. أما الوكلاء الخلفيون فجلسات سحابية منفصلة تديرها عبر Claude Code على الويب أو سطح المكتب أو Slack أو Agent View.

    استخدم الوكلاء الفرعيين حين:

    يحتاج سير عمل رئيسي إلى عدة تحليلات أو مراجعات أو مسوّدات مركّزة بالتوازي.

    استخدم الوكلاء الخلفيين حين:

    تريد جلسات مستقلّة طويلة الأمد على مستودعات أو فروع أو طلبات سحب أو مهام مجدولة مختلفة.

    ثلاثة مستويات لتنسيق الوكلاء

    المستوى 1: وكيل منفرد

    جلسة Claude واحدة تفعل كل شيء. كالعمل مع شخص عامّ واحد بالغ القدرة. وهنا يتوقّف معظم الناس.

    المستوى 2: قائد مفوِّض (الوكلاء الفرعيون)

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

    المستوى 3: جلسات خلفية + Agent View

    عدة جلسات Claude Code تعمل بشكل مستقلّ. استخدم claude agents أو واجهات الويب/سطح المكتب لإرسال العمل ومراقبته واستئنافه. منطقة المعاينة البحثية — قويّة لكنها لا تزال تتطوّر.

    مثال واقعي: خط أنابيب تواصل المبيعات

    إليك ما يحدث فعلًا حين أقول «صُغ تواصلًا لهذا العميل المحتمل»:

    Lead Agent orchestrates the pipeline:
    │
    ├─ Research Agent
    │  → Pulls LinkedIn profile + company intel
    │  → Returns: role, company size, recent posts
    │
    ├─ CRM Agent
    │  → Checks prospect history, stage, past notes
    │  → Returns: last contact, deal stage, context
    │
    ├─ Draft Agent
    │  → Writes personalized email using research
    │  → Uses voice guidelines from knowledge files
    │
    ├─ Quality Agent
    │  → Scores draft against brand voice rubric
    │  → Flags generic phrases, suggests improvements
    │
    └─ Lead Agent
       → Reviews final draft
       → I approve → sends via email MCP
    
    5 agents. 3 minutes.
    What used to take 45 minutes of tab-switching
    between LinkedIn, CRM, email, and style guides.

    مراجعة متعدّدة الوكلاء: حين يتحدّى المتخصّصون بعضهم

    في المستوى 2، تتدفّق كل المراسلات عبر الجلسة القائدة. وما زال بإمكانك أن تطلب من Claude تشغيل مرورات متخصّصين مستقلّة، ومقارنة نتائجها، وجمع نقاط الخلاف. وللمسارات المنفصلة طويلة الأمد، استخدم الجلسات الخلفية وAgent View.

    مثال: فرضيات متنافسة
    "Our conversion rate dropped 15% last week.
    Use three specialist subagents to investigate:
    - One analyzes traffic sources
    - One reviews checkout funnel
    - One checks pricing page changes
    Then compare their findings and challenge contradictions."
    
    What happens:
    Traffic Agent: "Paid traffic quality dropped"
    Checkout Agent: "But checkout completion is
      stable. The issue is upstream."
    Pricing Agent: "New pricing page went live
      Tuesday. Bounce rate up 40%."
    Traffic Agent: "That explains the drop—
      the traffic was fine, the page wasn't."
    
    → Root cause found in minutes, not hours.

    بنية المناظرة تمنع انحياز التثبيت. فالتحرّي المتسلسل يميل إلى إيجاد نظرية واحدة ثم التوقّف. أما عدّة محقّقين مستقلّين يتحدّون بعضهم فيُظهرون الإجابة الحقيقية.

    بناء أكثر من 30 وكيلًا متخصّصًا بالشخصيات وأذونات الأدوات وملفات المعرفة ومنطق التنسيق الصحيح استغرق أشهرًا من التكرار. على كل وكيل أن يعرف ما يمكنه الوصول إليه، وبأي صيغة يُخرج، ومتى يسلّم إلى الوكيل التالي. يأتي Second Brain بمكتبة الوكلاء الكاملة — معدّةً مسبقًا لإنشاء المحتوى وتواصل المبيعات وإدارة العملاء وتحليل البيانات والعمليات اليومية.

    Claude Code يعمل جنبًا إلى جنب مع أدوات أخرى

    أكثر الإعدادات فاعليةً ليست «Claude Code وحده». فالمستخدمون المتمرّسون يمزجون الأدوات استراتيجيًا: ChatGPT للعصف الذهني الإبداعي، وClaude Code للتنفيذ المنظّم، وGemini للمراجعة. يصبح Claude Code طبقة التنسيق التي تربط كل شيء معًا — لا الأداة الوحيدة في مجموعتك.

    مثال على سير عمل متعدّد النماذج
    1. Brainstorm with ChatGPT (creative, divergent thinking)
    2. Hand the brief to Claude Code (precise execution)
    3. Review output with Gemini (catching edge cases)
    4. Final polish back in Claude Code
    
    Why: Each model has different strengths.
    Claude Code orchestrates the whole thing
    through skills and sub-agents.

    قائمة التحقّق للمرحلة 4

    هكذا يبدو النظام الكامل

    أكثر من 30 وكيلًا، وأكثر من 50 مهارة، وأكثر من 6 hooks، وبوّابات harness، وتعلّم تراكمي، وكشف تدريجي، وتنسيق بين الوكلاء — كلها مضبوطة وتعمل معًا. استغرق هذا النظام أشهرًا من التكرار. ويسلّم Second Brain نسخةً مخصّصة في ساعات.

    اطّلع على ما هو مشمول
    المرحلة 5

    التكامل: اتّصالات MCP

    MCP (Model Context Protocol) طريقة قياسية لربط Claude Code بأدوات خارجية. اعتبره USB-C للذكاء الاصطناعي — بروتوكول واحد يتّصل بكل شيء.

    بنية MCP (مبسّطة)
    ┌─────────────────────────────────────────────┐
    │ Claude Code                                 │
    │  └─ MCP Client (built-in)                  │
    └─────────┬───────────────────────────────────┘
              │
              ├─ MCP Server: Gmail
              │   └─ Functions: send_email, search, read
              │
              ├─ MCP Server: HubSpot
              │   └─ Functions: create_contact, update_deal
              │
              ├─ MCP Server: PostgreSQL
              │   └─ Functions: query, insert, update
              │
              └─ MCP Server: Google Calendar
                  └─ Functions: create_event, list_events

    أدوات العمل

    • • HubSpot (CRM)
    • • Gmail
    • • Google Calendar
    • • Notion
    • • Slack

    أدوات التطوير

    • • GitHub
    • • Linear
    • • PostgreSQL
    • • Jira

    التحليلات

    • • Google Analytics
    • • Stripe
    • • Mixpanel

    مثال واقعي: عمليات المبيعات

    المهمة: وسم 200 مشارك في الندوة في HubSpot

    بدون MCP: 35 دقيقة

    1. 1. تصدير المشاركين من Zoom
    2. 2. فتح HubSpot
    3. 3. مطابقة رسائل البريد يدويًا
    4. 4. استيراد جماعي مع الوسوم
    5. 5. إصلاح الأخطاء

    مع MCP: 3 دقائق

    1. 1. «وسِم المشاركين من ‎webinar.csv‎»
    2. 2. يتّصل Claude بـ HubSpot
    3. 3. تمّ.

    النقطة التعليمية: قد يكون إعداد MCP أكبر حاجز زمني

    بنى Andrew (مدير منتج، هولندا) نظامًا مؤتمتًا لتتبّع البحث عن عمل — كاشط LinkedIn ← قاعدة بيانات ← مجدوِل متابعة. إعداد MCP بنفسه: 6-8 ساعات من تصحيح OAuth. بقوالب Second Brain: 20 دقيقة.

    شاهده عمليًا

    MCP واحد، ثلاث منصّات، 96 ثانية

    المخطّطات المجرّدة لطيفة. وإليك ما يفعله MCP فعلًا: أمر واحد يسحب 20 منشورًا من كلٍّ من Reddit وX وLinkedIn — 60 نقطة بيانات تُحلَّل في أقل من دقيقتين. دون نسخ ولصق بين علامات التبويب.

    عرض مباشر: بحث AnySite MCP عبر 3 منصّات (يبدأ عند 5:33)
    من جلسة عمل مشترك مباشرة — اتّصال MCP واحد يمسح Reddit وX وLinkedIn في آنٍ واحد لبحث عن توقّعات الذكاء الاصطناعي.

    يستغرق تصحيح OAuth الخاص بـ MCP 6-8 ساعات في المتوسّط

    تتضمّن باقة Done-With-You جلسة إعداد مباشرة نربط فيها أدوات Gmail والتقويم والـ CRM وقاعدة البيانات معًا — إضافةً إلى قوالب يمكنك إعادة استخدامها لاتّصالات الأدوات المستقبلية.

    اطّلع على Done-With-You

    قائمة التحقّق للمرحلة 5

    ما الذي بناه العملاء فعلًا (الشهر الأول)

    الأسبوع 1: Damian (مستشار ذكاء اصطناعي، سويسرا)

    نظام أتمتة محتوى لوسائل التواصل. التقاط الأفكار ← استخراج بصمة الصوت على LinkedIn ← توليد ملفات PDF متعدّدة الشرائح ← جدولة المنشورات. «أخبرني صديق للتوّ عن هذا الحلّ الجديد الرائع الذي اشتراه. كان ذلك بالضبط ما بنيته في يومين بالـ Second Brain.»

    الأسبوع 2: Andrew (مدير منتج، هولندا)

    نظام مؤتمت لتتبّع البحث عن عمل. كاشط LinkedIn، وقاعدة بيانات للطلبات، ومجدوِل متابعة. استبدل أداة SaaS تجارية كان يدفع لها شهريًا — بناه في يومين بالـ Second Brain.

    الأسبوع 3: Dominic (مستشار سحابي)

    تقارير حالة أسبوعية مؤتمتة للعملاء. تكامل MCP مع Salesforce يسحب بيانات الصفقات، وMicrosoft Graph لسياق التقويم/البريد. وفّر 3 ساعات أسبوعيًا من العمل الإداري.

    الأسبوع 4: Richard (مستشار إداري، أستراليا)

    بعد تخبّط بمفرده لأسبوع: «لقد حللت لي في هذه المكالمة ما كنت لا أزال أخطئ فيه، فقد كنت أتعامل معه وكأنه روبوت محادثة. أما باستخدام الأوامر والوكلاء، فيمكنك فعليًا أن تجعله يدير سير عملك اليومي نيابةً عنك. يستحق المال قطعًا لأنه وفّر عليّ ثلاثة أو أربعة أشهر من التخبّط وحدي.»

    المرحلة 6

    الخطوات التالية: طريقك إلى الأمام

    لقد رأيت كيف يبدو النظام الكامل: بنية كشف تدريجي، وhooks قابلة للإنفاذ، وتعلّم تراكمي، وإطار المهارات مقابل الوكلاء، وعمليات تكامل MCP. بناء هذا من الصفر يستغرق 3-4 أسابيع من التجربة والخطأ— تصحيح بنى الملفات، وكتابة الـ hooks، واختبار مشغّلات المهارات، وإعداد تدفّقات OAuth الخاصة بـ MCP، وتصميم مخطّطات الذاكرة...

    أو يمكنك تخطّي كل ذلك والحصول على نسخة مخصّصة في ساعات.

    «كان هذا من أفضل الاستثمارات لي ولعملي. فقد فتح لي عالم العمل الوكيلي السهل الضبط. صارت أدوات الذكاء الاصطناعي العادية الآن تبدو وكأنها لعب أطفال.»

    — Damian، مستشار ذكاء اصطناعي • عميل Done-With-You بنى نظام أتمتة محتوى متكاملًا في يومين

    الصورة الكاملة

    5 مهام. 20 دقيقة. نظام واحد.

    فرز البريد، وردود العملاء، والتحليل المالي، ومحتوى LinkedIn، وصفحة هبوط — كلها انطلقت من الطرفية نفسها في جلسة واحدة. هذا ما يسلّمه النظام الكامل.

    ملخّص مباشر: 5 مهام أُنجزت في 20 دقيقة (يبدأ عند 28:07)
    من ندوة Second Brain الإلكترونية — ملخّص لكل ما أُنجز في جلسة واحدة: رسائل بريد، ومحتوى، وتقارير مالية، وردود عملاء، وصفحة هبوط.

    اختر طريقك

    $197

    باقة DIY

    مستودع Second Brain كامل بالوكلاء والأوامر والمهارات. وأنت تتولّى الإعداد بنفسك.

    • ✅ مستودع Second Brain كامل
    • ✅ نظام hooks معدّ مسبقًا
    • ✅ أدلّة إعداد MCP
    • ✅ دعم قائم على الوثائق

    الجدول الزمني: 1-2 أسبوع للإعداد

    $597

    باقة Kickstart

    كل ما في DIY + وكيل ذكاء اصطناعي يضبط نظامك انطلاقًا من إجابات الاستبيان.

    • ✅ كل ما في DIY، مخصّص لك
    • ✅ وكيل ذكاء اصطناعي يبني النظام من إجاباتك
    • ✅ دعم غير متزامن ذو أولوية خلال 48 ساعة
    • ✅ السنة الأولى من MemoryOS Pro مشمولة (بقيمة 349 دولارًا)

    الجدول الزمني: يعمل في دقائق، لا أسابيع

    $2,497

    Done-With-You

    كل ما في Kickstart + مكالمة تهيئة مدّتها ساعتان مع Iwo. نشر كامل للبنية التحتية.

    • ✅ كل ما في Kickstart
    • ✅ مكالمة تهيئة مدّتها ساعتان مع Iwo
    • ✅ نشر كامل للبنية التحتية (Vercel + Supabase)
    • ✅ تحديثات شهرية للـ Second Brain
    • ✅ 12 شهرًا من MemoryOS مشمولة

    الجدول الزمني: منتج في ساعتين

    ملحق: أنماط متقدّمة

    أمستعدّ لبناء Second Brain الخاص بك؟

    ثلاث باقات متاحة — من قوالب DIY إلى التطبيق done-with-you.

    اطّلع على الباقات

    ضمان استرداد المال خلال 30 يومًا • وفّر أكثر من 10 ساعات في الشهر الأول أو استرداد كامل