AI एजेंट्स को 'भूलने' से कैसे रोकें (मेमोरी फाइल्स का उपयोग करके)

ज़्यादातर AI एजेंट इसलिए फ़ेल नहीं होते क्योंकि मॉडल खराब है।

वे इसलिए फ़ेल होते हैं क्योंकि वे हर एक सत्र में भूलने की बीमारी (amnesia) के साथ जागते हैं।

आप Claude से कहते हैं: "हम pnpm का उपयोग करते हैं, npm का नहीं।"

अगले सत्र में: यह फिर से npm का उपयोग करने की कोशिश करता है।

आप कहते हैं: "यहाँ कोई default exports नहीं हैं।"

अगले सत्र में: यह एक default export लिखता है।

जैसे ही सत्र खत्म होता है, आपका हर सुधार गायब हो जाता है।

इसका एक फ़ाइल में फिक्स है।

मुझे इसे खोजने में खुद को तीन महीने तक दोहराते हुए लग गए।

यहाँ वह सब कुछ है जो मैंने सीखा।

ज़्यादातर AI एजेंट क्यों फ़ेल होते हैं

यह मॉडल नहीं है।

यह मॉडल के नीचे की गुम हुई परत है।

→ आप एक प्रॉम्प्ट लिखते हैं

→ एजेंट कार्य करता है

→ सत्र खत्म होता है

→ मेमोरी चली जाती है

→ अगला सत्र: वही गलतियाँ

→ आप वही निर्देश दोहराते हैं

→ हमेशा के लिए

यह लूप AI कोडिंग में समय बर्बाद होने का सबसे बड़ा एकल कारण है।

खराब कोड नहीं। भ्रम (hallucinations) नहीं।

दोहराव।

गुम हुई परत: मेमोरी

हर कोई इस बात पर अड़ा है कि कौन सा मॉडल सबसे स्मार्ट है।

गलत परत।

असली उन्नयन (upgrade) कोई स्मार्ट मॉडल नहीं है।

यह मॉडल को वह कुछ देने के बारे में है जो वह सीखता है उसे संग्रहीत करने की जगह।

→ प्रॉम्प्ट → एजेंट को अभी क्या करना है बताते हैं

→ एजेंट → कार्य को निष्पादित करते हैं

→ मेमोरी → सत्रों के बीच संदर्भ (context) को बनाए रखती है

→ स्थायी संदर्भ → कोई और बार-बार सुधार नहीं

→ सीखने की प्रणाली → एजेंट वास्तव में समय के साथ बेहतर होता जाता है

यह एक उपकरण (tool) और एक टीम के साथी (teammate) के बीच का अंतर है।

एक उपकरण हर बार शून्य से शुरू करके वही करता है जो आप कहते हैं।

एक टीम का साथी कल की बातें याद रखता है।

वे 5 मेमोरी फ़ाइलें जिनकी हर AI एजेंट को ज़रूरत है

एक बार जब आप स्वीकार कर लेते हैं कि मेमोरी गुम हुई परत है, तो अगला सवाल यह है: यह कहाँ रहती है?

पाँच फ़ाइलें। प्रत्येक का एक अलग काम।

→ CLAUDE.md — Claude का व्यक्तिगत ब्रीफिंग दस्तावेज़

→ AGENTS.md — सार्वभौमिक मानक, हर प्रमुख उपकरण द्वारा पढ़ा जाता है

→ CLAUDE.local.md — आपकी व्यक्तिगत प्राथमिकताएँ, git में कभी प्रतिबद्ध (commit) नहीं की जातीं

→ MEMORY.md — वे नोट्स जो AI अपने बारे में स्वचालित रूप से लिखता है

→ README.md — इंसानों के लिए, एजेंटों के लिए नहीं

आइए प्रत्येक को देखें।

CLAUDE.md — वह जिसने यह सब शुरू किया

इसे अपने प्रोजेक्ट रूट में डालें।

Claude इसे हर सत्र की शुरुआत में पढ़ता है।

इसे भूलने की बीमारी वाले एक नए टीम सदस्य के लिए एक ब्रीफिंग दस्तावेज़ की तरह समझें।

एक अच्छे CLAUDE.md में चार खंड होते हैं:

→ प्रोजेक्ट संदर्भ — एक पंक्ति। "Stripe और Postgres के साथ Next.js e-commerce ऐप।"

→ कोड शैली — "कोड को ठीक से फ़ॉर्मेट करें" नहीं बल्कि "ES modules, named exports, 2-space इंडेंट का उपयोग करें।"

→ कमांड — सटीक स्ट्रिंग्स। pnpm test:integration, "टेस्ट चलाएँ" नहीं।

→ आर्किटेक्चर — "API रूट्स /src/api/[resource]/route.ts में जाते हैं। DB एक्सेस के लिए रिपॉजिटरी पैटर्न।"

