Claude Code, Codex va Cursor uchun 2026-yildagi yagona ko‘rsatmalar fayli

Xizmat haqida ma’lumot olish uchun Ailoot hujjatlariga qarang.

Claude Code, Codex va Cursordan birgalikda foydalansangiz, nima o‘zgaradi?#

Ta’riflangan misolda Claude Code asosiy vosita, Codex va Cursor esa muayyan vazifalar uchun ishlatiladi. Mening CLAUDE.md faylimda taxminan 250 qator ko‘rsatma bor: nimani va qaysi tartibda o‘qish, nimaga tegmaslik, deploy uchun qaysi buyruqlardan foydalanish va commitlarni qanday formatlash. Loyihada Codex CLI’ni ilk bor sinab ko‘rganimda, u qoidalarni bilmasdi: git push --forceni ishga tushirdi, .envni kavladi va fayllar nomini beparvolik bilan o‘zgartirdi.

Avval CLAUDE.md faylini qo‘lda AGENTS.md fayliga nusxaladim. Ikki haftadan keyin loyihada bir xil ko‘rsatmaning to‘rtta nusxasi borligini bildim: CLAUDE.md, AGENTS.md, .cursorrules va .windsurf/rules/ ichida. Ularning barchasi biroz farq qilardi. Bu Claude yoki Cursor muammosi emas; bir nechta haqiqat manbaiga ega har qanday tizimdagi asosiy tuzoq shu. Bu muammoni ko‘p agentli ish bo‘yicha qo‘llanmada batafsilroq muhokama qilaman.

2026-yil iyunida Anthropic’ning Claude Code xotirasi haqidagi hujjatlari bitta yechimni taklif qildi: umumiy fayl va import. 2026-yil sentabridan boshlab, loyihada CLAUDE.md bo‘lmasa, Claude Code AGENTS.mdni o‘zi o‘qiydi; Claude’ga xos qoidalaringiz bo‘lsa, import kerak. Quyida bitta AGENTS.md qachon yetarli bo‘lishi, importni qanday sozlash va umumiy qoidalarni Claude’ga xos qoidalardan qanday ajratishni tushuntiraman.

Claude Code AGENTS.md faylini o‘zi o‘qiydimi?#

2026-yil sentabrgacha javob “yo‘q” edi. AGENTS.md’ni qo‘llab-quvvatlashni so‘ragan #6235-muammo 2025-yil avgustidan beri ochiq turgan va 2026-yil 17-avgustda yopilgan. Xotira hujjatlari shu vaqt davomida bitta yechimni ko‘rsatgan: CLAUDE.md yarating va unga AGENTS.mdni import sifatida kiriting. 2.1.277-versiyasidan boshlab hujjatlarda boshqacha deyiladi:

Claude Code aynan nimani o‘qishi loyihadagi fayllarga bog‘liq:

Bu tekshiruvda ishchi katalogdagi va uning yuqorisidagi CLAUDE.md, .claude/CLAUDE.md hamda CLAUDE.local.md hisobga olinadi. Shaxsiy ~/.claude/CLAUDE.md, korporativ boshqariladigan fayl va .claude/rules/ ichidagi qoidalar hisobga olinmaydi: ular AGENTS.md bilan birga yuklanadi.

CLAUDE.md bo‘lmasa, Claude Code ishga tushganda ishchi katalog va uning yuqorisidagi barcha AGENTS.md hamda .claude/AGENTS.md fayllarini o‘qiydi; quyi katalogdagi AGENTS.mdni esa shu katalogdagi faylni ochganda aniqlaydi. AGENTS.md ichidagi @path importlari ham ishlaydi. Claude Code AGENTS.local.md, AGENTS.override.md yoki .agents/ katalogi tarkibini o‘qimaydi.

Nozik jihati: shaxsiy CLAUDE.local.md ham hisobga olinadi. Unga saqlanmagan qoidalaringizni yozing, shunda Claude Code AGENTS.mdni jimgina o‘qimay qo‘yadi. Quyidagi sozlama bu muammoni hal qiladi.

Xatti-harakat /configdagi Project instructions bo‘limida o‘zgaradi:

