AGENTS.md: हर coding agent के लिए एक ही context file (Codex, Antigravity, Claude)

आपने एक पूरी दोपहर एक साफ-सुथरा CLAUDE.md लिखने में लगाई। आपका agent आखिरकार आपकी stack का अंदाज़ा लगाना बंद करके सही test command चलाने लगा। फिर एक teammate वही repo Codex में खोलता है, आप किसी side branch पर Antigravity CLI आज़माते हैं, और इतनी मेहनत से बना वह सारा context साथ नहीं आता। हर tool अपनी ही file चाहता है, अपनी ही जगह पर।

AGENTS.md इसी झंझट का जवाब है: एक सादा Markdown file, आपके repo की root पर, जिसे कोई भी coding agent आपके code को छूने से पहले पढ़ता है।

AGENTS.md असल में है क्या

कोई जादू नहीं है। यह AGENTS.md नाम की एक Markdown file है, आमतौर पर repository की root पर, जिसे agent काम शुरू करने से पहले स्थायी निर्देशों की तरह load करता है। इसे ऐसे समझिए जैसे वह README जो आप अपने इंसानी साथियों के बजाय अपने AI साथियों के लिए लिखते हैं: project है क्या, इसे build और test कैसे करना है, किन conventions का पालन करना है, और किन जालों से बचना है।

यह एक खुला convention है, जिसे Codex और agent tools की एक बढ़ती हुई सूची पहले से पढ़ती है, और जिसका साफ़ मकसद इनके बीच portable होना है। एक file, बहुत सारे agents, हर tool के लिए एक अलग बनी-बनाई file के बजाय।

AGENTS.md vs CLAUDE.md vs GEMINI.md

जब यह guide पहली बार लिखी गई थी, तब हर tool अपनी ही file ढूँढता था। तब से ज़्यादातर tools AGENTS.md पर आ गए हैं:

• Codex AGENTS.md पढ़ता है, और GitHub Copilot CLI, Cursor, Amp और ज़्यादातर नए agent CLIs भी इसे ही पढ़ते हैं।
• Claude Code CLAUDE.md पढ़ता है, और version 2.1.277 से वह अपने आप AGENTS.md भी पढ़ता है, जब आपकी working directory और उसके ऊपर की directories में न कोई CLAUDE.md हो, न CLAUDE.local.md। जब कोई CLAUDE.md मौजूद होता है, तो Claude सिर्फ़ वही file पढ़ता है, जब तक आप /config में Project instructions setting न बदलें।
• Antigravity CLI AGENTS.md या GEMINI.md पढ़ता है, repository की root पर या किसी भी subdirectory में, साथ ही एक .agents/rules/ folder और ~/.gemini/ के नीचे global rules भी।

तीनों में content लगभग एक जैसा होता है: project context, commands, conventions. जो फर्क अब भी बचा है, वह यह है कि कई files मौजूद होने पर कोई tool कौन-सी file चुनता है। ठीक इसी वजह से एक ही नियमों को हाथ से तीन files में copy करना एक हारी हुई लड़ाई है (इन्हें sync में रखने के बारे में आगे और बात होगी)। हमने 10 अक्टूबर 2026 को ये व्यवहार Claude Code के memory documentation और Antigravity के rules documentation से मिलाकर जाँचे।

अगर आप ज़्यादातर Claude Code में काम करते हैं, तो हमारी CLAUDE.md guide Claude-specific structure में गहराई से जाती है। AGENTS.md उसी file का provider-न्यूट्रल भाई है।

इसमें क्या डालें

इसे छोटा और high-signal रखें। agent इसे हर task पर पढ़ता है, इसलिए हर लाइन ध्यान खींचने के लिए होड़ करती है। ज़रूरी चीज़ें:

• stack, एक साँस में। "Next.js 16, TypeScript, Prisma, MariaDB." न इतिहास, न marketing.
• वही commands जो मायने रखती हैं। install, run, build, test और lint कैसे करें। सटीक commands: npm test, न कि "tests चलाओ।"
• Conventions। Naming, file layout, error handling, वे patterns जिन्हें आप review में सचमुच लागू करवाते हैं।
• एक directory map। दो लाइनों में कि चीज़ें कहाँ रहती हैं, ताकि agent अंधाधुंध grep करना बंद कर दे।
• "छूने से पहले पढ़ो" वाले नियम। "billing/ के नीचे कुछ भी edit करने से पहले docs/payments.md पढ़ो।" यह एक आदत ही बहुत सारे नुकसान से बचा लेती है।
• पक्के "ना" वाले नियम। "बिना कहे कभी branch मत बनाओ।" "Commit की गई files में machine के absolute paths नहीं।"