1# CLAUDE.md
2
3## Project Context
4Next.js 14 e-commerce app. Postgres + Stripe integration.
5
6## Code Style
7- ES modules only
8- Named exports, never default exports
9- 2-space indentation
10- TypeScript strict mode
11
12## Commands
13- Install: pnpm install
14- Dev: pnpm dev
15- Test: pnpm test:integration
16- Lint: pnpm lint:fix
17
18## Architecture
19- API routes: /src/api/[resource]/route.ts
20- DB access: repository pattern only
21- Components: /src/components, one file per component

लक्ष्य: 300 पंक्तियों से कम।

हर पंक्ति वास्तविक काम के साथ ध्यान के लिए प्रतिस्पर्धा करती है।

/init चलाएँ और Claude स्वचालित रूप से एक स्टार्टर फ़ाइल जनरेट करता है।

फिर इसका अधिकांश भाग हटा दें।

डिफ़ॉल्ट फ़ाइल में वे चीज़ें शामिल हैं जो Claude आपके package.json से पहले से जानता है। केवल वही रखें जो Claude फ़ाइल के बिना गलत करेगा।

[](https://x.com/@imports) @imports सिस्टम — इसे दुबला रखें

CLAUDE.md को सब कुछ रखने की ज़रूरत नहीं है।

यह अन्य फ़ाइलों को आयात कर सकता है:

प्रोजेक्ट अवलोकन के लिए

@README .md देखें API कन्वेंशन के लिए

@docs/api-patterns .md देखें उपलब्ध npm स्क्रिप्ट के लिए

@package .json देखें

आयात पुनरावर्ती (recursive) हो सकते हैं — 5 स्तरों तक गहरे।

यह "एक विशाल फ़ाइल" की समस्या को हल करता है।

टीमों के लिए: फ्रंटएंड टीम docs/frontend-rules.md की मालिक है।

सुरक्षा टीम docs/security.md की मालिक है।

CLAUDE.md बस उन सभी को आयात करता है।

एक रूट फ़ाइल। कई विशिष्ट स्रोत।

AGENTS.md — सार्वभौमिक मानक

CLAUDE.md केवल Claude के लिए काम करता है।

यदि आपकी टीम Cursor, Copilot, या Gemini CLI का भी उपयोग करती है — वे इसे कभी नहीं पढ़ते हैं।

AGENTS.md इसे ठीक करता है।

एक फ़ाइल। हर प्रमुख एजेंट इसे पढ़ता है।

Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Aider, Zed, Warp, और अधिक द्वारा समर्थित।

यह मानक markdown है। कोई विशेष स्कीमा नहीं। कोई YAML आवश्यक नहीं।

1# AGENTS.md
2
3## Project Overview
4E-commerce platform built with Next.js 14, Postgres, and Stripe.
5
6## Build & Test
7- Install: pnpm install
8- Dev: pnpm dev
9- Test: pnpm test
10- Lint: pnpm lint:fix
11
12## Code Standards
13- TypeScript strict mode
14- Named exports over default exports
15- API routes follow REST conventions in /src/api/
16
17## Testing Requirements
18- All PRs must include tests
19- vitest for unit tests, playwright for e2e

इसे AI एजेंटों के लिए एक README की तरह समझें।

README.md इंसानों के लिए है। AGENTS.md विक्रेता की परवाह किए बिना हर एजेंट के लिए है। CLAUDE.md शीर्ष पर Claude-विशिष्ट एक्स्ट्रा जोड़ता है।

वे पूरक हैं। प्रतिस्पर्धी नहीं।

ऑटो-मेमोरी — AI जो अपने खुद के नोट्स लेता है

यह सबसे नई और सबसे दिलचस्प परत है।

Claude Code अब आपके सत्रों के दौरान अपनी खुद की मेमोरी फ़ाइलें लिखता है।

memory/ ├── MEMORY.md ← इंडेक्स, हर सत्र में लोड होता है ├── debugging.md ← डिबगिंग पैटर्न पर नोट्स ├── api-conventions.md ← API डिज़ाइन निर्णय └── ...

मुख्य बदलाव:

आप CLAUDE.md लिखते हैं। आप निर्देश प्रदान करते हैं।

Claude MEMORY.md लिखता है। यह वही कैप्चर करता है जो उसने सीखा।

→ इंसान नियम लिखता है

→ एजेंट काम करते हुए पैटर्न खोजता है

→ एजेंट अपनी खुद की मेमोरी लिखता है

→ भविष्य के सत्र अधिक स्मार्ट शुरू होते हैं

आप इसे सीधे ट्रिगर कर सकते हैं। एक उत्पादक सत्र के अंत में, बस कहें:

"आज हमारे कोडबेस के बारे में आपने जो सीखा है, उसके साथ अपनी मेमोरी फ़ाइलों को अपडेट करें।"

सीख बनी रहती है। पाँचवीं बार अपने कस्टम ORM रैपर को फिर से समझाने की ज़रूरत नहीं है।

Claude ने जो सहेजा है उसकी समीक्षा या संपादन करने के लिए कभी भी /memory चलाएँ।

/init फिर डिलीट करें वर्कफ़्लो

नए प्रोजेक्ट पर मेमोरी फ़ाइल को बूटस्ट्रैप करने का सबसे तेज़ तरीका:

1. अपने प्रोजेक्ट डायरेक्टरी में /init चलाएँ
2. Claude आपके कोडबेस के आधार पर एक स्टार्टर CLAUDE.md जनरेट करता है
3. जिसकी ज़रूरत नहीं है उसे हटा दें

चरण 3 वह जगह है जहाँ ज़्यादातर लोग गलती करते हैं।

जनरेट की गई फ़ाइल एक ड्राफ्ट है, कोई तैयार उत्पाद नहीं।

इसमें अक्सर फिलर (filler) शामिल होता है। "यह प्रोजेक्ट JavaScript का उपयोग करता है।" धन्यवाद — package.json से दिखाई देता है।

एक उचित ड्राफ्ट को संपादित करना, एक खाली फ़ाइल से शुरू करने से बेहतर है।

सेटअप के बाद, स्वाभाविक रूप से निर्माण करें।

जब Claude कोई गलत धारणा बनाता है — मान लीजिए कि वह एक पुराने पैकेज को इम्पोर्ट करता रहता है — तो इसे केवल एक बार ठीक न करें।

उससे कहें: "मेरे CLAUDE.md में जोड़ें: हमेशा @company/utils के बजाय @company/utils-v2 से इम्पोर्ट करें।"

निर्देश हर भविष्य के सत्र के लिए बना रहता है।

हर कुछ हफ़्तों में, Claude से CLAUDE.md की समीक्षा और सफाई करने के लिए कहें।

निर्देश जमा होते जाते हैं। कुछ अनावश्यक हो जाते हैं। अन्य एक-दूसरे से टकराने लगते हैं। एक त्वरित पास इसे तेज रखता है।

मेरा वास्तविक सेटअप

इन सभी का कई प्रोडक्शन प्रोजेक्ट्स पर परीक्षण करने के बाद, यहाँ वह है जो टिक गया:

→ AGENTS.md प्रोजेक्ट रूट में — साझा निर्देश जो कोई भी AI टूल पढ़ता है। बिल्ड कमांड, कोड मानक, परीक्षण आवश्यकताएँ।

→ CLAUDE.md जिसमें Claude-विशिष्ट व्यवहार के लिए @imports है। 100 पंक्तियों से कम रहता है, ज़्यादातर docs/ फ़ाइलों की ओर इशारा करता है।

→ CLAUDE.local.md व्यक्तिगत विशिष्टताओं के लिए — मेरा टेस्ट डेटा, सैंडबॉक्स URL, शॉर्टकट कमांड। कभी git में प्रतिबद्ध नहीं किया जाता।

→ ऑटो-मेमोरी सक्षम। Claude अपने खुद के नोट्स लेता है। मैं मासिक समीक्षा करता हूँ।

→ बाकी सब कुछ AGENTS.md की ओर इशारा करते symlinks से बदल दिया गया। सत्य का एक स्रोत।

1# Symlink setup for multi-tool consistency
2ln -sfn AGENTS.md .github/copilot-instructions.md
3mkdir -p .cursor/rules && ln -sfn ../../AGENTS.md .cursor/rules/main.mdc

सुरुचिपूर्ण नहीं।

लेकिन यह टीम पर हर उपकरण में निर्देश बहाव (instruction drift) को मारता है।

बड़ा बदलाव

ज़्यादातर डेवलपर सोचते हैं:

बेहतर मॉडल = बेहतर एजेंट।

गलत।

असली फॉर्मूला:

मॉडल + मेमोरी + पुनर्प्राप्ति (Retrieval) + फीडबैक = उपयोगी एजेंट

एक स्मार्ट मॉडल जिसके पास मेमोरी नहीं है, वह कल आपके टेस्ट कमांड को भूल जाएगा।

एक सामान्य मॉडल जिसके पास अच्छी मेमोरी है, वह हर हफ्ते तेज होता जाता है।

मेमोरी संयोजित (compounding) होने वाला चर है।

मॉडल इंटेलिजेंस नहीं है।

मैंने अपने AI वर्कफ़्लो में जो सबसे बड़ा सुधार किया, वह मॉडल बदलना नहीं था।

यह मॉडल को एक मेमोरी देना था।

अंतर के बीच:

"Claude, हम pnpm का उपयोग करते हैं" — हर एक सत्र

और:

"Claude पहले से जानता है" — हर एक सत्र

एक उपकरण और एक टीम के साथी के बीच का अंतर है।

अगर यह उपयोगी था:

→ इसे हर उस डेवलपर के साथ साझा करने के लिए रिपोस्ट करें जो अभी भी Claude से खुद को दोहरा रहा है

→ उन प्रणालियों के लिए @sairahul1 को फॉलो करें जो आपके सोते समय संयोजित (compound) होती हैं

→ इसे बुकमार्क करें — आज रात इसे सेटअप करें, कल सुधार करना बंद करें

मैं AI, उत्पाद बनाने, और ऐसी प्रणालियों के बारे में लिखता हूँ जो आपके बिना काम करती हैं।