CLAUDE.local.mdni saqlab, AGENTS.mdni ham o‘qitmoqchi bo‘lsangiz, claude-md-and-agents-mdni belgilang. Fayllar takroran o‘qilmaydi: AGENTS.md @AGENTS.md satri yoki ramziy havola orqali allaqachon kiritilgan bo‘lsa, Claude Code sozlamadan qat’i nazar, uni ikkinchi marta yuklamaydi.

Fayl olingan-olinmaganini /memory buyrug‘i bilan tekshirishingiz mumkin: 2.1.280-versiyasidan boshlab ro‘yxatda AGENTS.md yo‘li ko‘rinadi. 2.1.277 dan oldingi versiyalarda va o‘rnatilgan agents-md plagini o‘chirilgan seanslarda Claude Code faqat CLAUDE.mdni o‘qiydi, /configda esa Project instructions bandi bo‘lmaydi. 2.1.281 dan oldingi versiyalarda Amazon Bedrock orqali ishlaydigan seanslar va telemetriyasi o‘chirilgan seanslar ham xuddi shunday ishlagan. Eski versiyadan yangilangandan keyingi ilk seansda AGENTS.md ham aniqlanmasligi mumkin; keyingi seansdan boshlab ishlaydi.

Bitta faylli sozlama uchun bu nimani anglatadi? Agar Claude’ga xos qoidalaringiz bo‘lmasa, CLAUDE.mdni ishlatmasangiz ham bo‘ladi: AGENTS.mdning o‘zi yetarli, Claude Code, Codex va Cursor uni o‘qiydi. Agar bunday qoidalaringiz bo‘lsa (xavfli kataloglar uchun plan mode, skills, hooks), CLAUDE.md kerak bo‘ladi va Claude Code AGENTS.mdni o‘zi o‘qimay qo‘yadi. Bunday holda CLAUDE.md ichiga @AGENTS.md satri bilan AGENTS.mdni kiriting; bu usul sentabrgacha qanday ishlagan bo‘lsa, shunday ishlaydi. Eski Claude Code versiyalarida ham qo‘l keladi. Buni quyida batafsil tushuntiraman.

@AGENTS.md faylini CLAUDE.md ichiga qanday import qilish mumkin?#

Rasmiy hujjatlardagi minimal ishlaydigan misol:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Nima sodir bo‘ladi? Birinchi satr, @AGENTS.md, import direktivasi. Claude Code seans boshida CLAUDE.mdni tahlil qilganda bu importni topib, uning o‘rniga AGENTS.mdning butun tarkibini joylashtiradi. Keyin ## Claude Code sarlavhasi keladi: u oddiy markdown, lekin “Claude’ga xos qo‘shimchalar” bo‘limi vazifasini bajaradi. Undagi qoida faqat Claude Code uchun: billing katalogidagi o‘zgarishlarda plan mode’dan foydalanish. Codex CLI yoki Cursor bu faylni ochmaydi; ular oddiy AGENTS.mddan foydalanadi.

Importlar qanday ishlashi haqidagi hujjatlardan iqtibos:

Amaliy jihatdan bir nechta tafsilot:

• Nisbiy va mutlaq yo‘llar. @AGENTS.md importni o‘z ichiga olgan faylga nisbatan olinadi. @/Users/me/shared/rules.md yoki @~/.claude/personal.md mutlaq yo‘llardir. Men repoga kiritishni istamagan shaxsiy afzalliklarim uchun @~/.claude/personal.mddan foydalanaman.
• To‘rt bosqichli chuqurlik. AGENTS.md @docs/coding-style.mdni import qilishi, coding-style.md esa yana boshqa faylni import qilishi mumkin; jami to‘rt bosqichgacha. Bu har qanday haqiqiy tuzilma uchun yetarli.
• Backtick ichida import ishlamaydi. Matnda `@README` deb yozilsa, bu import emas, nom tilga olinadi xolos. Bu importlar qanday ishlashini o‘quvchilarga tushuntirganda foydali.
• Loyiha tashqarisidagi fayllar uchun ruxsat. Import ishchi katalogdan tashqaridagi faylga, masalan @~/.claude/personal.mdga ishora qilsa, Claude Code birinchi marta shu fayllarni ko‘rsatuvchi dialog chiqaradi. Rad etsangiz, tashqi importlar o‘chiriladi va dialog boshqa ko‘rsatilmaydi. Loyiha ildizidagi @AGENTS.md dialog chiqarmaydi. Bu aloqasi bo‘lmagan faylni tasodifan kontekstga yuklashdan himoya qiladi.

