AGENTS.md nima va 30 daqiqada o‘z faylingizni qanday yozish mumkin

Vibe coding va agentlar bilan ishlash bo‘yicha amaliy materiallar: Ailoot hujjatlari.

AGENTS.md bir paragrafda#

Quyida format agents.md, OpenAI Codex hujjatlari, JetBrains Junie, Cursor Rules Docs, GitHub Copilot Coding Agent o‘zgarishlar jurnali va Agentic AI Foundation tashkil topgani haqidagi Linux Foundation press-relizi asosida ko‘rib chiqiladi. Barcha raqamlar va xususiyatlar 2026-yil 30-may holatiga mos; Claude Code’dagi AGENTS.md qo‘llovi Anthropic hujjatlari asosida, 2026-yil 24-sentabrdagi yangilanish hisobga olingan holda bayon etiladi.

Bozordagi bu vositalar ko‘pligini va ularga nima uchun umumiy fayl kerakligini bilmasangiz, avval “2026-yilda nimada kod yozish kerak: Claude Code’dan Antigravity’gacha 8 ta AI vositasi” qo‘llanmasini o‘qing. Ushbu maqola aynan AGENTS.md formatiga va 30 daqiqada o‘z faylingizni yozishga bag‘ishlangan.

AGENTS.md nima va u qayerdan paydo bo‘lgan?#

Avvallari har bir AI vositasining o‘z qoidalar fayli bo‘lardi: Anthropic’da CLAUDE.md, Cursor’da .cursorrules, GitHub’da .github/copilot-instructions.md, Aider’da .aider.conf.yml, JetBrains’da esa .junie/guidelines.md. Jamoangizda uchta turli agent bo‘lsa, bir xil mazmundagi uchta parallel faylga ega bo‘lar edingiz va ular bir hafta ichida bir-biridan farq qilib ketardi.

Bundan birinchi bo‘lib OpenAI charchadi. 2025-yil avgustida u Codex CLI’ni chiqardi va shu bilan bir vaqtda agents.md saytida ochiq formatni ishga tushirdi. Saytdan:

“AGENTS.md’ni agentlar uchun README deb tasavvur qiling.”

(agents.md, ingliz tilidan tarjima)

Asosiy fikr shuki, AGENTS.md README’ni to‘ldiradi. README odamlarga yoziladi: “loyiha nima, uni lokalda qanday ishga tushirish, unga qanday hissa qo‘shish”. AGENTS.md esa agentga yoziladi: aniq shell buyruqlari, tekshiriladigan “bajarildi” mezonlari va “bunga hech qachon tegma” kabi chegaralar.

Saytdan:

“AGENTS.md README’ni to‘ldiradi: unda agentga kerak bo‘ladigan qo‘shimcha, ba’zan batafsil kontekst — yig‘ish bosqichlari, testlar va README’ni ortiqcha band qiladigan yoki inson ishtirokchilarga shunchaki kerak bo‘lmagan qoidalar saqlanadi.”

(agents.md, ingliz tilidan tarjima)

2025-yil sentabriga kelib, GitHub Copilot Coding Agent bu formatni qo‘llab-quvvatladi (o‘zgarishlar jurnali, 28.08.2025). Dekabrga kelib, Cursor, Junie, Gemini CLI, Aider va yana o‘nlab vositalar ham qo‘shildi. 2025-yil 9-dekabrda Linux Foundation Agentic AI Foundation (AAIF) tashkil etdi: uning uchta asoschi loyihasi OpenAI’ning AGENTS.md’i, Anthropic’ning MCP’i va Block’ning goose’i edi. Asoschi a’zolar AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft va OpenAI bo‘ldi. 2026-yil 24-fevralga kelib, fondga 146 ta tashkilot, jumladan Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, UiPath va Hitachi qo‘shildi.

Shundan so‘ng AGENTS.md “OpenAI’dan chiqqan yana bir narsa” bo‘lishdan chiqib, amalda standartga aylandi.

Qaysi AI agentlar AGENTS.md’ni o‘qiydi, qaysilari esa o‘qimaydi?#

2026-yil 30-may holatidagi qo‘llab-quvvatlash jadvali; Claude Code qatori 2026-yil 24-sentabrda yangilangan:

Yirik o‘yinchilar orasida Anthropic eng oxirida qo‘shildi. 2025-yil avgustida rasmiy anthropics/claude-code repozitoriyasida AGENTS.md qo‘llovini so‘rab #6235-masala ochildi.

