---
title: Agent Memory Kit
title_ar: عدّة الذاكرة لمساعدك
url: "https://www.aiwithmo.com/shop/agent-memory-kit"
canonical: "https://www.aiwithmo.com/shop/agent-memory-kit"
price: Free
category: template
languages: [ar, en]
site: aiwithmo
---

# Agent Memory Kit

## عدّة الذاكرة لمساعدك

Source: https://www.aiwithmo.com/shop/agent-memory-kit · Price: Free

The basic memory setup for the AI assistant you already work with: a settings block it loads every session, a project file it reads before anything else, and an optional skill that builds the structure and repairs it. It is the foundation, set up by hand. The full, production-ready system is the Memory Engine.

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

## Details

## The basic kit, and the full system

This is the basic kit: the memory rules your assistant follows, set up by hand in one project. It is the base everything else sits on, and it is free. The full, production-ready system is the [Memory Engine](/lp/memory-engine), built on the same idea and run by a machine instead of by habit.

| | Agent Memory Kit (free, this page) | Memory Engine |
|---|---|---|
| What it is | The memory rules, set up by hand | The full, production-ready system |
| Who writes the memory | Your assistant, at four set moments | The engine, every 15 minutes, by itself |
| Which assistants | The one you set it up in | ChatGPT Codex, Claude Code, Claude Cowork, Gemini and Cursor, into one folder |
| Finding something later | Open the file you remember | Search across everything, in English and Arabic |
| Passwords and keys | A rule never to write them down | Hidden before anything is sent, and it stops if it cannot |
| Seeing all of it | Read the files | A dashboard of every person, project and term, rebuilt every 15 minutes |

The kit is where the habit starts. When you want the memory to keep itself, **[see how the Memory Engine works](/lp/memory-engine)**.

## What it is

The memory layer of an AI operating system, and the piece almost nobody installs. Everything else you do with an assistant sits on top of it: without memory, you are re-briefing it every morning for the rest of your life, which is why most people quietly conclude their assistant is dumber than it is.

Right now it opens every session knowing nothing about your work: not what you decided yesterday, not who the client is, not why the last approach was dropped. The notes it does keep end up in a directory that gets wiped between sessions, or in one file while a second file that needed the same edit goes stale.

This kit is the protocol that closes that gap. A small set of rules your assistant reads before it touches anything, and a project file it keeps current while you work.

It comes in three pieces because they load at different moments, and merging them makes all three worse.

### 1. Global settings

A block you paste once per machine into your tool's global instruction field. It has to run before any file is read, which is exactly why it cannot live inside the project file. Under 2 KB, so it costs almost nothing per session. It defines when your agent reads memory (the map first, then the file whose subject the task actually touches) and when it writes.

### 2. Project template

A `CLAUDE.md` or `AGENTS.md` for the project root, carrying the three sections the global block checks for: a memory map, an active tasks table, and update rules. One per project. This part is the content, not the protocol.

### 3. Skill

`memory-structure`, optional. It holds the spec for the instruction file and the logic for repairing one that is missing a section, and it loads only in sessions where the structure is actually being built or fixed, which for most projects is one session in twenty.

## Where each piece goes

| Tool | Global settings | Project file |
|---|---|---|
| Claude Cowork | Settings, Cowork instructions | `CLAUDE.md` |
| Claude Code | `~/.claude/CLAUDE.md` | `CLAUDE.md` |
| Codex | `~/.codex/AGENTS.md` | `AGENTS.md` |
| Cursor | Settings, Rules, User Rules | `AGENTS.md` |

Piece 1 goes in once per machine, piece 2 once per project. The skill goes to your tool's skills folder when it has one, and gets pasted into the chat on the day you need it when it does not.

## The rules your agent ends up following

- Read the project instruction file before anything else, check that its three sections are there, and offer to fix the structure instead of quietly rewriting it.
- Never create an instruction file or a memory folder unasked. The folder appears at the moment of the first real write, and your agent says so in that turn.
- Write at four moments, without being told: end of session, a decision that changes how future work happens, a new person, client, project or term, and anything already in memory that turned out to be wrong.
- Never record an inference as a fact. Anything unconfirmed is written as an assumption or an open question, and labelled as one.
- Never write credentials, keys or tokens into a memory file.
- Never write memory outside the project, and never into a temp or session directory, because some tools wipe those between sessions.
- Show the diff before saving, and replace a superseded fact rather than stacking the new version underneath the old one.

## Installing it

Hand the whole folder to your agent and say "install this kit". It reads `0-INSTALL-ME.md`, states which tool it is running in, prints the block you have to paste yourself wherever it cannot write to settings, sets up one project, and finishes with a list of what it wrote and what it skipped. It asks before every write, and it never overwrites an instruction file you already have. About five minutes, most of that reading.

## What to check after a week

Open the memory folder and read what is in it. If guesses are sitting there written as facts, the protocol is not doing its job and the file needs pruning. That failure mode is a quiet one, and it is the one worth watching for.

## When the basic kit is not enough

The kit gives you the protocol, and the protocol has a ceiling: it remembers what you or your assistant remembered to write down, in the one project you set up. Good sessions still slip through on the days you are moving fast, which are exactly the days worth keeping.

The Memory Engine is the full, production-ready version, and it takes that ceiling off. Every session is captured on its own, with no one deciding what deserves saving. Recall runs by search across everything you have ever worked on, instead of by opening the one file whose name you happened to remember. Your assistant walks into a brand new project already holding the decisions, the people and the constraints from all the others, on day one.

