AGENTS.md дегеніміз не және өз нұсқаңызды 30 минутта қалай жазуға болады

Vibe coding және агенттермен жұмыс туралы практикалық материалдар: Ailoot құжаттамасы.

AGENTS.md бір абзацта#

Төменде пішім agents.md, OpenAI Codex құжаттамасы, JetBrains Junie, Cursor Rules Docs, GitHub Copilot Coding Agent changelog және Linux Foundation-ның Agentic AI Foundation туралы баспасөз хабарламасы негізінде қарастырылады. Барлық сандар мен мүмкіндіктер 2026 жылғы 30 мамырдағы жағдай бойынша берілген, ал Claude Code-тағы AGENTS.md қолдауы Anthropic құжаттамасына сәйкес, 2026 жылғы 24 қыркүйектегі жаңартуды ескере отырып сипатталған.

Нарықтағы құралдардың осы «хайуанаттар бағы» не екенін және оларға ортақ файл не үшін керек екенін білмесеңіз, алдымен «2026 жылы немен код жазуға болады: Claude Code-тан Antigravity-ге дейінгі 8 AI құралы» нұсқаулығын оқыңыз. Бұл мақала AGENTS.md пішіміне және өз нұсқаңызды 30 минутта жазуға арналған.

AGENTS.md дегеніміз не және ол қайдан пайда болды?#

Бұрын әр AI құралында өз ережелер файлы болатын: Anthropic-та CLAUDE.md, Cursor-да .cursorrules, GitHub-та .github/copilot-instructions.md, Aider-де .aider.conf.yml, ал JetBrains-та .junie/guidelines.md болды. Командаңызда үш түрлі агент болса, мазмұны бірдей үш бөлек файл қатар жүріп, бір аптаның ішінде бір-бірінен алшақтайтын.

Бұған бірінші болып OpenAI-дің шыдамы таусылды. 2025 жылғы тамызда компания Codex CLI-ді шығарып, сонымен бірге agents.md сайтын ашық пішім ретінде іске қосты. Сайтта былай делінген:

«AGENTS.md файлын агенттерге арналған README деп қарастырыңыз.»

(agents.md, ағылшын тілінен аударылған)

Негізгі ойы — AGENTS.md файлы README-ді толықтырады. README адамдарға арналады: «жоба не туралы, оны жергілікті ортада қалай іске қосуға болады, оған қалай үлес қосуға болады». AGENTS.md агентке арналады: нақты shell командалары, тексерілетін «дайын» өлшемдері және «бұған ешқашан тиме» сияқты шектеулер.

Сайттан:

«AGENTS.md README файлын толықтырады: онда агентке қажет қосымша, кейде егжей-тегжейлі контекст — құрастыру қадамдары, тесттер және README-ді ретсіз ететін немесе адам қатысушыларға қажеті жоқ ережелер — беріледі.»

(agents.md, ағылшын тілінен аударылған)

2025 жылғы қыркүйекке қарай GitHub Copilot Coding Agent бұл пішімді қолдады (changelog, 28.08.2025). Желтоқсанға қарай Cursor, Junie, Gemini CLI, Aider және тағы он шақты құрал қосылды. 2025 жылғы 9 желтоқсанда Linux Foundation Agentic AI Foundation (AAIF) ұйымын құрды: оның үш негізін қалаушы жобасы — OpenAI-дің AGENTS.md форматы, Anthropic-тің MCP протоколы және Block-тың goose жобасы. Негізін қалаушы мүшелері AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft және OpenAI болды. 2026 жылғы 24 ақпанға қарай қор құрамында Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, UiPath және Hitachi кіретін 146 ұйым болды.

Содан бері AGENTS.md «OpenAI-дің тағы бір дүниесі» болудан қалып, іс жүзіндегі стандартқа айналды.

Қай AI агенттері AGENTS.md файлын оқиды, ал қайсысы оқымайды?#

2026 жылғы 30 мамырдағы қолдау кестесі; Claude Code жолы 2026 жылғы 24 қыркүйекте жаңартылды:

Anthropic ірі ойыншылардың ішінен ең соңында қосылды. 2025 жылғы тамызда ресми anthropics/claude-code репозиторийінде AGENTS.md қолдауын сұраған #6235 мәселесі ашылды.

Мәселе шамамен бір жыл ашық тұрып, 2026 жылғы 17 тамызда жабылды; AGENTS.md қолдауы бар 2.1.277 нұсқасы 18 қыркүйекте шықты. Anthropic логикасы мынадай: CLAUDE.md басым, ал жұмыс қалтасында немесе оның кез келген ата-аналық қалтасында CLAUDE.md болмаса, AGENTS.md оқылады. Құжаттамаға сәйкес, бұл былай жұмыс істейді:

Мұндағы ерекшелік — жеке CLAUDE.local.md файлы да есепке алынады, сондықтан ол болса Claude Code AGENTS.md файлын оқымайды. Бұл әрекетті /config ішіндегі Project instructions бөлімінде өзгертуге болады — мысалы, Claude Code-қа екі файлды бірдей оқытуға болады. 2.1.277-ден ескі нұсқалар AGENTS.md файлын автоматты түрде оқымайды; CLAUDE.md ішіндегі @AGENTS.md жолы әлі де уақытша шешім болып саналады.

AGENTS.md файлы CLAUDE.md және .cursorrules файлдарынан несімен ерекшеленеді?#

2026 жылғы 30 мамырдағы жағдай бойынша төрт пішімнің салыстырмасы:

Негізгі ойы: AGENTS.md «барлық агентке бір файл» мәселесін шешеді, бірақ «git-ке қоспайтын жеке баптаулар» мәселесін шешпейді. Claude Code-та бұл үшін CLAUDE.local.md, ал Cursor-да пайдаланушы деңгейіндегі жергілікті .mdc файлдары бар. AGENTS.md мұндай мүмкіндікті өздігінен бермейді — оны басқа файлдармен біріктіру немесе жеке ережелерді gitignore тізіміндегі бөлімдерде жазуға командамен келісу керек.

Тағы бір маңызды жайт — монорепозиторийлер. Codex пен Cursor «ең жақын AGENTS.md файлы қолданылады» деген ережені іске асырады:

«Монорепозиторийде әр пакеттің ішіне жеке AGENTS.md қойыңыз. Агенттер каталогтар ағашындағы ең жақын файлды автоматты түрде оқиды, ал ең жақын файл басым болады.»

(agents.md, ағылшын тілінен аударылған)

agents.md сайты OpenAI-дің негізгі монорепозиторийінде әртүрлі ішкі пакеттерге арналған 88 AGENTS.md файлы бар екенін айтады. Монорепозиториймен жұмыс істесеңіз, ережелерді деңгейлерге бөліңіз: жалпы ережелерді түбірге, нақты ережелерді ішкі қалталарға орналастырыңыз.

Жақсы AGENTS.md ішінде не болуы керек?#

agents.md сайты икемді пішім ұсынады — «кез келген Markdown». Бірақ жақсы файлдардың 80%-ында бірдей сегіз бөлім бар. Негізгі ереже: әр тармақ нақты команда немесе нақты мысал болуы керек. «Таза код жазыңыз» сияқты абстрактілі ойды агент елемейді.