Masala qariyb bir yil ochiq turdi va 2026-yil 17-avgustda yopildi; AGENTS.md qo‘lloviga ega 2.1.277 versiyasi 18-sentabrda chiqdi. Anthropic mantiqi quyidagicha: CLAUDE.md ustuvor, AGENTS.md esa ish papkasida yoki uning ota papkalaridan birortasida CLAUDE.md bo‘lmagandagina o‘qiladi. Hujjatlarga ko‘ra, bu quyidagicha ishlaydi:

Nozik jihati shundaki, shaxsiy CLAUDE.local.md ham hisobga olinadi va shunda Claude Code AGENTS.md’ni o‘qimay qo‘yadi. Bu xatti-harakatni /config bo‘limida, Project instructions ostida o‘zgartirish mumkin — masalan, Claude Code ikkala faylni birdan o‘qiydigan qilish mumkin. 2.1.277 dan eski versiyalarda AGENTS.md avtomatik aniqlanmaydi; CLAUDE.md faylidagi @AGENTS.md satri hali ham vaqtinchalik yechim bo‘lib qoladi.

AGENTS.md CLAUDE.md va .cursorrulesdan nimasi bilan farq qiladi?#

2026-yil 30-may holatidagi to‘rtta format taqqoslanishi:

Asosiy g‘oya: AGENTS.md “barcha agentlar uchun bitta fayl” muammosini hal qiladi, lekin “men commit qilmaydigan shaxsiy sozlamalar” muammosini hal qilmaydi. Claude Code’da buning uchun CLAUDE.local.md, Cursor’da esa foydalanuvchi darajasidagi lokal .mdc fayllari bor. AGENTS.md buni yolg‘iz o‘zi ta’minlamaydi — uni boshqa fayllar bilan birga ishlatish yoki shaxsiy qoidalarni gitignore qilingan bo‘limlarda yozishga jamoa bo‘lib kelishish kerak.

Yana bir muhim jihat — monorepolar. Codex va Cursor “eng yaqin AGENTS.md ustun” qoidasini qo‘llaydi:

“Monorepoda har bir paket ichiga alohida AGENTS.md qo‘ying. Agentlar katalog daraxtidagi eng yaqin faylni avtomatik o‘qiydi va eng yaqin fayl ustun bo‘ladi.”

(agents.md, ingliz tilidan tarjima)

agents.md saytida OpenAI’ning asosiy monoreposida turli ichki paketlar uchun 88 ta AGENTS.md fayli borligi aytiladi. Monorepoda ishlasangiz, qoidalarni darajalarga taqsimlang: umumiy qoidalar ildizda, muayyan qoidalar esa ichki papkalarda.

Yaxshi AGENTS.md nimalarni o‘z ichiga olishi kerak?#

agents.md sayti moslashuvchan format — “istalgan Markdown”ni taklif qiladi. Ammo amalda uchraydigan yaxshi fayllarning 80% ida bir xil sakkizta bo‘lim bor. Asosiy qoida: har bir band aniq buyruq yoki konkret misol bo‘lishi kerak. “Toza kod yozing” kabi mavhum fikrni agent e’tiborsiz qoldiradi.

1. Loyiha haqida qisqacha ma’lumot — 2–3 satr. Loyiha nima, kim uchun va uning asosiy maqsadi nima. Marketing kerak emas. Misol: “Pulli seminarga qo‘shilish uchun Telegram bot. Stek: Next.js 14, Prisma, PostgreSQL. purchases jadvalida yangi yozuv paydo bo‘lganda ishga tushadi.”
2. Sozlash buyruqlari — lokalda ishga tushirish uchun aniq shell buyruqlari. npm install, npm run dev, npm run build. “Odatda shunday qilamiz” degan gaplar kerak emas.
3. Kod uslubi / qoidalar — “toza yozing” emas, misolli aniq qoidalar. Masalan: “TypeScript qat’iy rejimi, qo‘shtirnoq o‘rniga bir tirnoq, default export yo‘q, komponent nomlari PascalCase’da, hook’lar use bilan boshlanadi.”
4. Ishlab chiqish muhiti bo‘yicha maslahatlar — muhim narsalar qayerdaligi. .env uchun kerakli o‘zgaruvchilar, maxfiy qiymatlar saqlanadigan joy, ishlatilayotgan portlar va lokal ma’lumotlar bazasi bilan ishlash usuli.
5. Test bo‘yicha ko‘rsatmalar — muayyan testni qanday ishga tushirish va nimani “muvaffaqiyatli” deb hisoblash. Masalan: npm test -- --testPathPattern=user-auth; 100% muvaffaqiyat kutiladi.
6. PR / commit qoidalari — commit xabari formati, PRdan oldingi tekshiruvlar ro‘yxati (testlar, linter, hujjatlar) va kim tasdiqlashi.
7. Xavfsizlik masalalari — hech qachon nima qilinmasligi kerak. “.env’ni hech qachon commit qilmang. Maxfiy qiymatlar faqat Vault’da bo‘lishi kerak. Foydalanuvchilarning shaxsiy ma’lumotlarini jurnallarda ko‘rsatmang.”
8. Chegaralar / Buni hech qachon qilmang — taqiqlar va ularga muqobil amal. “main’ga git push --force ishlatmang. Orqaga qaytarmoqchi bo‘lsangiz, xususiyat tarmog‘ida git revert yoki git reset ishlating.”