वे गलतियाँ जिनकी वजह से agents इसे नज़रअंदाज़ कर देते हैं

एक context file चुपचाप नाकाम होती है। agent कोई error नहीं फेंकता, बस भटक जाता है। आम वजहें:

1. बहुत लंबी। 600 लाइनों की file उन पाँच नियमों को दबा देती है जो असल में मायने रखते हैं। जो कुछ agent code से ही समझ सकता है, उसे काट दें।
2. अंतर्विरोध। एक section में "हमेशा tests लिखो," दूसरे में "prototypes के लिए tests छोड़ दो।" agent किसी एक को रैंडम चुन लेता है।
3. Machine से बँधे paths। Commit की गई file में /Users/you/project/... हर teammate के लिए, और हर दूसरी machine पर हर agent के लिए टूट जाता है। paths relative रखें।
4. पुरानी पड़ चुकी commands। test command छह महीने पहले बदल गई, file नहीं बदली। अब agent पूरे आत्मविश्वास से गलत चीज़ चला देता है।
5. कोई प्राथमिकता नहीं। सब कुछ "ज़रूरी" है, तो कुछ भी ज़रूरी नहीं रहता। non-negotiables को सबसे ऊपर रखें और उन्हें लेबल करें।
6. Documentation उड़ेल देना। ये instructions हैं, wiki नहीं। अपनी docs के लिंक दें, उन्हें इसमें चिपकाएँ नहीं।

providers के बीच एक ही context बनाए रखना

यहाँ वह व्यावहारिक हिस्सा है जिसे ज़्यादातर guides छोड़ देती हैं। अगर आप, या आपकी टीम, एक से ज़्यादा agent CLI चलाते हैं, तो आप एक ही नियमों की तीन भटकती हुई copies नहीं चाहेंगे।

दो साफ-सुथरे तरीके:

• एक ही AGENTS.md, और कुछ नहीं। अगर किसी को ऐसे नियमों की ज़रूरत नहीं है जो सिर्फ़ Claude पर लागू हों, तो एक ही AGENTS.md रखें: Codex, Antigravity CLI और Claude Code 2.1.277 या उसके बाद का version, सभी इसे पढ़ते हैं। पेच चुपचाप वाला है: बाद में जोड़ा गया एक CLAUDE.md, या एक निजी CLAUDE.local.md, Claude Code से AGENTS.md पढ़ना बंद करवा देता है।
• एक canonical file, एक import। सब कुछ AGENTS.md में रखें और CLAUDE.md की शुरुआत @AGENTS.md लाइन से करें, फिर उसके नीचे सिर्फ़ Claude वाले नियम लिखें। Claude पहले imported file पढ़ता है। हमारी अपनी repository इसी तरह काम करती है: उसका CLAUDE.md बस यही एक लाइन है। एक symlink (ln -s AGENTS.md CLAUDE.md) भी काम करता है, पर Windows पर ठीक से नहीं, जहाँ इसे बनाने के लिए व्यवस्थापक अधिकार या डेवलपर मोड चाहिए, और core.symlinks के बिना किया गया clone आपके निर्देशों की जगह एक लाइन की text file पाता है।

दोनों ही हालत में नियम एक ही है: context एक बार लिखें, हर provider के लिए एक बार नहीं। यही एकमात्र तरीका भी है जिससे यह सही बना रहता है, क्योंकि एक ही file ही वह अकेली file होती है जिसे लोग सचमुच maintain करते हैं।

जब आप एक साथ कई agents चलाते हैं

repo-level का AGENTS.md इस सवाल का जवाब देता है कि "यह project क्या है।" यह इस सवाल का जवाब नहीं देता कि "यह agent कौन है।" जब आप एक ही code पर एक Backend agent, एक Frontend agent और एक QA agent समानांतर में चलाते हैं, तो हर एक को साझा project context के साथ-साथ अपनी खुद की role भी चाहिए।