1. Жобаға шолу — 2–3 жол. Жоба не туралы, кімге арналған және негізгі мақсаты қандай. Маркетинг қажет емес. Мысал: «Ақылы воркшопқа қатысушыларды тіркейтін Telegram боты. Стек: Next.js 14, Prisma, PostgreSQL. purchases кестесіне жаңа жазба қосылғанда іске қосылады.»
2. Орнату командалары — жергілікті ортада іске қосылатын нақты shell командалары. npm install, npm run dev, npm run build. «Әдетте осылай істейміз» деген сөз болмауы керек.
3. Код стилі / келісімдер — «ұқыпты жазыңыз» деген емес, мысалы бар нақты ережелер. Мысалы: «TypeScript strict режимі, бір тырнақша, default export қолданбау, компонент атаулары PascalCase түрінде, хуктар use сөзінен басталады.»
4. Әзірлеу ортасы туралы кеңестер — маңызды нәрселер қайда орналасқан. .env ішінде қандай айнымалылар қажет, құпиялар қайда сақталады, қандай порттар қолданылады және жергілікті ДҚ-мен қалай жұмыс істеу керек.
5. Тестілеу нұсқаулары — нақты тестті қалай іске қосу керек және «жасыл» нәтиже деген не. Мысалы: npm test -- --testPathPattern=user-auth; тесттердің 100%-ы өтуі керек.
6. PR / коммит нұсқаулары — коммит хабарламасының пішімі, PR алдындағы тексеру тізімі (тесттер, линтер, құжаттама) және кім мақұлдайтыны.
7. Қауіпсіздік мәселелері — ешқашан не болмауы керек. «.env файлын ешқашан коммитке қоспаңыз. Құпиялар тек Vault-та сақталсын. Пайдаланушылардың жеке деректерін журналдарға жазбаңыз.»
8. Шектеулер / Ешқашан бұлай істемеңіз — тыйымдарды балама әрекетпен бірге жазыңыз. «git push --force командасын main тармағында қолданбаңыз. Қайтару қажет болса, feature тармағында git revert немесе git reset қолданыңыз.»

Әр бөлімге «ойдың орнына команда» қағидасын қолданыңыз. Агент «миграциялармен абай болыңыз» дегенді елемейді. Ал «alembic upgrade head командасына дейін alembic check іске қосыңыз. Қате шықса, миграцияны қолданбаңыз; менен сұраңыз» деген нұсқауды орындайды.

Қолдануға дайын AGENTS.md үлгісі (көшіріп, бейімдеңіз)#

# AGENTS.md

## Жобаға шолу

<project-name> - <оның мақсатын сипаттайтын бір тіркес>.
Стек: <Next.js / Python / Go / ...>.
Негізгі нысандар: <пайдаланушылар, тапсырыстар, жазбалар ...>.
Адамдарға арналған толық ақпарат README.md файлында.

## Орнату командалары

```bash
# first install
npm install
cp .env.example .env  # then fill in manually; see list below

# run
npm run dev           # dev server on :3000
npm run build         # production build
npm run start         # run production build
```

## Әзірлеу ортасы

- Node 20+ (nvm арқылы: `nvm use 20`)
- :5432 портында жергілікті PostgreSQL 16 (`docker-compose up postgres`)
- Redis міндетті емес, тек кезектерге қажет (`docker-compose up redis`)
- `.env`: `DATABASE_URL`, `STRIPE_KEY`, `RESEND_API_KEY`, `JWT_SECRET`
- `.env` файлын тұтас оқымаңыз. Бір айнымалы қажет болса: `grep "^VAR=" .env`

## Код стилі

- TypeScript strict режимі
- Бір тырнақша, нүктелі үтірсіз (ESLint талап етпесе)
- Импорттар: алдымен сыртқы, содан кейін `@/` арқылы ішкі, ең соңында салыстырмалы
- Компоненттер PascalCase түрінде; хуктар `use` сөзінен басталады
- Нақты «неге тип берілмейтінін» түсіндіретін түсініктемесіз `any` қолданбаңыз

Жақсы модуль мысалы:

```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)
}
```

## Тестілеу

```bash
npm test                                # all tests
npm test -- --testPathPattern=auth      # auth only
npm test -- --watch                     # watch mode
```

Коммит жасамас бұрын барлық тест өтуі керек (нәтиже жасыл болуы тиіс). Қызыл тест шықса, коммит жасамаңыз; менен не істеу керегін сұраңыз.

## Pull request нұсқаулары

- Коммит пішімі: `<type>(<scope>): <description>` (`feat(auth): add magic-link`)
- PR алдында: `npm run build && npm test && npm run lint`
- PR сипаттамасы = не өзгерді, не үшін және қалай тексеру керек
- Өз PR-ыңызды мақұлдамаңыз — әрдайым адам тексергенін күтіңіз

## Қауіпсіздік