Har bir bo‘limda “g‘oya o‘rniga buyruq” tamoyiliga amal qiling. Agent “migratsiyalarda ehtiyot bo‘ling” degan gapni e’tiborsiz qoldiradi. “alembic upgrade headdan oldin alembic checkni bajaring. Xato chiqsa, migratsiyani qo‘llamang va mendan so‘rang” ko‘rsatmasiga amal qiladi.

Ishlatishga tayyor AGENTS.md shabloni (nusxa oling va moslang)#

# AGENTS.md

## Loyiha haqida qisqacha ma’lumot

<project-name> - <uning maqsadini ifodalovchi bir ibora>.
Stek: <Next.js / Python / Go / ...>.
Asosiy obyektlar: <foydalanuvchilar, buyurtmalar, postlar ...>.
Odamlar uchun batafsil ma’lumot README.md’da.

## Sozlash buyruqlari

```bash
# birinchi o‘rnatish
npm install
cp .env.example .env  # keyin qo‘lda to‘ldiring; quyidagi ro‘yxatga qarang

# ishga tushirish
npm run dev           # :3000 portidagi ishlab chiqish serveri
npm run build         # ishlab chiqarish yig‘ilmasi
npm run start         # ishlab chiqarish yig‘ilmasini ishga tushirish
```

## Ishlab chiqish muhiti

- Node 20+ (`nvm` orqali: `nvm use 20`)
- PostgreSQL 16 lokalda :5432 portida (`docker-compose up postgres`)
- Redis ixtiyoriy, faqat navbatlar uchun kerak (`docker-compose up redis`)
- `.env`: `DATABASE_URL`, `STRIPE_KEY`, `RESEND_API_KEY`, `JWT_SECRET`
- Butun `.env` faylini hech qachon o‘qimang. Bitta o‘zgaruvchi kerak bo‘lsa: `grep "^VAR=" .env`

## Kod uslubi

- TypeScript qat’iy rejimi
- Bir tirnoq, nuqtali vergul yo‘q (ESLint talab qilmasa)
- Importlar: avval tashqi, keyin `@/` orqali ichki, undan so‘ng nisbiy
- Komponentlar PascalCase’da; hook’lar `use` bilan boshlanadi
- “Nega uni turlash mumkin emasligi”ni tushuntiruvchi aniq izoh bo‘lmasa, `any` ishlatmang

Yaxshi modul namunasi:

```ts
import { z } from 'zod'

const UserSchema = z.object({
  email: z.string().email(),
  name: z.string().min(2),
})

export function parseUser(raw: unknown) {
  return UserSchema.parse(raw)
}
```

## Testlash

```bash
npm test                                # barcha testlar
npm test -- --testPathPattern=auth      # faqat auth
npm test -- --watch                     # kuzatish rejimi
```

Commit qilishdan oldin barcha testlar muvaffaqiyatli o‘tishi kerak. Test muvaffaqiyatsiz bo‘lsa, commit qilmang; nima qilishni mendan so‘rang.

## Pull request qoidalari

- Commit formati: `<type>(<scope>): <description>` (`feat(auth): add magic-link`)
- PRdan oldin: `npm run build && npm test && npm run lint`
- PR tavsifi = nimalar o‘zgardi, nima uchun va qanday sinash kerak
- O‘z PR’ingizni o‘zingiz tasdiqlamang — doim inson tekshiruvini kuting

