فایل‌های حافظهٔ محلی؛ راهکار توقف بازنشانی زمینه در جلسات هوش مصنوعی

تصور کنید هر روز ۱۰ دقیقه از زمان خود را در شروع هر جلسه با هوش مصنوعی، صرف توضیح دوباره استک فنی پروژه خود می‌کنید. این اتلاف وقت، نتیجهٔ «راه‌اندازی سرد» (Cold Start) در هر جلسه است. مالک، مهندس موبایل با ۹ سال تجربه و نویسنده خبرنامه Code Meet AI، استدلال می‌کند که تنها راه توقف این بازنشانی مداوم، انتقال حافظه از لایه‌های مدل به داخل مخزن کد (Repo) شماست. در ۱۰ جولای ۲۰۲۶، او سیستمی را با جزئیات شرح داد که با استفاده از دو فایل Markdown خاص، جلسات چت گذرا را به یک دارایی دائمی و تراکمی تبدیل می‌کند.

bیشتر توسعه‌دهندگانی که از ابزارهایی مثل Claude Code یا Cursor استفاده می‌کنند، با شروع هر جلسه با یک «کوری‌بند» یا شروع کور مواجه می‌شوند. شما زمان ارزشمندی را صرف تعریف این موضوع می‌کنید که کلاینت API در کجا قرار دارد، کدام فایل‌ها تولید می‌شوند و از کدام قراردادها یا الگوهای کدنویسی عبور کرده و به کدام‌ها منتقل شده‌اید. این چرخه هر روز تکرار می‌شود زیرا هوش مصنوعی پس از پایان هر جلسه، هیچ یادداشتی نگه نمی‌دارد. این یک فقدان ارزش تراکمی است که ربطی به هوش مدل ندارد، بلکه به نحوه تنظیمات اولیه مربوط می‌شود. مالک اشاره می‌کند که هر جلسه مانند یک تماس تلفنی است؛ وقتی تماس قطع می‌شود، طرف مقابل هیچ یادداشتی نمی‌گیرد مگر اینکه کسی آن‌ها را مکتوب کند.

او به رشته‌توییتی در r/ClaudeAI با عنوان «اغلب فراموش می‌کنم چه تعداد از مردم در مواجهه با کلود (یا هر هوش مصنوعی دیگری) بی‌اطلاع هستند» اشاره می‌کند. اگرچه لحن این پست تند و سخت است، اما شکافی که به آن اشاره دارد واقعی است. افرادی که ارزش تراکمی از این ابزارها می‌گیرند، لزوماً باهوش‌تر نیستند؛ آن‌ها صرفاً عادت «توضیح مجدد» (Re-briefing) دستیار را در هر صبح کنار گذاشته‌اند و اجازه نداده‌اند مدل هر بار از نقطه صفر شروع کند.

این مشکل با شکنندگی خلاصه‌های هوش مصنوعی تشدید می‌شود. مالک مثالی عینی از یک جلسه در روز سه‌شنبه می‌زند؛ جایی که مدل او گزارش داد بخشی از کار «ارسال» (Shipped) شده است. مدل با اطمینان اشاره کرد که کد ادغام (Merge) شده، منتشر شده و سیستم CI سبز است. در واقعیت، سرور هنوز داشت کدی را سرو می‌کرد که متعلق به هفته پیش بود. او تنها زمانی متوجه این موضوع شد که به‌جای اعتماد به خلاصه هوش مصنوعی، به‌صورت دستی اندپوینت را چک کرد. او به‌جای اینکه فقط باگ را رفع کند، از هوش مصنوعی خواست این درس را یادداشت کند: «ادغام به معنای استقرار نیست. قبل از اینکه بگویی ارسال شده، اندپوینت زنده را با curl بررسی کن و SHA انتشار را دوبار با نسخه ادغام‌شده چک کن».

