لمستخدمي Claude Code

يبدأ Claude كل جلسة أعمى.

CLAUDE.md يخبر Claude كيف يتصرَّف. إنه لا يخبر Claude بما يوجد في مستودعك. تفهرس Maguyva قاعدة الكود وتعيدها عبر MCP، لذا يحرِّر Claude وكأنه قرأ الكود بالفعل.

ابدأ مجانًا اقرأ دليل إعداد Claude Code

خطة Free: 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

استخدم CLAUDE.md للسلوك. استخدم Maguyva لحقائق قاعدة الكود الحالية.

‏CLAUDE.md ممارسة فضلى. استخدمه.

> cat CLAUDE.md
# project conventions, commands, scoped rules

التعليمات الدائمة مكانها CLAUDE.md. إنه المكان الصحيح لـ:

أوامر البناء والاختبار والـlint التي ينبغي أن يشغِّلها الوكيل.
قواعد أسلوب الترميز وأعراف التسمية.
ضوابط “افعل X دائمًا / لا تفعل Y أبدًا” المحدَّدة النطاق لمجلد معيَّن.
إشارات إلى الوثائق المرجعية وسجلّات القرارات.

تصف وثائق الذاكرة من Anthropic هذا جيدًا. اجعله موجزًا. حدِّد نطاقه. التزم به.

لكن CLAUDE.md لم يُقصَد به قط أن يكون خريطة لقاعدة الكود لديك.

أين يتوقّف CLAUDE.md عن الكفاية

أربعة أنماط فشل لا يمكن لملف markdown وحده إصلاحها.

‏// الملف ليس قاعدة الكود

إخبار Claude كيف يتصرَّف لا يخبره بما هو موجود. التعديل الأول على مستودع غير مألوف هو تخمين لمسارات الملفات وأسماء الدوال ومواقع الاستدعاء. لا يمكن لـCLAUDE.md سرد كل رمز، ولن ترغب في ذلك أصلًا.

‏// الوثائق تصبح قديمة، والكود لا

قسم في CLAUDE.md يصف تدفق المصادقة لديك يكون صحيحًا إلى أن يعيد أحدهم هيكلة المصادقة. الكود الآن هو مصدر الحقيقة، والوثائق خاطئة بثقة زائفة. يقرأ Claude الوثيقة الخاطئة.

‏// التبعيات ليست في ملفات markdown

«ما الذي سيتعطَّل إن غيّرت هذه الدالة؟» سؤال يخص الرسم البياني. لا يمكن الإجابة عنه من ملف وثائقي. إما أن يبحث Claude بـgrep ويدعو أن ينجح، أو يطلب منك لصق الملفات في المحادثة.

‏// نوافذ السياق لها ميزانية

حشو CLAUDE.md إلى أن “يعرف Claude ما يكفي” يستهلك رموزًا (tokens) كان ينبغي أن تُنفَق على الاستدلال. بعد بضع كيلوبايتات، تستبدل جودة الإجابة بحجم السياق.

Maguyva هي الطبقة التي لا يغطّيها CLAUDE.md

خادم MCP بعيد يمنح Claude Code:

بحث دلالي، وAST، ورسم بياني، ونصي عبر مستودعك المُفهرَس، تُعاد نتائجه مع مسارات الملفات وأرقام الأسطر.
عمليات بحث عن التبعيات، والأنواع، ومواقع الاستدعاء الأسئلة التي يجيب عنها الرسم البياني ولا يستطيع ملف وثائقي الإجابة عنها.
نتائج واعية بالفرع لذا يرى Claude نسخة الكود التي يحرِّرها فعليًا.
تسعير مساحة العمل لا لكل مقعد. افهرس مستودعًا واحدًا أو 50؛ الوكلاء لا يدفعون مقابل مقاعد.

‏CLAUDE.md يخبر Claude كيف يتصرَّف.
Maguyva تمنح Claude خريطة قابلة للاستعلام عن الكود.

ثلاثة تدفقات عمل

مرقَّمة وغنيّة بكتل الكود. الأسئلة التي تطرحها على Claude بالفعل، مؤسَّسة على أسطر حقيقية.

// workflow 01

إيجاد التنفيذ الحقيقي، لا البديل الاختباري

أنت: "كيف تعمل آلية إعادة المحاولة (retry) في عميل الدفع لدينا؟"

بلا Maguyva → يبحث Claude بـgrep عن retry، يجد 14 نتيجة، ويختار واحدة (غالبًا محاكي اختبار).
مع Maguyva    → تُرجع Maguyva تعريف الرمز، ومواقع الاستدعاء، و
                   file:line للتنفيذ الحقيقي، مرتَّبة.

// workflow 02

تحقّق من نطاق التأثير قبل إعادة الهيكلة

أنت: "ما الذي يستدعي normalizePhoneNumber؟"

تُرجع Maguyva: 7 مواقع استدعاء عبر 4 حزم، من بينها موقع في خدمة Python
تستورده عبر بديل gRPC. يقترح Claude التغيير مع قائمة
الترحيل مضمَّنة، لا بعد أن يتحوّل CI إلى الأحمر.

// workflow 03

تحقّق من الوكيل قبل قبول الفرق

Claude: "عدَّلت src/auth/session.ts:142 لإصلاح تجديد الرمز المميّز (token refresh)."

اسأل Maguyva: "أرِني session.ts:130-160 وأي شيء يستورد session."

تُرجع Maguyva شريحة الملف الحية + 3 مستوردين. الفرق الآن مؤسَّس
على أسطر حقيقية، لا على تذكُّر Claude من الرمز (token) رقم 11,000.

الإعداد في Claude Code

ثلاث خطوات. خطة Free: 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

// step 01
افهرس مستودعًا على maguyva.ai
اختر مستودعًا تعرفه جيدًا حتى تستطيع التحقق من الإجابات. تغطي خطة Free 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع.

// step 02

ثبِّت إضافة Maguyva في Claude Code

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx

// step 03
اطرح سؤالًا واحدًا تعرف إجابته مسبقًا
ابدأ بمستودع واحد وسؤال واحد يمكن التحقق منه، لا بشركتك بأكملها. إذا طابقت الإجابة ما كنت لتقوله، فأنت جاهز.