## Xavfsizlik

- Maxfiy qiymatlar faqat `.env` va Vault’da bo‘lsin, kodda hech qachon emas
- Shaxsiy ma’lumotlarni (email, telefon, ism) jurnalga yozmang
- Ishlab chiqarish ma’lumotlar bazasi bilan ishlaganda, aniq ruxsat berilmagan bo‘lsa, faqat o‘qish so‘rovlaridan foydalaning
- Tashqi xizmatlarning API kalitlarini (Stripe, OpenAI) testlarda kodga qotirib yozmang

## Buni hech qachon qilmang

- `main`’ga `git push --force` qilmang. Orqaga qaytarmoqchi bo‘lsangiz, `git revert` ishlating yoki yangi PR oching
- `alembic check` (yoki ORM’ingizdagi unga teng buyruq)ni bajarmasdan ma’lumotlar bazasi migratsiyalarini ishga tushirmang
- Loyiha bog‘liqliklari uchun `npm install -g` yoki `sudo` ishlatmang
- Tasdiqsiz bog‘liqlik qo‘shmang (ayniqsa og‘irlarini: webpack plaginlari, ORM)

Shablon o‘rtacha 80–120 satrdan iborat. Fayl 150 satrdan oshsa, qayta tuzish kerak bo‘lishi mumkin: biror narsani docs/ga ko‘chiring, unga havola bering yoki bir satrga ixchamlang. Amalda 100–150 satrlik fayllar eng yaxshi ishlaydi; undan oshganda sifat yutuqlari pasaya boshlaydi.

AGENTS.md’ni chinakam foydali qiladigan 5 ta qoida qaysi?#

1. G‘oya o‘rniga buyruqlar. Agent “migratsiyalarda ehtiyot bo‘ling” degan gapni tushunmaydi. alembic upgrade headdan oldin alembic check bajarish ko‘rsatmasiga amal qiladi. Agentlar kayfiyatlar bilan emas, buyruqlar va shartlar bilan ishlaydi. Barcha asosiy qoidalarni “X ni bajaring, aks holda Y” shaklida yozing.

2. Muqobil amalli taqiqlar. Oddiy “force push qilmang” degan taqiq ikki-uchta so‘rovdan keyin agent tomonidan indamay e’tiborsiz qoldiriladi. “X ni qilmang; uning o‘rniga Y ni qiling” juftligi samara beradi. Misol: “main’da git push --force ishlatmang; orqaga qaytarmoqchi bo‘lsangiz, git revert ishlating yoki yangi PR oching.”

3. Aynan bitta asosiy manba. Ildizdagi AGENTS.md butun loyiha uchun asosiy manbadir. Monorepo bo‘lsa, “eng yaqini ustun” qoidasiga amal qilib, ichki papkalarda ichki AGENTS.md fayllaridan foydalaning. Qarama-qarshi ko‘rsatmalarga ega parallel fayllar bo‘lmasin.

4. Tekshiriladigan “bajarildi” mezonlari. “Testlar o‘tishi kerak” degan gap foydasiz. Aniq mezon: npm test 0 chiqish kodi bilan tugaydi va stdout’ga FAIL chiqarmaydi. “Kod toza bo‘lishi kerak” degani ham foydasiz. Aniq mezon: npm run lint ogohlantirishlarsiz o‘tadi. Agent “bajarildi” nimani anglatishini faqat shartni ochiq tasvirlasangiz tushunadi.

5. 150 satrdan qisqa fayl. 150 satrdan oshgach, ko‘rsatkichlar yomonlasha boshlaydi: agent kontekstning ko‘proq qismini o‘qishga sarflaydi va muhim qoidalarni o‘tkazib yuboradi. Hammasi sig‘masa, batafsil ma’lumotni docs/architecture.mdga ko‘chiring va AGENTS.md’dan unga havola bering; faylda faqat buyruqlar va chegaralarni qoldiring.

AGENTS.md’ni chiqindiga aylantiradigan 10 ta xato qaysi?#

1. Buyruqsiz mavhum qoidalar. Agent “migratsiyalarda ehtiyot bo‘ling” degan gapni e’tiborsiz qoldiradi — bu jumla uning uchun bo‘sh. Faqat shartli aniq buyruq ishlaydi: “alembic upgrade headdan oldin alembic checkni bajaring. Xato chiqsa, migratsiyani qo‘llamang va mendan so‘rang.”