- Құпиялар тек `.env` пен Vault-та сақталсын, кодта болмауы керек
- Жеке деректерді (email, phone, name) журналдарға жазбаңыз
- Өндірістік ДҚ-мен жұмыс істегенде, арнайы рұқсат берілмесе, тек оқуға арналған сұрауларды қолданыңыз
- Сыртқы сервистердің API кілттерін (Stripe, OpenAI) тесттерге қатты кодтап жазбаңыз

## Ешқашан бұлай істемеңіз

- Main тармағына `git push --force` жасамаңыз. Қайтару қажет болса, `git revert` қолданыңыз немесе жаңа PR ашыңыз
- ДҚ миграцияларын `alembic check` (немесе ORM жүйеңіздегі баламасы) орындалмайынша іске қоспаңыз
- Жоба тәуелділіктерін орнату үшін `npm install -g` немесе `sudo` қолданбаңыз
- Рұқсатсыз тәуелділіктер қоспаңыз (әсіресе webpack плагиндері мен ORM сияқты көлемді тәуелділіктерді)

Орта есеппен бұл үлгі 80–120 жолдан тұрады. Файл 150 жолдан асып кетсе, оны қайта құрылымдау керек деген белгі: бір бөлігін docs/ қалтасына көшіріңіз, сілтеме беріңіз немесе бірнеше тармақты бір жолға ықшамдаңыз. Іс жүзінде 100–150 жолдан тұратын файлдар жақсы жұмыс істейді; одан асқан кезде сапа өсімі кері айнала бастайды.

AGENTS.md файлын шын мәнінде пайдалы ететін 5 ереже қандай?#

1. Ойдың орнына командалар. Агент «миграциялармен абай болыңыз» дегенді түсінбейді. Бірақ alembic upgrade head алдында alembic check іске қосу нұсқауын орындайды. Агенттер көңіл күймен емес, командалар мен шарттармен жұмыс істейді. Барлық негізгі ережені «X орындаңыз, әйтпесе Y істеңіз» түрінде жазыңыз.

2. Баламасы бар тыйымдар. Жай ғана «force push жасамаңыз» дегенді агент екі-үш сұраудан кейін елемей кетеді. «X істемеңіз; оның орнына Y істеңіз» деген жұп тиімді. Мысалы: «main тармағына git push --force жасамаңыз; өзгерісті қайтару керек болса, git revert қолданыңыз немесе жаңа PR ашыңыз».

3. Тек бір негізгі дереккөзі. Түбірдегі AGENTS.md — бүкіл жобаның негізгі дереккөзі. Монорепозиторий болса, «ең жақын файл басым» ережесіне сай ішкі қалталарда да AGENTS.md файлдарын қолданыңыз. Нұсқаулары бір-біріне қайшы келетін қатарлас файлдар болмауы керек.

4. Тексерілетін «дайын» өлшемдері. «Тесттер өтуі керек» деген пайдасыз. Нақты өлшем: npm test 0 шығу кодын қайтарады және stdout ағынына FAIL деп жазбайды. «Код таза болуы керек» деген де пайдасыз. Нақты өлшем: npm run lint ескертусіз өтеді. Агент «дайын» дегеннің не екенін шартын анық сипаттағанда ғана түсінеді.

5. 150 жолдан қысқа файл. 150 жолдан асқанда көрсеткіштер нашарлай бастайды: агент көбірек контекст жұмсап оқиды да, маңызды ережелерді байқамайды. Сыймаса, толық мәліметті docs/architecture.md файлына көшіріп, AGENTS.md ішінен оған сілтеме беріңіз; файлда тек командалар мен шектеулер қалсын.

AGENTS.md файлын қоқысқа айналдыратын 10 қате қандай?#

1. Командасы жоқ бұлыңғыр ережелер. Агент «миграциялармен абай болыңыз» дегенді елемейді — бұл сөйлем оған ештеңе білдірмейді. Тек шарты бар нақты команда көмектеседі: «alembic upgrade head алдында alembic check іске қосыңыз. Қате болса, миграцияны қолданбаңыз; менен сұраңыз».

2. «Таза код». Пайдасыз тіркес. Оны нақты үлгімен ауыстырыңыз: «Хуктарды пайдаланатын функционал компоненттер қолданыңыз. Мысалы: function LoginForm() { const [email, setEmail] = useState(''); ... }».