यही वह परत है जो AgentsRoom आपके AGENTS.md के ऊपर जोड़ता है। हर agent को एक समर्पित role मिलती है अपने ही system prompt के साथ (DevOps, Frontend, Security और बाकी), ताकि साझा file हल्की बनी रहे जबकि हर agent को फिर भी अपना काम पता रहे। यह डिज़ाइन से ही provider-agnostic है, इसलिए वही setup Claude, Codex या Antigravity को साथ-साथ चलाता है, और आपके दोहराए जाने वाले निर्देश हर session में दोबारा टाइप होने के बजाय एक Prompt Library में रहते हैं।

जब आप उस मुकाम पर पहुँचते हैं, तो कई agents को समानांतर में चलाते हुए नज़र न खोने का तरीका अगली स्वाभाविक पढ़ाई है।

निचोड़

एक ही AGENTS.md लिखें। इसे छोटा रखें, अद्यतन रखें, portable रखें। हर tool को इसी की ओर point करें, बजाय हर agent के लिए एक अलग file maintain करने के। आपका context उस CLI से बँधा रहना बंद कर देता है जिससे आपने संयोग से शुरुआत की थी, और आपके agents, चाहे आप कोई भी चलाएँ, सब एक ही पन्ने से शुरू करते हैं।

चाहते हैं कि हर agent एक ही स्क्रीन पर हो, हर एक अपनी role और आपके साझा context के साथ? AgentsRoom डाउनलोड करें, अपना provider connect करें, और अपने बेड़े को काम पर लगा दें।

अक्सर पूछे जाने वाले सवाल

AGENTS.md क्या है?

एक Markdown file, आमतौर पर repository की root पर, जिसे coding agents काम शुरू करने से पहले स्थायी निर्देशों की तरह load करते हैं: project है क्या, इसे build और test कैसे करना है, किन conventions का पालन करना है और किन जालों से बचना है। यह किसी एक tool की file नहीं, बल्कि tools के बीच साझा एक खुला convention है, जिसे Codex, Antigravity CLI, GitHub Copilot CLI, Cursor, Amp और, version 2.1.277 से, Claude Code पढ़ते हैं।

क्या Claude Code AGENTS.md पढ़ता है?

हाँ, Claude Code 2.1.277 से, लेकिन सिर्फ़ तब जब आपकी working directory में या उसके ऊपर कोई CLAUDE.md, .claude/CLAUDE.md या CLAUDE.local.md न हो। तब यह working directory से ऊपर की ओर हर AGENTS.md load करता है, और किसी subdirectory का AGENTS.md तब, जब वह वहाँ कोई file खोलता है। अगर कोई CLAUDE.md मौजूद है, तो Claude सिर्फ़ वही file पढ़ता है, जब तक आप /config में Project instructions को claude-md-and-agents-md पर सेट न करें। पुराने versions पर, किसी CLAUDE.md के सबसे ऊपर @AGENTS.md लाइन डाल दें।

Antigravity AGENTS.md इस्तेमाल करता है या GEMINI.md?

दोनों। Antigravity repository की root पर या किसी भी subdirectory में एक AGENTS.md, एक GEMINI.md या एक .agents/rules/ folder पढ़ता है, और ~/.gemini/ से global rules भी। नियम एक-दूसरे की जगह लेने के बजाय जुड़ते जाते हैं, और जब दो नियम आपस में टकराते हैं, तो ज़्यादा specific directory का नियम लागू होता है।

AGENTS.md रखूँ या CLAUDE.md?

AGENTS.md को वह अकेली file बनाएँ जिसे आप maintain करते हैं। अगर आपको कुछ ऐसे नियम भी चाहिए जो सिर्फ़ Claude के लिए हों, तो एक CLAUDE.md जोड़ें जिसकी पहली लाइन @AGENTS.md हो और उन नियमों को उसके नीचे लिखें: Claude पहले imported file पढ़ता है। अगर ऐसे नियमों की ज़रूरत नहीं है, तो Claude Code 2.1.277 या उसके बाद के version के लिए अकेला AGENTS.md काफ़ी है। एक ही नियमों की दो पूरी copies से बचें: जिसे कोई edit नहीं करता, वह पुरानी पड़ जाती है।

AGENTS.md कहाँ रखें?

repository की root पर, उन नियमों के लिए जो हर जगह लागू होते हैं। Claude Code और Antigravity subdirectories की AGENTS.md files भी पढ़ते हैं, इसलिए अपनी commands वाला कोई package या service अपनी खुद की file रख सकता है, जो तब पढ़ी जाती है जब agent उस folder में काम करता है।