2. “Toza kod.” Foydasiz ibora. Uni aniq andoza bilan almashtiring: “Hook’lardan foydalanadigan funksional komponentlar yozing. Misol: function LoginForm() { const [email, setEmail] = useState(''); ... }”

3. Tuzilmasiz nasr. AGENTS.md sarlavhalarsiz 300 satr nasrdan iborat bo‘lsa, agent aloqasiz paragraflarga 80K kontekst tokenini sarflaydi va muhim narsalarni o‘tkazib yuboradi. H2/H3 sarlavhalar, qisqa bo‘limlar va punktli ro‘yxatlardan foydalaning.

4. 150 satrdan uzun fayl. Bu chegaradan keyin sifat ko‘rsatkichlari pasayadi. Uni asosiy fayl va docs/dagi batafsil ma’lumotlarga havolalarga ajrating.

5. Muqobili ko‘rsatilmagan 30 dan ortiq taqiq. Faylda “X ni qilmang, Y ni qilmang” degan uzun ro‘yxat bo‘lib, “uning o‘rniga Z ni qiling” deyilmasa, agent ko‘r-ko‘rona paypaslab yuradi.

6. README.md’ni takrorlash. README’da allaqachon “qanday o‘rnatish va ishga tushirish”ni yozgan bo‘lsangiz, uni AGENTS.md’ga ko‘chirmang. Buning o‘rniga, bir satrda README’ga havola bering va AGENTS.md’da agentga kerak, lekin inson ishtirokchilarga kerak bo‘lmagan narsalarni yozing.

7. Maxfiy qiymatlarni qotirib yozish. AGENTS.md ochiq bo‘lishi mumkin (u git’da turadi). Unda haqiqiy API kalitlari, tokenlar yoki parollar bo‘lmasin. Faqat maxfiy qiymatlar omboriga havolalar bering: “Vault’ga qarang: secret/staging/db.”

8. Ustuvorligi belgilanmagan qarama-qarshi talablar. “Tez ishlang” + “test qamrovini 90% saqlang” agentni nimani tanlash borasida ikkilantiradi. Ularni ochiq tartiblang: “Avval test qamrovi ≥80%, keyin tezlik. Ular zid kelsa, testlar ustun.”

9. Eskirgan hujjatlar. Arxitektura tavsifida REST+polling deyiladi, holbuki amalda allaqachon WebSocket ishlatiladi. Agent eskirgan tavsifga amal qilib, arxitekturani buzadi. Qoida: arxitektura o‘zgarganda, o‘sha PR’da AGENTS.md’ni ham yangilang.

10. Oddiy vazifa uchun ortiqcha arxitektura tafsilotlari. Kimdir konfiguratsiyada ikki satrni o‘zgartirishni so‘rasa, agent 14 ta mikroxizmat topologiyasini to‘liq o‘qishga majbur bo‘lmasligi kerak. Batafsil arxitekturani docs/architecture.mdga ko‘chiring; AGENTS.md’da faqat “vazifa arxitekturaga oid bo‘lsa, docs/architecture.mdni o‘qing” deb qoldiring.

GitHub Blog’ning 2 500 dan ortiq AGENTS.md repozitoriyasini o‘rgangan tadqiqoti asosiy xulosani shunday ifodalaydi:

“Aksariyat agent fayllari haddan tashqari umumiy bo‘lgani uchun samara bermaydi. ‘Siz foydali kod yozish yordamchisisiz’ degan gap ishlamaydi.”

(GitHub Blog, ingliz tilidan tarjima)

Bitta repozitoriyada AGENTS.md va CLAUDE.md’ni qanday saqlash kerak?#

Asosiy amaliy savol — mazmunni takrorlamasdan ikkala faylni qanday birga ishlatish. Uchta holat bor:

1-holat: faqat Claude Code. CLAUDE.md’ni saqlab, Claude Code’ning barcha imkoniyatlaridan foydalaning: foydalanuvchi darajasidagi ko‘rsatmalar uchun ~/.claude/CLAUDE.md, loyiha uchun CLAUDE.md, shaxsiy o‘zgartirishlar uchun CLAUDE.local.md, boshqa fayllarni kiritish uchun @import va ixtisoslashgan ko‘nikmalar uchun .claude/skills/. AGENTS.md kerak emas.