3. Құрылымсыз мәтін. AGENTS.md тақырыпшасыз 300 жол прозадан тұрса, агент мәнсіз үзінділерді оқуға 80K контекст токенін жұмсап, маңыздысын байқамай қалады. H2/H3 тақырыптарын, қысқа бөлімдерді және маркерленген тізімдерді қолданыңыз.

4. 150 жолдан ұзын файл. Осы шектен асқан соң сапа көрсеткіштері төмендейді. Оны негізгі файлға және docs/ қалтасындағы егжей-тегжейлі материалдарға сілтемелерге бөліңіз.

5. Баламасы жоқ 30-дан астам тыйым. Файлда «X істемеңіз, Y істемеңіз» деген ұзақ тізім болып, «оның орнына Z істеңіз» деп түсіндірілмесе, агент абдырап, бағытсыз қалады. Augment Code мұндай файлдардың күрделі тапсырмалардағы толықтық көрсеткіші төмен болғанын анықтады: күнделікті тапсырмаларда «жақсы» файл нәтижені 25%-ға жақсартады, ал күрделі жаңа мүмкіндіктерде көрсеткіш 30%-ға төмендейді.

6. README.md мазмұнын қайталау. README ішінде орнату мен іске қосу жолын жазып қойған болсаңыз, оны AGENTS.md ішінде қайталамаңыз. Бір жолмен README-ге сілтеме беріп, AGENTS.md ішінде агентке адам қатысушыларға қажет емес мәліметтерді көрсетіңіз.

7. Құпияларды кодқа қатты енгізу. AGENTS.md ашық болуы мүмкін (ол git ішінде сақталады). Нағыз API кілттерін, токендерді немесе құпиясөздерді жазбаңыз. Тек құпия сақталатын орындарға сілтеме беріңіз: «Vault: secret/staging/db ішінен қараңыз».

8. Реті көрсетілмеген қайшы басымдықтар. «Жылдам жұмыс істе» + «тест қамтуын 90% деңгейінде ұста» деген талаптар агентке қайсысын таңдарын түсіндірмейді. Басымдықтарды нақтылаңыз: «Алдымен тест қамтуы ≥80%, содан кейін жылдамдық. Екеуі қайшы келсе, тесттер басым».

9. Ескірген құжаттама. Архитектура сипаттамасында REST+polling делінген, ал шын мәнінде әлдеқашан WebSockets қолданылуы мүмкін. Агент ескі сипаттамаға сүйеніп, архитектураны бұзады. Ереже: архитектура өзгерсе, сол PR ішінде AGENTS.md файлын да жаңартыңыз.

10. Қарапайым тапсырмаға арналған шамадан тыс архитектура. Конфигурацияның екі жолын өзгертуді сұраса, агентке 14 микросервистің толық топологиясын оқудың қажеті жоқ. Терең архитектуралық мәліметті docs/architecture.md ішіне көшіріп, AGENTS.md ішінде «егер тапсырма архитектураға қатысты болса, docs/architecture.md файлын оқы» деп қалдырыңыз.

GitHub Blog-тың 2,500-ден астам AGENTS.md репозиторийіне жасаған зерттеуінде негізгі қорытынды былай берілген:

«Агенттерге арналған файлдардың көбі тым жалпылама жазылғандықтан іске аспайды. “Сіз пайдалы кодтау көмекшісіз” деген сөз жұмыс істемейді.»

(GitHub Blog, ағылшын тілінен аударылған)

Бір репозиторийде AGENTS.md және CLAUDE.md файлдарын қалай бірге ұстауға болады?#

Негізгі практикалық сұрақ — мазмұнды қайталамай, екі файлды қатар қалай қолдануға болады. Үш сценарий бар:

1-сценарий: тек Claude Code. CLAUDE.md файлын қалдырып, Claude Code-тың барлық мүмкіндігін қолданыңыз: пайдаланушы деңгейіндегі нұсқаулар үшін ~/.claude/CLAUDE.md, жоба үшін CLAUDE.md, жеке баптаулар үшін CLAUDE.local.md, басқа файлдарды қосу үшін @import және арнайы дағдылар үшін .claude/skills/. AGENTS.md қажет емес.