Ta’riflangan loyihada shu sozlamaga o‘tganimdan so‘ng, CLAUDE.md 250 qatordan 60 qatorga qisqardi: @AGENTS.md va faqat Claude Code’ga tegishli besh-yetti qoida (xavfli kataloglar uchun plan mode, admin hududida nimaga tegmaslik va commitlarni qanday ifodalash). Umumiy qoidalarning barchasi Codex va Cursor o‘qiydigan AGENTS.mdda turadi.

Qachon ramziy havolani, qachon importni tanlash kerak?#

Hujjatlarda ramziy havola varianti quyidagicha ko‘rsatilgan:

ln -s AGENTS.md CLAUDE.md

Undan so‘ng Windows haqida ochiq ogohlantirish beriladi:

Taqqoslash jadvali:

Ta’riflangan loyihada importlardan foydalanaman. Sabablari:

1. Jamoa aralash. Men Mac’dan foydalanaman; misoldagi jamoa Windows va Mac foydalanuvchilariga taxminan teng bo‘lingan. Repoda ramziy havola bo‘lsa, Developer Mode’siz Windows foydalanuvchilarida u bitta AGENTS.md satridan iborat oddiy matn fayli sifatida olinadi. Bu g‘alati xatolarga olib keladi: ba’zan qoidalar ishlaydi, ba’zan yo‘q, sababi esa tushunarsiz.
2. Claude’ga xos qoidalar kerak. @AGENTS.mddan keyin CLAUDE.md faylimda “Claude Code” bo‘limi bor: arxitektura vazifalarida --effort highdan foydalanish, git pushdan oldin npm run buildni ishga tushirish va /api/v1/deployni qo‘lda chaqirmaslik. Codex bu buyruqlarni tushunmaydi.
3. Nosozlikni aniqlash osonroq. Nimadir noto‘g‘ri bo‘lsa, CLAUDE.mdni ochib import va o‘zim kiritgan o‘zgartirishlarni ko‘raman. Ramziy havolada “bu yerda qo‘shilgan” degan belgi yo‘q. Claude Code sozlamalaridagi nosozliklarni aniqlash haqida xavfsiz rejim qo‘llanmasidan o‘qing.

Agar Claude’ga xos qoidalaringiz bo‘lmasa, 2.1.277-versiyasidan boshlab ramziy havola kerak emas: CLAUDE.mdni o‘chiring, Claude Code AGENTS.mdni o‘zi o‘qiydi. Jamoada kimdir 2.1.277 dan eski versiyadan foydalanib, yangilana olmasa, ramziy havolani saqlang. Claude’ga xos qoidalaringiz bo‘lsa, o‘nta holatdan to‘qqiztasida import qulayroq.

Codex, Cursor, Copilot, Windsurf va Gemini CLI nimalarni o‘qiydi?#

Yettita asosiy vosita xaritasi (har bir vositaning rasmiy hujjatlari asosida):

Bundan qanday xulosa chiqadi? Repozitoriyda AGENTS.md bo‘lsa (Claude’ga xos qoidalar kerak bo‘lganda importli CLAUDE.md bilan birga), yettita vositaning beshtasi yangilangan ko‘rsatmalarni avtomatik oladi. O‘z fayllari mavjud Cursor va Windsurf’ni hozirgidek qoldirish mumkin (AGENTS.mdni ular ham o‘qiydi), yoki ularga @AGENTS.md importini qo‘shish mumkin, ammo sintaksislari farq qiladi va har doim ham qo‘llab-quvvatlanmaydi.

Yangi loyiha uchun eng sodda strategiya:

1. Barcha umumiy qoidalarni AGENTS.mdga joylashtiring — qoidalarning 95 foizi shu yerda bo‘ladi.
2. Faqat Claude uchun qoidalar kerak bo‘lsa, CLAUDE.md yarating: birinchi satrga @AGENTS.md yozing, keyin Claude’ga xos qoidalar bo‘limini qo‘shing. Bunday qoidalar bo‘lmasa, CLAUDE.md kerak emas; Claude Code 2.1.277-versiyasidan beri AGENTS.mdni o‘zi o‘qiydi.
3. Cursor’ga xos kamdan-kam qoidalar uchun .cursor/rules/ni saqlang (@Codebase va @Docs buyruqlari).
4. Windsurf’da ham shunday qiling: eski .windsurfrulesni unuting; uning sintaksisi uchun andozalar kerak bo‘lgandagina yangi .windsurf/rules/dan foydalaning.