صبح روز بعد، در یک جلسه کاملاً جدید و با زمینه صفر، مدل توانست اشتباه مشابهی را در حین npm publish تشخیص دهد؛ زیرا آن یادداشت روز سه‌شنبه در فایلی قرار داشت که مدل در هنگام استارت‌آپ می‌خواند. مدل توانست به تنهایی همان کلاس از اشتباه را شکار کند. این ترفند اصلی است: حافظه در مخزن شما زندگی می‌کند، نه در ویژگی‌ای (Feature) که منتظر باشید شرکت سازنده آن را در آپدیت‌های بعدی اضافه کند. این سیستم به‌طور ارگانیک در مخازن کد مالک رشد کرد و در نهایت برای مدیریت «مغز دوم» او در Obsidian نیز گسترش یافت. این رویکرد دستی، پاسخی به چالش‌های سیستماتیک حافظه در مدل‌هاست؛ در حالی که برخی ابزارها تلاش کرده‌اند مشکل فراموش‌کاری عامل‌های هوش مصنوعی را با حافظه‌های ترکیبی گراف-بردار حل کنند، مالک بر سادگی و شفافیت فایل‌های متنی تمرکز کرده است.

راهکار، ایجاد یک بانک حافظه محلی است. به‌جای انتظار برای قابلیت‌های پلتفرم، یک پوشه به نام .memory/ در ریشه پروژه بسازید. بر اساس راهنمای Code Meet AI، این سیستم اطلاعات را به دو دسته‌بندی یا «سطل» تقسیم می‌کند: چیزهایی که همیشه درست هستند و چیزهایی که در طول زمان یاد گرفته می‌شوند.

قوانین خانه (زمینه ایستا)

قوانین خانه، مرزها و قراردادهای پروژه شما هستند. این‌ها حقایق «ثابتی» هستند که به‌ندرت تغییر می‌کنند. در Claude Code، این فایل دقیقاً CLAUDE.md است؛ در Cursor، فایل .cursorrules است و ابزارهای دیگر ممکن است از AGENTS.md استفاده کنند. این یک بریف تک‌صفحه‌ای است که هوش مصنوعی در شروع هر جلسه می‌خواند. این فایل شامل موارد زیر است:

• استک فنی و مرزهای معماری پروژه.
• قراردادهای کدنویسی و استایل‌های خاص مورد تأیید.
• «خط قرمزها» (Hard no's)—چیزهایی که هوش مصنوعی هرگز نباید تغییر دهد یا به آن‌ها دست بزند.
• تبیین اینکه کدام فایل‌ها به‌صورت خودکار تولید می‌شوند و کلاینت API دقیقاً در کجا قرار دارد.

از آنجا که این قوانین به‌ندرت ویرایش می‌شوند، یک لنگر پایدار ایجاد می‌کنند. ترکیب این قوانین با حقایق در حال تغییر منجر به «پوسیدگی» (Rot) می‌شود؛ وضعیتی که در آن مدل به اطلاعات قدیمی تکی می‌کند در حالی که باور دارد آن‌ها هنوز قوانین اصلی و بنیادین هستند. جدا نگه داشتن این دو تضمین می‌کند که هر بخش صادق باقی بماند و مدل دچار تضاد نشود.

دفترچه خاطرات (پیشرفت‌ها و درس‌ها)

دفترچه خاطرات مواردی را ثبت می‌کند که هوش مصنوعی در حین پیشروی یاد می‌گیرد: یک اصلاح، تصمیمی که یک بحث فنی را بست، یا یک تله فنی (Gotcha). نمونه‌هایی از این دست عبارتند از:

• «اگر نسخه reanimated را بالاتر از مقدار پین‌شده ببرید، بیلد اندروید می‌شکند».
• «ما API ماه مارس را کنار گذاشتیم، دیگر آن را ایمپورت نکنید».
• «ادغام به معنای استقرار نیست».

مالک پیشنهاد می‌کند ابتدا با یک فایل ساده memory.md در ریشه مخزن شروع کنید و سپس در صورت نیاز آن را به یک پوشه کامل ارتقا دهید. این فایل یک درس خاص را ثبت کرده و به‌طور مکرر به‌روزرسانی می‌شود. نکته حیاتی این است که سیستم از قانون «هر یادداشت، یک حقیقت» پیروی کند تا مدیریت آن آسان شود.

مکانیک یادداشت‌های تک-حقایق

به‌جای خلاصه‌های طولانی از جلسات یا لیست تغییرات (Changelogs) که با زمان طولانی می‌شوند، هر حقیقت یادگرفته‌شده ورودی مخصوص به خود را به همراه تاریخ دریافت می‌کند. برای مثال: «۲۰۲۶-۰۷: ادغام به معنای استقرار نیست، قبل از گزارش ارسال، اندپوینت زنده را تایید کن».

این جزئی‌نگری ضروری است چون حافظه‌ها منقضی می‌شوند. یک حافظه منقضی‌شده بدتر از نبودِ حافظه است، زیرا مدل آن را با اطمینان کامل بیان می‌کند. وقتی یک کامپوننت بازنویسی (Refactor) می‌شود، یک راهکار موقت در لایه‌های بالاتر اصلاح می‌شود یا یک وابستگی پین‌شده تغییر می‌کند، شما می‌توانید فقط همان یک یادداشت خاص را حذف کنید بدون اینکه نیاز باشد یک خلاصه پیچیده و درهم‌تنیده را بازنویسی کنید. این کار از «پوسیدگی خاموش» حافظه جلوگیری می‌کند و اجازه می‌دهد حافظه با کد تکامل یابد. این موضوع یادآور این نکته است که ساختار حافظه می‌تواند بر میزان لجاجت یا انعطاف مدل اثر بگذارد و انتخاب فرمت درست، کلید پذیرش تغییرات جدید است.

حلقه ثبت (Capture Loop)

بانک حافظه تنها در صورتی کار می‌کند که از طریق یک عادت ثابت به‌روزرسانی شود. مکانیسم اصلی، یک ریتوال پایان جلسه است که حدود دو دقیقه زمان می‌برد. قبل از بستن تب یا پایان دادن به چت، از هوش مصنوعی بپرسید: «از این جلسه چه چیزی باید به خاطر بسپاری؟ آن را بنویس».

این ریتوال، یک جلسه خوب را از یک رویداد تبخاری که با بستن پنجره می‌پرد، به یک یادداشت دائمی تبدیل می‌کند. این یک «حرکت قدرتمند» است که یک چت گذرا را به یک دارایی تراکمی تبدیل می‌کند. مالک این کار را از طریق دو عادت پیاده می‌کند:
۱. در طول روز: هر چیزی که ارزش نگه داشتن دارد، بدون دسته‌بندی و به سرعت در یک یادداشت ورودی (Inbox) ریخته می‌شود.
۲. در پایان جلسه: هوش مصنوعی ریتوال را اجرا می‌کند، یادگیری‌ها را مرتب می‌کند، یادداشت‌های مجزا را می‌نویسد و ایندکس مربوطه را به‌روزرسانی می‌کند.

این رویکرد در جامعه کاربران نیز تکرار شده است؛ یک پست محبوب در r/ClaudeAI با نزدیک به ۳۰۰۰ رای تأکید کرد که پایان دادن به هر جلسه با دو پرسش خاص برای استخراج زمینه (Context)، باعث می‌شود هر چرخش از حلقه به‌سرعت اثر تراکمی ایجاد کند و بهره‌وری را به شدت افزایش دهد.

گردش‌کار پیاده‌سازی

برای راه‌اندازی این سیستم، مالک یک توالی دو مرحله‌ای از پرامپت‌ها را برای اتوماسیون ایجاد بانک حافظه ارائه می‌دهد.

پرامپت اول (راه‌اندازی):
«می‌خواهم حافظه‌ای برای این مخزن به تو بدهم. دو کار کن. اول، فایل .memory/context.md را بساز. قبل از نوشتن، از من مصاحبه کن: هر بار یک سوال درباره ماهیت این مخزن، استک، قراردادها و چیزهایی که هرگز نباید تغییر دهی بپرس. سپس یک بریف تک‌صفحه‌ای بنویس که بخواهی در شروع هر جلسه بخوانی. دوم، فایل .memory/progress.md را بساز. آن را با تاریخ امروز و یک خط درباره وضعیت فعلی کار شروع کن. از این به بعد، در شروع هر جلسه در این مخزن، هر دو فایل را بخوان».

پرامپت دوم (نگهداری):
«قبل از اینکه تمام کنیم، .memory/progress.md را به‌روز کن. تاریخ امروز و ۳ تا ۵ خط اضافه کن: چه کارهایی کردیم، چه تصمیماتی گرفتیم، چه مواردی هنوز باز هستند و هر چیزی که باید دفعه بعد به خاطر بیاوری. اگر امروز تو را اصلاح کردم یا قراردادی به تو دادم، آن را به‌جای فایل پیشرفت، در context.md قرار بده. هر دو فایل کوتاه نگه دار. هر چیزی که دیگر درست نیست را حذف کن».

این ساختار یک بانک حافظه ایجاد می‌کند شامل:

• your-repo/.memory/context.md: شامل استک، قراردادها، مرزها و خط قرمزها. یک بار نوشته می‌شود و به‌ندرت ویرایش می‌گردد.
• your-repo/.memory/progress.md: یک لاگ تاریخ‌دار از وضعیت واقعی کار (مثلاً: «۲۰۲۶-۰۷-۰۹: رفرکتور احراز هویت ارسال شد. باز: ریسِ توکن-رفرش. بعدی: اتصال بازسنج»).

اعتماد و محدودیت‌ها

این سیستم تضمین می‌کند که هوش مصنوعی به‌جای شروع از صفر، از جایی شروع کند که کد واقعاً در آن قرار دارد. در حالی که ابزارهایی مثل claude-mem یا حافظه داخلی ChatGPT و Claude وجود دارند، فایل‌های متنی ساده یک مزیت خاموش دارند: شما می‌توانید آن‌ها را باز کنید، diff بگیرید و بخش‌های غلط را با استفاده از تاریخچه Git حذف کنید. مالک اشاره می‌کند حافظه‌ای که نتوانید بازرسی‌اش کنید، حافظه‌ای است که نمی‌توانید به آن اعتماد کنید. این رویکرد شفاف، جایگزینی برای سیستم‌های پیچیده‌تری است که به‌جای بازیابی غیرفعال، از لایه‌های استدلالی برای مدیریت حافظه استفاده می‌کنند.

با این حال، این سیستم محدودیت‌های صادقانه‌ای دارد:

• ثبات در برابر صحت: حافظه باعث می‌شود هوش مصنوعی «ثابت‌قدم» باشد، نه لزوماً «درست». یک حقیقت غلط که در فایل نوشته شود، ماشینی می‌سازد که اشتباه را برای همیشه با ادب تکرار می‌کند.
• تأیید مجدد: کاربران باید اطلاعات بازیابی‌شده از حافظه، به‌ویژه ورودی‌های قدیمی، را مجدداً چک کنند تا از صحت آن‌ها مطمئن شوند.
• امنیت: هیچ راز، توکن، کلید یا داده خصوصی نباید وارد پوشه memory شود، زیرا این فایل‌ها معمولاً در Git ردیابی شده و در دسترس هم‌تیمی‌ها قرار می‌گیرند.
• انبارداری (Hoarding): هدف این است که از توضیح مجدد ۱۰ مورد تکراری جلوگیری کنید، نه اینکه هر اتفاق کوچکی را ثبت کنید. اگر ایندکس از یک صفحه بیشتر شود، این دیگر یادآوری نیست، بلکه انبارداری است که باعث سردرگمی مدل می‌شود.

با تبدیل حافظه به یک فایل قابل بازرسی، توسعه‌دهنده دوباره اعتماد خود را به دست می‌آورد. شکاف بین یک کاربر «ناآگاه» و یک کاربر «قدرتمند»، صرفاً حضور این دو فایل و عادت به حلقه ثبت است. شاخه بعدی خود را با ایجاد یک CLAUDE.md و یک پوشه حافظه خالی شروع کنید. دستیاری که هفته آینده با آن جفت می‌شوید، همین حالا توانمندتر از دستیاری است که امروز دارید. این سیستم بخشی از سری «استفاده درست از AI» در Code Meet AI است و اپیزود اول آن هنر پرامپت‌نویسی را پوشش داد. در قسمت بعدی: به کار انداختن هوش مصنوعی برای مدیریت «کارهای پیرامونیِ کار» (Work around the work).

گام بعدی شما

• در شاخه (branch) بعدی خود، یک فایل CLAUDE.md و یک پوشه .memory/ بسازید.
• ریتوال «چه چیزی باید به خاطر بسپاری؟» را به پایان هر جلسه با AI اضافه کنید.
• یادداشت‌های قدیمی را هر دو هفته یک‌بار بازبینی و پاک‌سازی کنید تا از پوسیدگی حافظه جلوگیری شود.