That is the difference between an assistant that keeps notes and one that has a memory.

**[See the full system: the Memory Engine](/lp/memory-engine)**

## التفاصيل

## العدّة الأساسية، والنظام الكامل

هذه هي العدّة الأساسية: قواعد الذاكرة التي يتبعها مساعدك، وتجهّزها بيدك في مشروع واحد. هي الأساس الذي يقوم عليه كل ما بعدها، وهي مجانية. أما النظام الكامل الجاهز للعمل فهو [محرّك الذاكرة](/lp/memory-engine/ar)، المبني على الفكرة نفسها، لكن الآلة هي التي تشغّله بدل أن يعتمد على عادتك.

| | عدّة الذاكرة (مجانية، هذه الصفحة) | محرّك الذاكرة |
|---|---|---|
| ما هي | قواعد الذاكرة، تجهّزها بيدك | النظام الكامل الجاهز للعمل |
| من يكتب الذاكرة | مساعدك، في أربع لحظات محددة | المحرّك نفسه، كل 15 دقيقة، من دون أن تطلب |
| أي مساعدات | المساعد الذي جهّزتها فيه | ⁨ChatGPT Codex⁩ و⁨Claude Code⁩ و⁨Claude Cowork⁩ و⁨Gemini⁩ و⁨Cursor⁩، في مجلد واحد |
| العثور على معلومة لاحقاً | تفتح الملف الذي تتذكر اسمه | بحث في كل شيء، بالعربية والإنجليزية |
| كلمات السر والمفاتيح | قاعدة تمنع كتابتها | تُخفى قبل إرسال أي شيء، ويتوقف إذا تعذّر ذلك |
| رؤية الصورة كاملة | تقرأ الملفات بنفسك | لوحة تعرض كل شخص ومشروع ومصطلح، وتُحدَّث كل 15 دقيقة |

العدّة هي المكان الذي تبدأ منه العادة. وعندما تريد أن تحفظ الذاكرة نفسها بنفسها، **[شاهد كيف يعمل محرّك الذاكرة](/lp/memory-engine/ar)**.

## ما هي

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

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

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

وهي ثلاث قطع، لأن كل واحدة تُقرأ في لحظة مختلفة، وجمعها في مكان واحد يُفسد الثلاث.

### 1. الإعدادات العامة

مقطع تلصقه مرة واحدة على كل جهاز، في خانة التعليمات العامة للأداة. يجب أن يعمل قبل قراءة أي ملف، ولهذا بالضبط لا يمكن أن يعيش داخل ملف المشروع. حجمه أقل من ⁨2 KB⁩، فكلفته في كل جلسة لا تكاد تُذكر. وهو الذي يحدد متى يقرأ مساعدك الذاكرة (الخريطة أولاً، ثم الملف المرتبط بموضوع المهمة) ومتى يكتب فيها.

### 2. قالب المشروع

ملف `CLAUDE.md` أو `AGENTS.md` في جذر المشروع، يحتوي على الأقسام الثلاثة التي يبحث عنها المقطع العام: خريطة الذاكرة، وجدول المهام الجارية، وقواعد التحديث. ملف واحد لكل مشروع. هنا المحتوى، لا البروتوكول.

### 3. الـ ⁨skill⁩

اسمها `memory-structure`، وهي اختيارية. فيها مواصفات ملف التعليمات، وطريقة إصلاح ملف ينقصه قسم. ولا تُحمَّل إلا في الجلسات التي يُبنى فيها الهيكل أو يُصلح، وهي في معظم المشاريع جلسة واحدة من كل عشرين.

## أين توضع كل قطعة

| الأداة | الإعدادات العامة | ملف المشروع |
|---|---|---|
| Claude Cowork | Settings, Cowork instructions | `CLAUDE.md` |
| Claude Code | `~/.claude/CLAUDE.md` | `CLAUDE.md` |
| Codex | `~/.codex/AGENTS.md` | `AGENTS.md` |
| Cursor | Settings, Rules, User Rules | `AGENTS.md` |

القطعة الأولى مرة واحدة على الجهاز، والثانية مرة واحدة لكل مشروع. أما الـ ⁨skill⁩ فتوضع في مجلد الـ ⁨skills⁩ الخاص بأداتك إن وُجد، وإن لم يوجد تلصقها في المحادثة يوم تحتاجها.

## القواعد التي يتبعها مساعدك

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

## كيف تركّبها

أعطِ مساعدك المجلد كله وقل له: ركّب هذه العدّة. سيقرأ `0-INSTALL-ME.md`، ويخبرك بالأداة التي يعمل فيها، ويطبع لك المقطع الذي عليك لصقه بيدك حيث لا يستطيع الكتابة في الإعدادات، ويجهّز مشروعاً واحداً، ثم يعطيك قائمة بما كتبه وما تخطاه. يسأل قبل كل كتابة، ولا يستبدل ملف تعليمات موجوداً عندك. نحو خمس دقائق، معظمها قراءة.

## ما الذي تراجعه بعد أسبوع

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

## حين لا تكفي العدّة الأساسية

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

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

هذا هو الفرق بين مساعد يحتفظ بملاحظات، ومساعد لديه ذاكرة.

**[شاهد النظام الكامل: محرّك الذاكرة](/lp/memory-engine/ar)**