Bu yondashuv 20% mehnat bilan foydaning 80%ini beradi. “Antigravity”dagi aralash jamoalarni tartibga solayotganimda, ikkitadan ortiq haqiqat manbaini (umumiy va faqat Claude uchun) yuritish qiyinlashishini tajribamda ko‘rdim. Jamoada kimdir .cursorrulesga qoida qo‘shib, AGENTS.mdni unutsa, bir haftadan keyin Cursor va Codex bir-biriga zid javob beradi.

Claude Code’dagi /init mavjud AGENTS.md faylini qanday oladi?#

Anthropic hujjatlarida /init quyidagicha ta’riflangan:

Amalda bu nimani anglatadi? Men ta’riflagan repoda Cursor’ni sinab ko‘rgan paytimdan qolgan .cursorrules (taxminan 80 qator) va qo‘lda tuzilgan AGENTS.md (120 qator) bor edi. claude /initni ishga tushirganimda, buyruq ikkala faylni olib, o‘xshash qoidalarni birlashtirdi va bir daqiqada tartibli CLAUDE.md tuzdi. Keyin uni tekshirib, ozgina tahrir qildim: eskirgan bandlarni olib tashlab, sarlavhali tuzilma qo‘shdim. Bu noldan qayta yozishdan tezroq bo‘ldi.

/init AGENTS.mdni ham o‘qiydigan interaktiv rejimni yoqish uchun muhit o‘zgaruvchisidan foydalaniladi:

CLAUDE_CODE_NEW_INIT=1 claude

/init ishga tushgach, Claude bir qator aniqlashtiruvchi savollar beradi: qaysi artefaktlarni sozlash (CLAUDE.md, skills, hooks), loyihada qaysi texnologiyalar to‘plami bor va testlar uchun qaysi buyruqlardan foydalanish. Keyin subagent kod bazasini package.json, README.md va konfiguratsiya fayllarini o‘qib o‘rganadi hamda yetishmayotgan qismlarni to‘ldiradi. Yakunda saqlashdan oldin tahrirlashingiz mumkin bo‘lgan taklifni ko‘rsatadi. Loyiha boshida Claude Code’ni sozlash haqida alohida qo‘llanmaga qarang.

Endi kamchiligi haqida. Loyihada faol AGENTS.md bo‘lsa, /init uning yonida qoidalaridan nusxa olingan CLAUDE.md yaratadi. Shundan boshlab Claude Code sukut bo‘yicha faqat CLAUDE.mdni o‘qiydi, demak yana ikkita haqiqat manbai paydo bo‘ladi: siz AGENTS.mdni yangilaysiz, Claude esa eski nusxadan foydalanishda davom etadi. /import buyrug‘i ham shunga o‘xshash ish qiladi: AGENTS.mdning bir martalik nusxasini CLAUDE.md oxiriga qo‘shadi. Bitta manbani saqlash uchun /initdan keyin CLAUDE.mdning birinchi satriga @AGENTS.md importini qo‘ying va AGENTS.mddagi qoidalarni takrorlaydigan hamma narsani CLAUDE.mddan olib tashlang.

/init yangi loyiha yoki Cursor yoxud Copilot’dan ko‘chirayotgan loyiha uchun to‘g‘ri boshlang‘ich nuqta. Internetdan “eng yaxshi CLAUDE.md andozasi”ni qidirish shart emas — Anthropic repodagi mavjud ma’lumotlarni allaqachon hisobga oladi. Loyihada faol AGENTS.md bo‘lsa va Claude’ga xos qoidalar bo‘lmasa, /init kerak emas: Claude Code AGENTS.mdni o‘zi o‘qiydi.

Umumiy va Claude’ga xos ko‘rsatmalarni qanday ajratish kerak?#

Men ularni shu tamoyil asosida ajrataman. AGENTS.mdga kiritiladigan umumiy qoidalar:

• Kodda nimaga tegmaslik. .env, node_modules, prisma/migrations kataloglari (faqat prisma migrate orqali), .next/, .git/.
• Narsalarni nomlash. Branch’lar: feat/, fix/, chore/. Commitlar: qisqa tavsif bilan feat:, fix:, docs: prefikslari. Komponent fayllari kebab-case formatida.
• Test/lint buyruqlari. npm run build, npm run lint, npm test. git pushdan oldin ishga tushiriladigan buyruq.
• Arxitektura tamoyillari. src/lib/ va src/components/ ichiga nimalar kirishi, biznes mantiqi qayerda bo‘lishi va interfeys qayerda joylashishi.
• Xavfsizlik. Maxfiy ma’lumotlarni hech qachon commit qilmang. Ishlab turgan ma’lumotlar bazasiga faqat prod-psql orqali kiring. Ishlab turgan tizimga SSH orqali faqat prod taxallusi bilan kiring, root@IP bilan emas.

Claude’ga xos, CLAUDE.mdga (@AGENTS.mddan keyin) kiritiladigan qoidalar:

• Plan mode. Xavfli kataloglardagi o‘zgarishlar uchun (masalan, src/billing/) plan modedan foydalaning.
• Sa’y-harakat darajasi. Arxitektura vazifalarida --effort high, odatiy ishda esa mediumdan foydalaning.
• Skills. Turli vaziyatlarda qaysi AI agentlar va ko‘nikmalarni ishga tushirish. Masalan: “qo‘llanma ustida ishlaganda build-masterskaya-guide skill’ini ishga tushiring.”
• Claude xotirasi. Avtomatik xotiraga va CLAUDE.local.mdga nimalarni yozish. Claude xotirasi haqida batafsil ma’lumot uchun Memory va CLAUDE.md bo‘yicha qo‘llanmaga qarang.
• Hooks. Agar .claude/settings.jsonda hooks sozlangan bo‘lsa, CLAUDE.mdda ularning nima qilishini tushuntiring (Codex va Cursor ular haqida bilmaydi va bilishi shart ham emas).
• Skills va buyruqlar. Men tez-tez ishlatadigan slash-buyruqlar ro‘yxati (/init, /cd, /memory, /plan).

Chegara doim ham aniq emas. Masalan, “mainga git push --forceni hech qachon ishga tushirmang” — aniq umumiy qoida, shuning uchun AGENTS.mdga yoziladi. Ammo “issiq branch’ga git push qilganda avval plan mode’dan foydalaning” qoidasi Claude Code’ga xos, shu bois CLAUDE.mdga tegishli. Sinov savoli: “Ertaga Claude Code’ni olib tashlab, faqat Codexni qoldirsam, bu qoida baribir amal qiladimi?” Ha bo‘lsa, AGENTS.mdga yozing. Yo‘q bo‘lsa, CLAUDE.mdga yozing.

AGENTS.md ichiga, CLAUDE.md yoki .claude/rules ichiga nimalar kiradi?#

Qoidalar 200 qatordan oshsa, ularni bo‘lish vaqti keldi. Anthropic hujjatlari har bir faylni 200 qator atrofida saqlashni tavsiya qiladi, chunki uzun CLAUDE.md fayllarida Claude qoidalarga tobora kamroq amal qila boshlaydi: ularni o‘qiyotgandek ko‘rinadi, ammo kamroq bajaradi.

Katta loyiha uchun men foydalanadigan tuzilma:

my-project/
├── AGENTS.md                    # 100-150 lines, shared
├── CLAUDE.md                    # 30-50 lines: @AGENTS.md + Claude-only
└── .claude/
    ├── CLAUDE.md                # alternative to root file, same file
    └── rules/
        ├── api.md               # with paths: ['src/api/**']
        ├── components.md        # with paths: ['src/components/**']
        ├── testing.md           # without paths, always active
        └── security.md          # without paths, always active

.claude/rules/ ichidagi har bir faylda frontmatter bo‘lishi mumkin:

---
paths:
  - "src/api/**/*.ts"
---

# API rules
- Every endpoint validates input with zod
- Errors use the standard `{error, code}` format
- OpenAPI comments are required

