एक एजेंट के साथ काम करने के बारे में सबसे महंगी चीज संदर्भ को फिर से समझाना है। हर सुबह आप कल के निर्णयों को फिर से समझाते हैं, अंतिम कमिट संदेश पेस्ट करते हैं, यह फिर से स्थापित करते हैं कि कौन सा बग डिप्लॉय को ब्लॉक करता है। हर सत्र से गुणा करें और छिपी हुई लागत प्रति सप्ताह घंटों में होती है, मिनटों में नहीं।
STATE.md उस कर को खत्म कर देता है। एक फ़ाइल, हर सत्र के अंत में अपडेट की जाती है, अगले की शुरुआत में लोड की जाती है। अनुशासन: सत्र बंद करने से पहले, फ़ाइल को अपडेट करने में तीन मिनट बिताएं। कल, वे तीन मिनट बीस बचाते हैं।
STATE.md में तीन चीजें होती हैं, और कुछ नहीं।
निर्णय: आपने क्या तय किया और क्यों। क्यों के बिना, भविष्य-आप निर्णय को फिर से खोलते हैं। "दैनिक डाइजेस्ट के लिए क्रॉन के बजाय पोस्टग्रेस ट्रिगर: ट्रिगर ट्रांसेक्शनल होते हैं, क्रॉन राइट पाथ को रेस करता है।"
प्रगति में: क्या आधा-अधूरा है, सौंपने के लिए पर्याप्त विशिष्ट है। "माइग्रेशन 014 /migrations/014_add_subscription_columns.sql पर लिखा गया है लेकिन लागू नहीं किया गया है। वेबहुक हैंडलर के लाइव होने से पहले चलना चाहिए।"
बाधाएं: क्या आगे बढ़ने से रोकता है, जिसमें आपने क्या कोशिश की। "टेस्ट एनवायरनमेंट में स्ट्राइप वेबहुक हस्ताक्षर विफल हो रहा है। रॉ बॉडी पार्सर की कोशिश की, फिर भी 400। अगला: वर्सेल प्रीव्यू में env var की जांच करें।"
इसे 60-80 लाइनों तक सीमित रखें। जब कुछ हल हो जाए, तो उसे हटा दें। जब कुछ शिप हो जाए, तो उसे संग्रहीत करें।
अपडेट अनुशासन। खुद को याद दिलाने के लिए एक स्टॉप हुक जोड़ें:
{
"hooks": {
"Stop": [
{
"command": "echo 'Before you close: update STATE.md with decisions, in-flight, and blockers from this session.'"
}
]
}
}केवल याद दिलाना पर्याप्त नहीं है; आदत को स्वचालित होना चाहिए। सबसे तेज़ तरीका: इसे लगातार पांच सत्रों के लिए करें। छठे सत्र तक, आपको अपडेट किए बिना बंद करना गलत लगेगा। बेचैनी वह संकेत है कि आदत बन गई है।
MEMORY.md हर स्थायी चीज़ के लिए सूचकांक है। प्रत्येक प्रविष्टि एक अलग फ़ाइल की ओर इशारा करती हुई एक पंक्ति है। चार प्रकार:
user_*: आपके बारे में स्थायी तथ्य: समय क्षेत्र, करियर संदर्भ, प्राथमिकताएं। user_location.md
feedback_*: गलतियों से सीखे गए नियम, एक आत्मविश्वास फ़ील्ड के साथ। 0.3 से शुरू करें, जब पैटर्न दोहराया जाए तो 0.5 तक बढ़ाएं, 0.9+ पर CLAUDE.md में पदोन्नत करें। feedback_public_endpoints_need_rate_limits.md
project_*: एक परियोजना के लिए दिनांकित स्थिति और निर्णय। जब यह शिप हो जाए तो संग्रहीत करें। project_stripe_integration_2026_05.md
reference_*: लोगों, उपकरणों, API के लिए लुकअप टेबल। reference_neon_db_config.md
प्रत्येक सूचकांक पंक्ति को 200 वर्णों से कम और सूचकांक को 200 लाइनों से कम रखें। उससे आगे, प्रविष्टियाँ काट दी जाती हैं और Claude उन्हें नहीं देख सकता।
STATE.md अभी के लिए है। MEMORY.md हमेशा के लिए है। अंगूठे का नियम: यदि आप इसे स्टैंडअप में कहेंगे, तो यह STATE.md में जाता है। यदि आप इसे विकी या ऑनबोर्डिंग दस्तावेज़ में लिखेंगे, तो यह एक मेमोरी फ़ाइल में जाता है। स्टैंडअप क्षणभंगुर होते हैं; विकी स्थायी होते हैं।
जब कोई परियोजना शिप हो जाती है और STATE.md अभी भी इसके बारे में पांच लाइनें रखता है, तो उन लाइनों को एक दिनांकित project_* मेमोरी फ़ाइल में ले जाएं और उन्हें साफ़ करें। परियोजना ने मायने रखना बंद नहीं किया; यह वर्तमान होना बंद हो गया। यह अंतर STATE.md को उपयोगी रखता है।
स्थिति लिखें, जर्नल नहीं। एक जर्नल प्रविष्टि: "स्ट्राइप इंटीग्रेशन पर काम किया। यह मुश्किल था।" एक स्थिति प्रविष्टि: "वेबहुक एंडपॉइंट app/api/webhooks/stripe/route.ts पर। हस्ताक्षर सत्यापन स्थानीय रूप से काम करता है, वर्सेल प्रीव्यू में विफल रहता है (गलत रॉ बॉडी प्रारूप)। अगला: rawBody मिडलवेयर कॉन्फ़िगरेशन की जांच करें।" एक अगली सत्र को एक शुरुआती बिंदु देता है; दूसरा उसे एक संस्मरण देता है।
दो और एंटी-पैटर्न: एक ठोस अगली कार्रवाई के बिना प्रगति में प्रविष्टियाँ जो एक नया सत्र निष्पादित कर सकता है, और सत्रों में एक ही विषय के लिए डुप्लिकेट प्रविष्टियाँ। डुप्लिकेट मर्ज करें: एक विषय, एक प्रविष्टि, केवल वर्तमान स्थिति।
एक अच्छा सत्र अपडेट नौ से बारह लाइनें होता है: तर्क के साथ एक निर्णय, अगले चरण के साथ एक प्रगति में आइटम, आपने क्या कोशिश की उसके साथ एक अवरोधक।
50 मेमोरी फाइलों से आगे स्केलिंग: डाइजेस्ट लेयर। प्रत्येक MEMORY.md पॉइंटर लाइन की लागत लगभग 100-150 टोकन होती है। 200 लाइनों पर यह 20-30K टोकन शुद्ध पॉइंटर होते हैं। समाधान: STRATEGY-DIGEST.md, हर प्रमुख दस्तावेज़ का 2-3 वाक्य का सारांश और एक "कब उपयोग करें:" फ़ील्ड:
## q2-positioning.md
Q2 पोजिशनिंग मध्य-बाजार बिक्री संगठनों में AI सक्षमता को लक्षित करती है।
कब उपयोग करें: लक्षित ग्राहक, मूल्य निर्धारण, या लीड योग्यता पर चर्चा करते समय।Claude डाइजेस्ट (लगभग 3K टोकन) पढ़ता है और केवल प्रासंगिक होने पर एक पूर्ण दस्तावेज़ लोड करता है। 25 रणनीति दस्तावेज़ों पर, यह 50K के बजाय 3K टोकन है। "कब उपयोग करें:" फ़ील्ड रूटिंग तंत्र है: इसे एक विशिष्ट ट्रिगर स्थिति के रूप में लिखें, न कि फ़ाइल के विवरण के रूप में।
STATE.md वर्तमान स्थिति (निर्णय, प्रगति में, अवरोधक) को 80 पंक्तियों के भीतर कैप्चर करता है; सत्र के अंत में इसे अपडेट करें और इतिहास को तुरंत संग्रहीत करें। MEMORY.md चार प्रकारों (उपयोगकर्ता, प्रतिक्रिया, परियोजना, संदर्भ) में स्थायी ज्ञान को अनुक्रमित करता है, जिसकी सीमा 200 पंक्तियाँ है। आज रात तीन पंक्तियों से शुरू करें: एक निर्णय, एक प्रगति में आइटम, एक अवरोधक। आदत बनने तक शून्य से तीन पंक्तियाँ बेहतर हैं।