2-сценарий: бірнеше әзірлеу клиенті. Ортақ ережелерді AGENTS.md ішінде сақтап, әр клиентті бөлек қосып тексеріңіз. Gemini CLI контекст файлының атауын баптай алады; Aider файлды оқу баптауы арқылы жүктей алады. Бұл бірдей автоматты табу емес, айқын жүктеу жолдары.

Қауіпсіз сынақ репозиторийінде жаңа сессия ашыңыз. «Сынақ жауабына instructions-loaded маркерін қос» сияқты бірегей зиянсыз ереже беріңіз. Жауаппен бірге клиенттің құжатталған жүктелген файлдар тізімін не журналын қараңыз. Оны әр қолданатын клиент пен нұсқада қайталаңыз. Модельдің «файлды оқыдым» деуі тәуелсіз дәлел емес; бір сәтті тексеру басқа барлық құралдың қолдауын дәлелдемейді.

3-сценарий: аралас команда (Claude Code + басқа құралдар). Бұл — 2026 жылы ең жиі кездесетін баптау. AGENTS.md файлын негізгі етіп қойыңыз. Тек Claude Code-қа арналған ережелер болмаса, CLAUDE.md файлын мүлде жасамаңыз: 2.1.277 нұсқасынан бастап жобада CLAUDE.md болмаған жағдайда Claude Code AGENTS.md файлын өзі оқиды. Ондай ережелер болса, CLAUDE.md файлын символдық сілтеме етіңіз немесе @AGENTS.md импорты бар қысқа файл жасаңыз.

Екі файлдың бірін өзгертпес бұрын екеуін де қарап, сақтық көшірмесін жасаңыз. Екеуі бар болса, қайшы келмейтін ортақ нұсқауларды AGENTS.md ішіне біріктіріп, Claude-қа тән нұсқауларды @AGENTS.md импорты бар CLAUDE.md ішінде қалдырыңыз. Бар символдық сілтемелерді алмастырмай сақтаңыз.

Кәдімгі CLAUDE.md файлы үшін AGENTS.md болмаған кезде ғана мына macOS/Linux тексеруі бар нысананы да, бар символдық сілтемені де қайта жазудан бас тартады:

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

Атау сәтті ауыстырылғаннан кейін CLAUDE.md — AGENTS.md файлына символдық сілтеме. AGENTS.md оқитын барлық агент бірдей мазмұнды көреді. CLAUDE.md файлын оқитын Claude Code та символдық сілтеме арқылы сол мазмұнды көреді.

Windows жүйесінде символдық сілтеме жасау үшін Developer Mode (немесе Admin) қажет болуы мүмкін, бұл бүкіл командаға қолайлы болмауы ықтимал. Балама ретінде AGENTS.md файлын импорттайтын қысқа CLAUDE.md жазыңыз:

# CLAUDE.md

@AGENTS.md

## Claude Code-қа тән ережелер

- Арнайы сұраулар үшін .claude/skills/ қолданыңыз
- Skills-пен жұмыс істегенде .claude/skills/INDEX.md файлын қараңыз
- Үлкен өзгерістер алдында Plan Mode қолданыңыз (Shift+Tab)

Claude Code-та бұл синтаксис бір жол арқылы AGENTS.md мазмұнын қосып, төменіне Claude Code-қа тән қосымша нұсқаулар жазуға мүмкіндік береді. Кейін AGENTS.md файлын алып тастағыңыз келсе, импорт жолын ғана өшіріңіз. Бұл қайталап оқуға әкелмейді: Claude Code құжаттамасына сәйкес, ол өздігінен оқи алатын AGENTS.md файлын екі рет жүктемейді.

2026 жылғы көпқұралды командаға арналған негізгі құрылым:

repo-root/
├── AGENTS.md                              # негізгі дереккөзі, ≤150 жол
├── CLAUDE.md                              # тек Claude-қа тән ережелер болғанда: символдық сілтеме → AGENTS.md НЕМЕСЕ @AGENTS.md + қосымша ережелер
├── .cursor/rules/                         # тек Cursor-ға арналған нысаналы өзгерістер
├── .github/copilot-instructions.md        # пайдаланылса, «AGENTS.md файлын қараңыз» деп көрсетіңіз
└── docs/architecture.md                   # AGENTS.md сілтеме беретін егжей-тегжейлі архитектура

CLAUDE.md туралы толығырақ «CLAUDE.md файлын дұрыс баптау жолы» нұсқаулығынан оқыңыз. Агентке неге үлкен нұсқаулық файлы қажет екені жөнінде «Контекст инженериясы дегеніміз не?» мақаласынан оқыңыз.

2026 жылы не өзгерді: AAIF AGENTS.md файлын неге Linux Foundation құрамына қосты?#

2026 жылғы мамырдағы AI кодтау саласындағы басты саяси оқиға тағы бір модельдің шығуы емес, пішімдердің бірігуі болды. Бұрын әр өндірушінің өз ережелер файлы бар еді; бұл өндірушілер үшін ыңғайлы болғанымен, бірнеше құралмен жұмыс істейтін командаларға қиындық туғызды.

2025 жылғы 9 желтоқсандағы баспасөз хабарламасында Linux Foundation үш пішімді біріктіретін Agentic AI Foundation ұйымын жариялады:

• AGENTS.md — OpenAI-ден, агенттерге арналған нұсқаулық файл пішімі
• Model Context Protocol (MCP) — Anthropic-тен, агенттерге сыртқы құралдарды қосу протоколы
• goose — Block-тан, ашық бастапқы кодты агент фреймворкі

Linux Foundation баспасөз релизінен:

«Бұл жобаларды AAIF қолшатырының астына біріктіру олардың тек ашық басқару қамтамасыз ете алатын ашықтық пен тұрақтылық жағдайында дамуына мүмкіндік береді.»

(Linux Foundation баспасөз хабарламасы, 2025 жылғы 9 желтоқсан, ағылшын тілінен аударылған)

2026 жылғы 24 ақпанға қарай AAIF құрамында 146 ұйым болды (екі айда 97 жаңа мүше қосылды). Жаңа Gold мүшелерінің қатарында Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, Hitachi, UiPath, American Express және Autodesk болды. Anthropic MCP-ті ілгерілетіп, Platinum деңгейінде тұр. OpenAI AGENTS.md форматын ілгерілетіп, Platinum деңгейінде тұр. Block goose жобасымен Platinum деңгейінде.

Бұл AGENTS.md-тің орнын өзгертеді: «OpenAI пішімінен» салалық стандартқа айналдырады. 2026 жылғы көктемде Claude Code әлі сыртта болғанымен, қыркүйекте 2.1.277 нұсқасымен AGENTS.md файлын өздігінен оқуды үйренді. CLAUDE.md қолданыстан шыққан жоқ және жобада бар болса, әдепкіде әлі де басымдыққа ие.

Ортақ жоба ережелерін AGENTS.md ішінде сақтау — қолайлы бастапқы нұсқа. Оған әр клиент қажет ететін импортты, орауышты немесе нақты оқу баптауын қосыңыз. Claude Code үшін CLAUDE.md импорты не символдық сілтеме керек пе, шешпес бұрын орнатылған нұсқа мен файлдар басымдығын тексеріңіз. Әр клиентте жүктеуді тексеріңіз; бұл жерде қамту пайызы өлшенген жоқ.

Әрі қарай не болады?#

AGENTS.md — «агентпен қалай келісіп, оның болжамды жұмыс істеуін қамтамасыз етуге болады» дегендегі алғашқы құрылыс блогы. Келесі — жобаның білім қалтасы: онда бизнес контексті, аудитория, өнімдер мен бағалар сақталады. Үшінші бөлік — контекст инженериясы: ол бәрін біріктіріп, агент әр қадамда қандай файлдарды көретінін, сессиялар арасында күйдің қалай сақталатынын және модельдер арасында қалай ауысу керегін анықтайды.

Практикалық материалдар: Ailoot құжаттамасы.

Қосымша материалдар мен құралдар: Ailoot.