Claude bu qoidalarni faqat shu namunaga mos fayllar bilan ishlaganda yuklaydi. Agar src/components/Button.tsxni o‘zgartirsa, API qoidalari kontekstga qo‘shilmaydi. Shu tariqa kontekst oynasi faqat kerakli ma’lumotlarga sarflanadi. Loyiha faqat AGENTS.mdni o‘z ichiga olsa ham .claude/rules/ katalogi ishlaydi: qoidalar uning yonida yuklanadi va AGENTS.mdni bevosita o‘qishni o‘chirmaydi.

Cursor va Windsurf ham .cursor/rules/ va .windsurf/rules/ kataloglari orqali shu yondashuvni qo‘llaydi. AGENTS.md standarti bu kataloglarga havola qilishi mumkin, ammo vositalararo sintaksis hali to‘liq barqaror emas. Umumiy qoidalarni AGENTS.mdda saqlab, yo‘lga bog‘langan qoidalarni .claude/rules/ va .cursor/rules/ ichida takrorlash xavfsizroq — bular asosiy qoidalar emas, kamdan-kam maxsus holatlardir.

CLAUDE.md uchun foydali joylashuvlar (eng keng qamrovlidan eng toriga qarab):

Masalan, ~/.claude/CLAUDE.mdda ikkita qoida bo‘lishi mumkin: “foydalanuvchi afzal ko‘rgan tilda javob bering” va “Ailoot’ni aynan shu tarzda yozing.” Bu qoidalar har bir loyihaga taalluqli, shuning uchun ularni har bir repoda takrorlash shart emas.

Bu to‘rt darajadan faqat loyiha darajasidagi CLAUDE.md va CLAUDE.local.md AGENTS.mdni bevosita o‘qishni o‘chiradi. Shaxsiy ~/.claude/CLAUDE.md va boshqariladigan siyosat xalaqit qilmaydi; Claude Code ularni AGENTS.md bilan birga o‘qiydi.

Loyihangizdagi AGENTS.md eskirib qolgan bo‘lsa, nima qilish kerak?#

Ta’riflangan loyihada menda 2025-yil mayidan qolgan AGENTS.md bor edi — 180 qator, ko‘pi eskirgan (o‘zgargan Anthropic API endpointlari haqida yozilgan; endi mavjud bo‘lmagan claude --tools sintaksisidagi misollar; eskirgan tuzilishga ega ~/.claude/projects/ haqidagi qoidalar).

Uni yangilashda foydalangan rejam:

1. claude bilan plan mode’da ko‘rib chiqing. Repoda claude --safe-modeni ishga tushiraman va shunday so‘rayman: “AGENTS.mdni qayta o‘qib, eskirgan yoki takrorlangan bandlar ro‘yxatini taklif qil. Tahrir qilma; faqat ro‘yxatni ber.” Ikki daqiqada ko‘rib chiqish uchun 23 banddan iborat ro‘yxat oldim.
2. Ochiq-oydin eskirgan bandlarni olib tashlang. 23 banddan 9 tasi aniq eskirgan — buyruq sintaksisi, endpointlar va flag nomlari. U satrlarni o‘chirdim.
3. Takrorlarni birlashtiring. Yana 6 band turli so‘zlar bilan bir narsani takrorlagan (“majburan yuborma”, “--forceni hech qachon ishlatma”, “git push -fdan qoch”). Ularni bitta satrga birlashtirdim.
4. Yangi bandlar qo‘shing. O‘tgan oy davomida Claude/Codex muntazam xato qilayotganini kuzatgan holatlarimni “har bir xato namunasi uchun bitta satr” qoidasiga rioya qilib qo‘shdim. Natijada 8 ta yangi band chiqdi.
5. Yakuniy ko‘rib chiqish uchun subagent ishga tushiring. “Qarama-qarshiliklar, noaniqliklar va takrorlarni top” degan ko‘rsatma bilan Claude’dan tekshiruv so‘radim. U aniqroq yozish mumkin bo‘lgan uchta jumlani topdi. Ularni tuzatdim.

Bir soatdan keyin AGENTS.md 110 qator bo‘ldi, yangilandi va har bir satrini o‘zim bilardim. Undan 30 qatorli CLAUDE.md tuzish oson bo‘ldi. Shundan keyin Codex testlarga sezilarli darajada e’tiborliroq bo‘ldi — menimcha, uning “g‘alati” qarorlarining ayrimlari u halol ravishda amal qilib kelgan eskirgan ko‘rsatmalardan kelib chiqqan.