2-holat: bir nechta kod yozish mijozi. Umumiy qoidalarni AGENTS.md’da saqlang, so‘ng har bir mijozni alohida ulang va tekshiring. Gemini CLI kontekst fayli nomini sozlashni, Aider esa o‘qish sozlamasi orqali fayl yuklashni qo‘llaydi. Bular bir xil avtomatik topish emas, aniq yuklash yo‘llaridir.

Zararsiz sinov repozitoriyida yangi sessiya boshlang. Masalan, «sinov javobiga instructions-loaded belgisini qo‘sh» kabi noyob zararsiz ko‘rsatma bering. Javob bilan birga mijozning hujjatlangan yuklangan fayllar ko‘rinishi yoki logini ham tekshiring. Buni amalda ishlatadigan har bir mijoz va versiyada takrorlang. Modelning «faylni o‘qidim» degan javobi mustaqil yuklash dalili emas; bitta muvaffaqiyat boshqa barcha vositalardagi qo‘llovni isbotlamaydi.

3-holat: aralash jamoa (Claude Code + boshqa vositalar). Bu 2026-yildagi eng keng tarqalgan sozlama. AGENTS.md’ni asosiy fayl qiling. Faqat Claude Code uchun qoidalaringiz bo‘lmasa, CLAUDE.md’ni umuman yaratmang: 2.1.277 versiyasidan boshlab, loyihada CLAUDE.md bo‘lmasa, Claude Code AGENTS.md’ni o‘qiydi. Alohida qoidalaringiz bo‘lsa, CLAUDE.md’ni simvolik havola yoki @AGENTS.md importiga ega qisqa o‘ram fayl qiling.

O‘zgartirishdan oldin ikkala faylni tekshirib, zaxiralang. Ikkalasi bor bo‘lsa, zid bo‘lmagan umumiy qoidalarni AGENTS.md’ga birlashtiring, Claude’ga xoslarini @AGENTS.md importi bilan CLAUDE.md’da qoldiring. Mavjud symlink’larni almashtirmay saqlang.

Oddiy CLAUDE.md uchun faqat AGENTS.md yo‘q bo‘lsa, macOS/Linux’da quyidagi himoya mavjud fayl yoki symlink ustiga yozishni rad etadi:

if [ -e AGENTS.md ] || [ -L AGENTS.md ]; then
  printf '%s\n' 'STOP: AGENTS.md exists; merge both files first.' >&2
elif [ -f CLAUDE.md ] && [ ! -L CLAUDE.md ]; then
  mv CLAUDE.md AGENTS.md && ln -s AGENTS.md CLAUDE.md
else
  printf '%s\n' 'STOP: inspect the existing CLAUDE.md path first.' >&2
fi

Muvaffaqiyatli qayta nomlashdan keyin CLAUDE.md AGENTS.md’ga symlink bo‘ladi. AGENTS.md’ni o‘qiydigan barcha agentlar bir xil mazmunni ko‘radi. CLAUDE.md’ni o‘qiydigan Claude Code esa simvolik havola orqali ayni mazmunni ko‘radi.

Windows’da simvolik havola yaratish uchun Developer Mode (yoki Admin) kerak bo‘lishi mumkin, bu butun jamoa uchun qulay bo‘lmasligi mumkin. Muqobil yo‘l — AGENTS.md’ni import qiladigan qisqa CLAUDE.md yozish:

# CLAUDE.md

@AGENTS.md

## Claude Code’ga xos

- Ixtisoslashgan so‘rovlar uchun .claude/skills/ dan foydalaning
- Skills bilan ishlaganda .claude/skills/INDEX.md ga qarang
- Katta o‘zgarishlardan oldin Plan Mode’dan foydalaning (Shift+Tab)

Claude Code’da bu sintaksis AGENTS.md’ni bitta satr bilan qo‘shadi va uning ostiga Claude Code’ga xos qo‘shimcha qoidalarni yozish imkonini beradi. Keyinchalik AGENTS.md’ni olib tashlamoqchi bo‘lsangiz, importni o‘chirsangiz bas. Bu satr faylni ikki marta o‘qishga olib kelmaydi: Claude Code hujjatlariga ko‘ra, AGENTS.md’ni o‘zi ham o‘qiy oladigan holatda, uni ikkinchi marta yuklamaydi.

2026-yilda ko‘p vositali jamoa uchun tavsiya etilgan tuzilma:

repo-root/
├── AGENTS.md                              # asosiy manba, ≤150 satr
├── CLAUDE.md                              # faqat Claude’ga xos qoidalar bo‘lsa: simvolik havola → AGENTS.md YOKI @AGENTS.md + qo‘shimchalar
├── .cursor/rules/                         # faqat Cursor uchun maqsadli o‘zgartirishlar
├── .github/copilot-instructions.md        # ishlatilsa, “AGENTS.md’ga qarang”
└── docs/architecture.md                   # AGENTS.md’dan havola berilgan batafsil arxitektura

CLAUDE.md haqida batafsil ma’lumot “CLAUDE.md’ni to‘g‘ri sozlash” qo‘llanmasida. Agentga nima uchun katta ko‘rsatmalar fayli kerakligi haqida ko‘proq bilish uchun “Kontekst muhandisligi nima” maqolasini o‘qing.

2026-yilda nima o‘zgardi: nega AAIF AGENTS.md’ni Linux Foundation tarkibiga oldi?#

2026-yil mayidagi AI dasturlash sohasidagi asosiy siyosiy voqea yana bir model chiqishi emas, balki formatlarning birlashishi bo‘ldi. Avvallari har bir sotuvchining o‘z qoidalar fayli bor edi. Bu sotuvchilar uchun qulay, bir nechta vosita bilan ishlaydigan jamoalar uchun esa mashaqqatli edi.

2025-yil 9-dekabrdagi press-relizda Linux Foundation Agentic AI Foundation’ni uchta format uchun soyabon tashkilot sifatida e’lon qildi:

• AGENTS.md — OpenAI’dan, agentlar uchun ko‘rsatmalar fayli formati
• Model Context Protocol (MCP) — Anthropic’dan, tashqi vositalarni agentlarga ulash protokoli
• goose — Block’dan, ochiq kodli agent freymvorki

Linux Foundation press-relizidan:

“Bu loyihalarni AAIF soyaboni ostida birlashtirish, faqat ochiq boshqaruv ta’minlay oladigan shaffoflik va barqarorlik asosida ularning rivojlanishini kafolatlaydi.”

(Linux Foundation press-relizi, 2025-yil 9-dekabr, ingliz tilidan tarjima)

2026-yil 24-fevralga kelib, 146 ta tashkilot AAIF a’zosi bo‘ldi (ikki oy ichida 97 ta yangi a’zo). Yangi Oltin a’zolar qatoriga Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, Hitachi, UiPath, American Express va Autodesk kirdi. Anthropic MCP’ni ilgari surib, Platinum darajasida. OpenAI AGENTS.md’ni ilgari surib, Platinum darajasida. Block esa goose bilan Platinum darajasida.

Bu AGENTS.md’ning maqomini o‘zgartiradi: “OpenAI formati”dan soha standartiga aylantiradi. 2026-yil bahorida Claude Code hali chetda edi, ammo sentabrda 2.1.277 versiyasi bilan AGENTS.md’ni o‘zi o‘qishni o‘rgandi. CLAUDE.md yo‘qolib ketmadi; loyihada mavjud bo‘lsa, odatda hamon ustuvor hisoblanadi.

Umumiy loyiha qoidalarini AGENTS.md’da saqlash amaliy boshlang‘ich yo‘ldir. Har mijoz talab qilgan import, o‘ram yoki aniq o‘qish sozlamasini qo‘shing. Claude Code’da CLAUDE.md importi yoki simvolik havola kerakligini hal qilishdan oldin versiya va fayllar ustuvorligini tekshiring. Har mijozda yuklashni tekshiring; bu yerda qamrov foizi o‘lchanmagan.

Keyin nima?#

AGENTS.md — “agent bilan qanday kelishish kerakki, u bashorat qilinadigan tarzda ishlasin” mavzusidagi birinchi asosiy bo‘g‘in. Keyingisi — loyihaning biznes konteksti, auditoriyasi, mahsulotlari va narxlarini o‘z ichiga olgan bilimlar papkasi. Uchinchi bo‘g‘in — kontekst muhandisligi; u hamma narsani birlashtiradi: agent har bir bosqichda qaysi fayllarni ko‘radi, sessiyalar orasida holat qanday saqlanadi va turli modellar o‘rtasida qanday almashiladi.

Amaliy materiallar: Ailoot hujjatlari.

Qo‘shimcha materiallar va vositalar: Ailoot.