وثائق

تم التثبيت لكن يبدو أنه غير مستخدم؟ في الحالات التي تدعم فيها المنصة استخدام الـ hooks، يتم إرسال الذاكرة إلى العميل دون الحاجة إلى أي تعليمات إضافية. أما في الحالات التي لا تدعم فيها المنصة ذلك، فإن عملية الإعداد تقوم بكتابة قسم الذاكرة في ملف سياق المنصة نفسها، حتى يعرف العميل كيفية الوصول إليها. إذا بدت الذاكرة متصلة لكن العميل لا يحاول الوصول إليها أبدًا، فإن ذلك الملف هو أول شيء يجب التحقق منه.

ما يتم كتابته في Claude Code

في Claude Code، يحتفظ أمر pip install (brethof-brain install-hooks) بـ كتلة مُدارة واحدة في ملف CLAUDE.md الخاص بك، تُعاد كتابتها عند بدء كل جلسة. إنها مؤشر، وليست نسخة من التعليمات — فهي تخبر وكيلك بأن الذاكرة هي Brain، وكيفية الوصول إليها، وأنه عندما تقول "تذكّر هذا" يذهب الأمر إلى Brain، وليس إلى ملفات الذاكرة الخاصة بـ Claude Code على جهاز واحد. التعليمات الفعلية تصل عند بدء الجلسة. ولا تلمس أبدًا أي شيء خارج الكتلة: تظل اصطلاحاتك الخاصة ملكك. لإيقاف ذلك، عيّن BRETHOF_BRAIN_NO_CLAUDE_MD=1. الإضافة لا تكتبه أبدًا: مع تثبيت الإضافة، الصق الكتلة من ملف README الخاص بها في ~/.claude/CLAUDE.md، أو اطلب ذلك من وكيلك.

الأوامر والإصدارات

يأتي مكون Claude Code الإضافي مع ثلاثة أوامر: /recall (البحث الفوري)، /onboard (الدقيقة الأولى لمشروع ما)، و/curate (إنهاء الجلسة). لا يوجد شيء يحتاج إلى تشغيل يدويًا — فالذاكرة تقوم بتنظيم وترتيب السجلات تلقائيًا.

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

ما يمكن لوكيلك الوصول إليه

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

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

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

القواعد هي الوسيلة التي تمنعك من تكرار نفسك؛ إنها الأعراف والقيود والتصحيحات التي يجب على العاملين معك ألا ينسوها أبدًا. القواعد الجيدة تشبه القوانين: “لا تستخدموا هذه الأداة يوم الجمعة”， “يجب استخدام علامات التبويب وليس المسافات في هذا المشروع”， “اسم العميل هو Brethof، وليس Brefoth”. قواعد مختصرة، قاطعة، وسارية حتى الشهر القادم.

اطلب من وكيلك حفظ قاعدة، وسيسألك شيئًا واحدًا: هل ينطبق ذلك على كل ما تقوم به، أم فقط على هذا المشروع؟

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

القواعد تُعلّم المنظّم، وليس الوكيل فقط

المشروع الذي يحتوي على قواعد واضحة قليلة يتذكر بشكل أفضل بوضوح من المشروع الذي لا يحتوي على أي قواعد — لأن القواعد تخبر المنسق بما هو مهم فيه. احفظ قاعدة واحدة، وخلال دقائق قليلة، تكون ذاكرة ذلك المشروع قد أعادت تعلم ماهيته.

الحفاظ على حدتها

يجب أن تكون القاعدة قصيرة بما يكفي لكي تتمكن من نطقها بصوت عالٍ؛ فإذا لم تكن كذلك، فمن المحتمل أن تكون مجرد معرفة ترتدي ثوب القاعدة. دمج القواعد المتكررة في قاعدة واحدة، وحذف القواعد التي أصبحت عفا عليها الزمن؛ لا يوجد شيء يقوم بحذفها نيابة عنك، لأنه لا ينبغي السماح لأي شيء آخر بتحديد ما هي قوانينك. دزينة من القواعد تؤمن بها أفضل من خمسين قاعدة توقفت عن قراءتها.

المشاريع عمليًا

القرار الحقيقي الوحيد هو كيفية تقسيمها: واحد لكل قاعدة كود، أو لكل عميل أو مشروع، وهذا هو النمط الفعّال. إذا كان عددها قليلاً جداً، فإن المهام غير المرتبطة ببعضها تختلط معاً؛ وإذا كان عددها كبيراً، فإن السياق يصبح مشتتاً. بدء أي مشروع بغرض واضح في جملة واحدة – ما هو ذلك الغرض وما يجب تذكره – هو أفضل استثمار للوقت الذي يمكن تخصيصه. فهذا يساعد المسؤول عن إدارة المشروع منذ اليوم الأول، بدلاً من تركه يحاول استنتاج نواياك من خلال الفقرات المتفرقة.

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

إذا انتهت الاشتراكات

يتوقف Brain فورًا — لا توجد فترة مهلة. يتم أرشفة ذاكرتك بعد اليوم 7، ويتم تحذيرك في حوالي اليوم 23، ثم يتم حذفها في اليوم 30. الحسابات المدفوعة والنشطة لا تتأثر أبدًا. يمكن العثور على الجدول الزمني الكامل والرسائل الإلكترونية المرافقة له في سياسة الخصوصية.

الفجوة التي يتركها الحد، ولماذا لا نملأها أبدًا

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

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

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

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