Doimiy yangilanib turadigan AGENTS.mdning asosiy tamoyillari:

• Har bir qoida takrorlanadigan xatoga javob beradi. Oy davomida biror qoida xayolimga kelmagan bo‘lsa, uni saqlab qolishdan foyda yo‘q.
• Nazariya emas, buyruq tarzida yozing. “Ikki bo‘sh joydan foydalaning” — qoida. “Kod uslubi chiroyli bo‘lsin” — qoida emas.
• Aniqlik umumiy gaplardan ustun. “git pushdan oldin npm run buildni ishga tushiring” — qoida. “O‘zgarishlarni sinang” — qoida emas.

Bu sozlamada nimalar mutlaqo ISHLAMAYDI?#

Bu sozlama bilan olti oy ishlash davomida qiyinchilik bilan o‘rgangan bir nechta narsam:

1. Cursor’ning avto-to‘ldirishi AGENTS.md’dan foydalanmaydi. Cursor tahrirlagichda satrni tugallashni taklif qilganda, AGENTS.mdni real vaqtda o‘qimaydi — alohida tezkor mexanizm ishlaydi. AGENTS.md’dagi qoidalar faqat Cursor ichida chat orqali so‘rov yuborganingizda ahamiyatga ega. Demak, AGENTS.md’ga “var ishlatma, constdan foydalan” deb yozish avto-to‘ldirishga ta’sir qilmaydi; buni ESLint yoki TypeScript konfiguratsiyasi orqali sozlash kerak.

2. AGENTS.md’dagi Claude Code hooks Codex’da ishlamaydi. .claude/settings.jsonda muayyan amalni to‘sish uchun PreToolUse hook sozlangan bo‘lsa, bu ma’lumot faqat Claude uchun foydali. Codex hooks haqida bilmaydi; uning nazarida “vosita o‘zi qaror qiladi.” AGENTS.mdga “X’ni qilma”, importdan keyin CLAUDE.mdga esa “X’ni jismonan to‘sadigan hook bor” deb yozish ma’qul.

3. Copilot va .github/copilot-instructions.md. GitHub Copilot o‘z faylini o‘qiydi, AGENTS.md’ni esa hanuz yaxshi o‘qimaydi. Jamoangiz Copilot’dan faol foydalansa, qoidalarning qisqaroq nusxasi bilan alohida .github/copilot-instructions.md qo‘shing yoki AGENTS.md’ni tushunadigan Copilot kengaytmalaridan foydalaning. Bu tez o‘zgarib bormoqda, shuning uchun uch-olti oydan keyin vaziyat boshqacha bo‘lishi mumkin.

4. Git ramziy havolani CLAUDE.md o‘zgarishi sifatida kuzatmaydi. ln -s AGENTS.md CLAUDE.mdni ishga tushirib, bir haftadan keyin AGENTS.mdni yangilasangiz, Git faqat AGENTS.md uchun diff ko‘rsatadi. Bu odatiy hol, ammo pull requestni ko‘rayotgan hamkasbingiz CLAUDE.md ham (ramziy havola orqali) yangilanganini sezmasligi mumkin. Yechim: pull request tavsifida “AGENTS.md yangilandi; Claude Code ramziy havola orqali ayni faylni ko‘radi” deb aniq yozing.

5. Chuqur importlarni tuzatishda nosozlikni aniqlash qiyin. Agar AGENTS.md @docs/coding-style.mdni, u esa @docs/typescript.mdni import qilsa va qoidalar o‘zaro zid kelsa, nosozlikni aniqlash qiyin. Men importlarni bir darajada (CLAUDE.md → AGENTS.md) saqlab, chuqurroq ichma-ich joylashtirmayman. Anthropic qaysi fayllar yuklanganini log qiladigan InstructionsLoaded hook’ini taqdim etadi — qatlamli sozlamalarni tuzatishda foydali. Eslatma: hook import yoki ramziy havola orqali kiritilgan AGENTS.md uchun ishlaydi, lekin Claude Code o‘zi o‘qigan AGENTS.md uchun ishlamaydi.

Bir oqshomda sozlanadigan vibe-coding to‘plami: AI klon + Ikkinchi miya + kontekst muhandisligi.

Ailoot bilan tanishing.