2026 жылы Claude Code, Codex және Cursor үшін бір нұсқаулар файлы

Қызмет туралы ақпаратты Ailoot құжаттамасынан қараңыз.

Claude Code, Codex және Cursor-ды бірге қолданғанда не өзгереді?#

Мұнда сипатталған мысалда Claude Code — негізгі құрал, ал Codex пен Cursor нақты тапсырмалар үшін қолданылады. Менің CLAUDE.md файлымда шамамен 250 жол нұсқау бар: нені және қандай ретпен оқу керек, нені өзгертуге болмайды, орналастыру үшін қандай командалар қолдану керек және коммиттерді пішімдеу ережелері. Жобада Codex CLI-ді алғаш сынап көргенімде, ол ережелердің ешқайсысын білмеді: git push --force командасын орындап, .env файлын ақтарып, файлдардың атын ұқыпсыз өзгертті.

Алғашында CLAUDE.md файлын қолмен AGENTS.md етіп көшірдім. Екі аптадан соң жобада бір нұсқаудың төрт нұсқасы барын байқадым: CLAUDE.md, AGENTS.md, .cursorrules және .windsurf/rules/ ішінде. Олардың бәрі аздап ерекшеленетін. Бұл Claude немесе Cursor мәселесі емес; бірнеше ақиқат көзі бар кез келген жүйеге тән негізгі тұзақ. Бұл мәселені көп агентпен жұмыс істеу жөніндегі нұсқаулықта толығырақ талқылаймын.

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

Claude Code AGENTS.md файлын өзі оқи ма?#

2026 жылғы қыркүйекке дейін жауап «жоқ» еді. AGENTS.md қолдауын сұраған #6235 мәселе 2025 жылғы тамыздан бері ашық болып, 2026 жылғы 17 тамызда жабылды. Жады құжаттамасы осы уақыт бойы бір шешім ұсынды: CLAUDE.md жасап, оған AGENTS.md файлын импорттау. 2.1.277 нұсқасынан бастап құжаттамада басқаша жазылған:

Claude Code-тың нақты қай файлдарды оқиханы жоба ішінде қандай файлдар бар екеніне байланысты:

Бұл тексерісте жұмыс каталогындағы және одан жоғарыдағы CLAUDE.md, .claude/CLAUDE.md және CLAUDE.local.md файлдары есепке алынады. Жеке ~/.claude/CLAUDE.md, ұйым басқаратын файл және .claude/rules/ ережелері есептелмейді: олар AGENTS.md файлымен қатар жүктеледі.

CLAUDE.md болмаса, Claude Code іске қосылғанда жұмыс каталогындағы және одан жоғарыдағы барлық AGENTS.md және .claude/AGENTS.md файлдарын оқиды, ал ішкі каталогтағы AGENTS.md файлын сол каталогтағы файлды ашқанда жүктейді. AGENTS.md ішіндегі @path импорттары да жұмыс істейді. Claude Code AGENTS.local.md, AGENTS.override.md файлдарын немесе .agents/ каталогының мазмұнын оқымайды.

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

Мінез-құлық /config ішіндегі Project instructions бөлімінде өзгереді:

CLAUDE.local.md файлын AGENTS.md файлын жоғалтпай сақтау үшін claude-md-and-agents-md параметрін орнатыңыз. Қайталанып оқылмайды: егер AGENTS.md @AGENTS.md жолы немесе символдық сілтеме арқылы әлдеқашан қосылған болса, баптауға қарамастан Claude Code оны екінші рет жүктемейді.

Файлдың жүктелгенін /memory командасымен тексеруге болады: 2.1.280 нұсқасынан бастап тізімде AGENTS.md жолы көрінеді. 2.1.277 нұсқасынан бұрын және кірістірілген agents-md плагині өшірілген сессияларда Claude Code тек CLAUDE.md файлын оқиды, ал /config ішінде Project instructions тармағы болмайды. 2.1.281 нұсқасына дейін Amazon Bedrock арқылы өткен сессиялар мен телеметрия өшірілген сессиялар да осылай жұмыс істеді. Ескі нұсқадан жаңартқаннан кейінгі алғашқы сессияда AGENTS.md жүктелмеуі мүмкін; ол келесі сессиядан бастап жұмыс істейді.

Бір файлдық баптау үшін бұл нені білдіреді? Claude-қа арналған жеке ережелеріңіз болмаса, CLAUDE.md файлын жасамай-ақ қоюға болады: AGENTS.md жеткілікті, оны Claude Code, Codex және Cursor оқиды. Ондай ережелеріңіз болса (қауіпті каталогтарға арналған жоспарлау режимі, дағдылар, хуктар), CLAUDE.md қажет, сонда Claude Code AGENTS.md файлын өздігінен оқымайды. Одан кейін CLAUDE.md ішіне @AGENTS.md жолын қосыңыз; бұл баптау қыркүйекке дейінгідей жұмыс істейді. Ескі Claude Code нұсқаларына да көмектеседі. Төменде толығырақ түсіндіремін.

@AGENTS.md файлын CLAUDE.md ішіне қалай импорттауға болады?#

Ресми құжаттамадан алынған ең аз жұмыс үлгісі:

@AGENTS.md

## Claude Code

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

Мұнда мынадай әрекет болады. Бірінші жол — @AGENTS.md импорт директивасы. Claude Code сессия басталғанда CLAUDE.md файлын талдап, осы импортты тауып, оның орнына AGENTS.md файлының толық мазмұнын қояды. Одан кейінгі ## Claude Code тақырыбы — жай ғана Markdown, бірақ «Claude-қа арналған қосымша ережелер» бөлімі ретінде қызмет етеді. Оның астында тек Claude Code-қа қатысты ереже бар: billing каталогындағы өзгерістер үшін жоспарлау режимін қолдану. Codex CLI мен Cursor бұл файлды ашпайды; олар жай AGENTS.md файлын пайдаланады.

Импорттардың қалай жұмыс істейтіні туралы құжаттамадан үзінді:

Бірнеше практикалық жайт:

• Салыстырмалы және абсолют жолдар. @AGENTS.md импорт тұрған файлға қатысты жолды білдіреді. @/Users/me/shared/rules.md немесе @~/.claude/personal.md — абсолют жолдар. Мен репозиторийге қосқым келмейтін жеке қалауларымды @~/.claude/personal.md файлына жазамын.
• Төрт деңгей тереңдік. AGENTS.md файлы @docs/coding-style.md файлын, ал coding-style.md тағы бір файлды төрт деңгейге дейін импорттай алады. Бұл кез келген нақты құрылымға жеткілікті.
• Кері тырнақшалар импортты бөгейді. Мәтінде `@README` тұрса, бұл атауды ғана атайды, импорттамайды. Импорттың өзін іске қоспай, оқырмандарға оның қалай жұмыс істейтінін түсіндіруге бұл ыңғайлы.
• Жобадан тыс файлдарды мақұлдау. Импорт жұмыс каталогынан тыс жерге, мысалы @~/.claude/personal.md файлына сілтесе, Claude Code бұл файлдарды бірінші ретте тізімдейтін диалог көрсетеді. Бас тартсаңыз, сыртқы импорттар өшіріліп, диалог қайта шықпайды. Жоба түбіріндегі @AGENTS.md диалогты аштырмайды. Бұл қатысы жоқ файлдың контекстке кездейсоқ жүктелуінен қорғайды.

Сипатталған жобада осы баптауға көшкен соң CLAUDE.md 250 жолдан 60 жолға дейін қысқарды: @AGENTS.md және тек Claude Code-қа қатысты бес-жеті ереже (қауіпті каталогтардағы жоспарлау режимі, әкімші аймағында нені өзгертпеу керек, коммиттерді қалай тұжырымдау керек). Ортақ ережелердің бәрі Codex пен Cursor оқитын AGENTS.md файлында тұрады.

Символдық сілтемені қашан, ал импортты қашан таңдау керек?#

Құжаттамада символдық сілтеме тәсілі былай көрсетілген:

ln -s AGENTS.md CLAUDE.md

Одан кейін Windows туралы ашық ескерту бірден беріледі:

Салыстыру кестесі:

Сипатталған жобада мен импорттарды қолданамын. Себептері:

1. Команда аралас. Мен Mac қолданамын; мысалдағы команданың шамамен жартысы Windows, жартысы Mac қолданады. Репозиторийде символдық сілтеме болса, Developer Mode жоқ Windows қолданушылары оны AGENTS.md деген бір жолы бар кәдімгі мәтіндік файл ретінде шығарып алады. Бұл оғаш қателер туғызады: кейде ережелер жұмыс істейді, кейде істемейді, себебі түсініксіз.
2. Claude-қа ғана арналған ережелер қажет. @AGENTS.md жолынан кейін менің CLAUDE.md файлымда «Claude Code» бөлімі бар: архитектура тапсырмаларына --effort high қолданыңыз, git push алдында npm run build іске қосыңыз және /api/v1/deploy командасын қолмен шақырмаңыз. Codex бұл командаларды түсінбейді.
3. Мәселені жөндеу оңай. Бірдеңе дұрыс болмаса, CLAUDE.md файлын ашып, импорт пен үстінен қосқан ережелерімді көремін. Символдық сілтемеде «мұны осында қостық» деген белгі жоқ. Claude Code баптауларын жөндеу туралы қосымша ақпаратты қауіпсіз режим жөніндегі нұсқаулықтан қараңыз.

Claude-қа арнайы ережелер болмаса, 2.1.277 нұсқасынан бастап символдық сілтеме қажет емес: CLAUDE.md файлын жойсаңыз, Claude Code AGENTS.md файлын өзі оқиды. Тек командада 2.1.277 нұсқасынан ескі нұсқаны қолданып, жаңарта алмайтын адам болса, символдық сілтемені сақтаңыз. Claude-қа арнайы ережелеріңіз болса, он жағдайдың тоғызына импорт ыңғайлырақ.

Codex, Cursor, Copilot, Windsurf және Gemini CLI нені оқиды?#

Жеті негізгі құралдың картасы (әр құралдың ресми құжаттамасы негізінде):

Бұдан қандай қорытынды шығады? Репозиторийде AGENTS.md (және Claude-қа арналған ережелер қажет кезде импорт қосылған CLAUDE.md) болса, жеті құралдың бесеуі жаңа нұсқауларды автоматты түрде алады. Өз файлдары бар Cursor мен Windsurf-ті сол күйінде қалдыруға болады (AGENTS.md файлын олар да оқиды) немесе @AGENTS.md импортын қосуға болады, бірақ синтаксисі әртүрлі және барлық жерде бірдей қолдау жоқ.

Жаңа жоба үшін ең қарапайым стратегия:

1. Барлық ортақ ережені AGENTS.md файлына жазыңыз — ережелердің 95%-ы сонда болуы керек.
2. Тек Claude-қа арналған ережелер қажет болса, CLAUDE.md жасаңыз: бірінші жолға @AGENTS.md жазыңыз, одан кейін Claude-қа ғана арналған ережелері бар бөлім қосыңыз. Ондай ережелер болмаса, CLAUDE.md қажет емес; Claude Code 2.1.277 нұсқасынан бастап AGENTS.md файлын өзі оқиды.
3. Сирек кездесетін Cursor-ға арнайы жағдайларда .cursor/rules/ каталогын сақтаңыз (оның @Codebase және @Docs командалары үшін).
4. Windsurf үшін де солай істеңіз: ескі .windsurfrules файлын ұмытып, синтаксисіне арнайы үлгілер қажет болғанда ғана жаңа .windsurf/rules/ каталогын қолданыңыз.

Бұл тәсіл жұмыстың 20%-ына 80% пайда береді. Менің тәжірибемде аралас командаларды реттегенде, ақиқат көздерінің санын екіден асырсаң (ортақ ережелер және Claude-қа арналған ережелер), күтіп ұстау қиынға соғады. Командадан біреу .cursorrules файлына ереже қосып, AGENTS.md файлын жаңартуды ұмытса, бір аптадан кейін Cursor мен Codex бір-біріне қайшы жауап береді.

Claude Code ішіндегі /init бар AGENTS.md файлын қалай пайдаланады?#

Anthropic құжаттамасында /init былай сипатталған:

Бұл тәжірибеде нені білдіреді? Сипаттаған репозиторийімде Cursor-ды сынаған кезімнен қалған .cursorrules (шамамен 80 жол) және қолмен жинақталған AGENTS.md (120 жол) болды. claude /init командасын іске қосқанда, ол екі файлды да алып, ұқсас ережелердің қайталануын жойып, бір минутта таза CLAUDE.md құрастырды. Одан кейін тексеріп, ескірген тармақтарды алып тастап, тақырыптары бар құрылым қостым. Бұл бәрін қайтадан жазғаннан жылдамырақ болды.

/init ішінде AGENTS.md файлы да оқылатын интерактивті режим қоршаған орта айнымалысы арқылы қосылады:

CLAUDE_CODE_NEW_INIT=1 claude

/init басталған соң Claude нақтылайтын бірнеше сұрақ қояды: қай материалдарды баптау керек (CLAUDE.md, дағдылар, хуктар), жоба қандай стек қолданады және тесттерге қандай командалар керек. Содан кейін қосалқы агент код базасын зерттеп, package.json, README.md және конфигурация файлдарын оқып, жетіспейтін бөліктерді толтырады. Соңында сақтар алдында өңдеуге болатын ұсыныс көрсетеді. Жобаны бастағанда Claude Code-ты баптау туралы қосымша ақпаратты бөлек нұсқаулықтан қараңыз.

Енді кемшілігіне көшейік. Егер жобада AGENTS.md файлы бар болса, /init ондағы ережелердің көшірмесі бар CLAUDE.md файлын жасайды. Осы сәттен бастап Claude Code әдепкіде тек CLAUDE.md файлын оқиды, сондықтан ақиқат көздері қайтадан екеу болады: сіз AGENTS.md файлын жаңартасыз, ал Claude ескі көшірмемен жұмысын жалғастырады. /import командасы да осыған ұқсас: ол AGENTS.md файлын бір рет көшіріп, CLAUDE.md файлының соңына қосады. Бір ғана ақиқат көзін сақтау үшін /init аяқталғаннан кейін CLAUDE.md файлының бірінші жолына @AGENTS.md импортын қойып, AGENTS.md мазмұнын қайталайтын бөліктерді CLAUDE.md файлынан алып тастаңыз.

/init — жаңа жобаға немесе Cursor не Copilot-тан көшіріп жатқан жобаға дұрыс бастама. «Ең жақсы CLAUDE.md үлгісін» интернеттен іздеудің қажеті жоқ: Anthropic репозиторийдегі бар материалды ескереді. Жобада белсенді AGENTS.md бар болып, Claude-қа арналған жеке ережелер болмаса, /init қажет емес: Claude Code AGENTS.md файлын өзі оқиды.

Ортақ және Claude-қа арналған нұсқауларды қалай ажыратуға болады?#

Оларды осы қағида бойынша ажыратамын. AGENTS.md файлына жазылатын ортақ ережелер:

• Кодтың қай жеріне тимеу керек. .env, node_modules, prisma/migrations каталогтары (тек prisma migrate арқылы), .next/, .git/.
• Атауларды қалай беру керек. Тармақтар: feat/, fix/, chore/. Коммиттер: feat:, fix:, docs: префикстері және қысқаша сипаттама. Компонент файлдарының атауы kebab-case пішімінде.
• Тест/линт командалары. npm run build, npm run lint, npm test. git push алдында қай команданы іске қосу керек.
• Архитектуралық қағидалар. src/lib/ ішіне не орналасады, src/components/ ішіне не орналасады, бизнес логикасы мен интерфейс қайда тұрады.
• Қауіпсіздік. Құпия деректерді ешқашан коммиттемеңіз. Өндірістік дерекқорға тек prod-psql арқылы кіріңіз. Өндірістік ортаға SSH арқылы тек prod бүркеншік атымен қосылыңыз, root@IP қолданбаңыз.

CLAUDE.md файлына (@AGENTS.md импортынан кейін) жазылатын Claude-қа арнайы ережелер:

• Жоспарлау режимі. Қауіпті каталогтардағы өзгерістерге (мысалы, src/billing/) plan mode қолданыңыз.
• Күш деңгейі. Архитектура тапсырмаларына --effort high, күнделікті жұмысқа medium қолданыңыз.
• Дағдылар. Әр жағдайда қандай AI агенттерін және дағдыларды іске қосу керегін көрсетіңіз. Мысалы: «нұсқаулықпен жұмыс істегенде build-masterskaya-guide дағдысын іске қосыңыз».
• Claude жады. Автоматты жадыға және CLAUDE.local.md файлына нені жазу керек. Claude жады туралы қосымша ақпаратты Memory және CLAUDE.md жөніндегі нұсқаулықтан қараңыз.
• Хуктар. Егер .claude/settings.json файлында хуктар бапталған болса, CLAUDE.md ішінде олардың не істейтінін сипаттаңыз (Codex пен Cursor олар туралы білмейді, әрі білудің қажеті жоқ).
• Дағдылар мен командалар. Жиі қолданатын slash командаларының тізімі (/init, /cd, /memory, /plan).

Шекара әрдайым анық емес. Мысалы, «main тармағына git push --force командасын ешқашан қолданба» — ортақ ереже, сондықтан AGENTS.md файлына жатады. Ал «жедел тармаққа git push жасағанда алдымен жоспарлау режимін қолдан» деген ереже Claude Code-қа ғана тән, сондықтан CLAUDE.md файлына жатады. Тексеру тәсілі: «Ертең Claude Code-ты алып тастап, тек Codex-ті қалдырсам, бұл ереже әлі де қолданыла ма?» Иә болса, AGENTS.md файлына жазыңыз. Жоқ болса, CLAUDE.md файлына жазыңыз.

AGENTS.md, CLAUDE.md немесе .claude/rules файлдарына не жатады?#

Ережелер 200 жолдан асса, оларды бөліп шығаратын уақыт келді. Anthropic құжаттамасы әр файлды 200 жол шамасында ұстауды ұсынады, себебі ұзын CLAUDE.md файлдарындағы ережелерді Claude бірте-бірте сирек орындай бастайды: оқитын сияқты көрінгенімен, оларды азырақ ұстанады.

Үлкен жобаға мен қолданатын құрылым:

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/ ішіндегі әр файлдың frontmatter бөлімі мынадай болуы мүмкін:

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

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

Claude бұл ережелерді тек осы үлгіге сәйкес файлдармен жұмыс істегенде жүктейді. Егер src/components/Button.tsx файлын өзгертсе, API ережелері контекстке қосылмайды. Осылайша контекст терезесінің орны тек қажет нәрсеге жұмсалады. Жобада тек AGENTS.md болса да .claude/rules/ каталогы жұмыс істейді: оның ережелері онымен қатар жүктеліп, AGENTS.md файлын тікелей оқуды өшірмейді.

Cursor мен Windsurf та осы тәсілді өздерінің .cursor/rules/ және .windsurf/rules/ каталогтары арқылы қолдайды. AGENTS.md стандарты бұл каталогтарға сілтеме жасай алады, бірақ құралдар арасында қолданылатын синтаксис әлі толық тұрақтанбаған. Ортақ ережелерді AGENTS.md ішінде сақтап, жолға тәуелді ережелерді .claude/rules/ және .cursor/rules/ ішінде қайталау қауіпсізірек: бұлар жаппай қолданылатын ережелер емес, сирек кездесетін арнайы жағдайлар.

CLAUDE.md үшін пайдалы орындар (ең кең ауқымнан ең тар ауқымға қарай):

Мысалы, ~/.claude/CLAUDE.md файлында екі ереже болуы мүмкін: «пайдаланушы қалаған тілде жауап бер» және «Ailoot атауын дәл осылай жаз». Бұл ережелер әр жобаға қолданылады, сондықтан оларды әр репозиторийде қайталау қажет емес.

Осы төрт деңгейдің ішінен тек жоба деңгейіндегі CLAUDE.md және CLAUDE.local.md файлдары AGENTS.md файлын тікелей оқуға кедергі жасайды. Жеке ~/.claude/CLAUDE.md мен басқарылатын саясат кедергі келтірмейді: Claude Code оларды AGENTS.md файлымен қатар оқиды.

Жобаңыздағы AGENTS.md ескіріп кетсе не істеу керек?#

Сипатталған жобада менде 2025 жылғы мамырдан қалған AGENTS.md болды — 180 жол, көбісі ескірген (ол кезде өзгерген Anthropic API эндпоинттері аталған; енді жоқ claude --tools синтаксисімен мысалдар берілген; құрылымы ескірген ~/.claude/projects/ туралы ережелер болған).

Оны жаңарту үшін мына жоспарды қолдандым:

1. claude арқылы жоспарлау режимінде қарап шығу. Репозиторийді ашып, claude --safe-mode командасын іске қосамын да, мынаны сұраймын: “AGENTS.md файлын қайта оқып, ескірген немесе қайталанатын тармақтардың тізімін ұсын. Оны өңдеме; тек тізімде.” Екі минутта қарап шығуға арналған 23 тармақ тізімін алдым.
2. Айқын ескірген тармақтарды алып тастау. 23 тармақтың 9-ы анық ескірген еді — команда синтаксисі, эндпоинттер және жалау атаулары. Сол жолдарды өшірдім.
3. Қайталанатындарын біріктіру. Тағы 6 тармақ әртүрлі сөздермен бір нәрсені қайталады («мәжбүрлеп push жасама», «--force командасын ешқашан қолданба», «git push -f командасынан аулақ бол»). Оларды бір жолға біріктірдім.
4. Жаңа тармақтар қосу. Соңғы айда Claude/Codex жиі қате жасағанын байқаған нәрселерді «әр қате үлгісіне бір жол» ережесін ұстанып қостым. Нәтижесінде 8 жаңа тармақ шықты.
5. Соңғы шолуға қосалқы агент жіберу. Claude-тан «қайшылықтар, екіұштылықтар және қайталанатын тармақтарды тап» деп шолуды сұрадым. Ол анықырақ етуге болатын үш тұжырым тапты. Оларды түзедім.

Бір сағаттан кейін AGENTS.md 110 жол болды, өзекті еді, әрі әр жолын өзім жақсы білетінмін. Оның негізінде 30 жолдық CLAUDE.md жасау оңай болды. Одан кейін Codex-тің тесттерге қатысты мұқияттығы да айтарлықтай артты — оның кейбір «оғаш» шешімдері ескірген нұсқауларды адал орындағаннан болған шығар деп ойлаймын.

Үнемі жаңарып отыратын AGENTS.md негізгі қағидалары:

• Әр ереже қайталанатын қатеге жауап береді. Егер бір ай бойы бір ереже есіме түспесе, оны сақтаудың мәні жоқ.
• Ережелерді теория емес, нұсқау түрінде жазыңыз. «Екі бос орын қолданыңыз» — ереже. «Код стилі ұқыпты болсын» — ереже емес.
• Нақты нұсқау жалпы сөзден маңызды. «git push алдында npm run build іске қос» — ереже. «Өзгерістерді тексер» — емес.

Бұл баптауда нақты не ЖҰМЫС ІСТЕМЕЙДІ?#

Осы баптаумен алты ай жұмыс істеп, қиын жолмен үйренген бірнеше жайт:

1. Cursor автотолықтыруы AGENTS.md файлын қолданбайды. Cursor редакторда жолды толықтыруды ұсынғанда, AGENTS.md файлын нақты уақыт режимінде оқымайды — бөлек жылдам механизм жұмыс істейді. AGENTS.md ішіндегі ережелер Cursor чатына сұрау жібергенде ғана маңызды. Сондықтан AGENTS.md ішіне «var қолданба, const қолдан» деп жазу автотолықтыруға әсер етпейді; мұны ESLint немесе TypeScript конфигурациясы арқылы баптау керек.

2. AGENTS.md ішіндегі Claude Code хуктары Codex үшін жұмыс істемейді. Егер .claude/settings.json ішінде белгілі бір әрекетті бұғаттайтын PreToolUse хугы бапталса, бұл ақпарат тек Claude-қа пайдалы. Codex хуктар туралы білмейді; ол үшін «құрал өз бетінше шешеді» дегендей. Сондықтан «X жасама» деп AGENTS.md ішіне, ал «X әрекетін физикалық түрде бұғаттайтын хук бар» деп импорттан кейінгі CLAUDE.md ішіне жазған жөн.

3. Copilot және .github/copilot-instructions.md. GitHub Copilot өз файлын оқиды және әлі де AGENTS.md файлын дұрыс оқымайды. Командаңыз Copilot-ты белсенді қолданса, ережелердің ықшам нұсқасы бар бөлек .github/copilot-instructions.md файлын жасаңыз немесе AGENTS.md файлын түсінетін Copilot Extensions пайдаланыңыз. Бұл тез өзгеріп жатыр, сондықтан үш-алты айдан кейін жағдай басқаша болуы мүмкін.

4. Git символдық сілтемені CLAUDE.md файлына жасалған өзгеріс ретінде қадағаламайды. ln -s AGENTS.md CLAUDE.md командасын орындап, бір аптадан соң AGENTS.md файлын жаңартсаңыз, Git тек AGENTS.md үшін diff көрсетеді. Бұл қалыпты жағдай, бірақ PR-ды қарайтын әріптесіңіз CLAUDE.md файлының да жаңартылғанын (символдық сілтеме арқылы) байқамауы мүмкін. Шешімі: PR сипаттамасында «AGENTS.md файлы жаңартылды; Claude Code сол файлды символдық сілтеме арқылы көреді» деп нақты жазыңыз.

5. Терең импорттарды жөндеу қиын. Егер AGENTS.md @docs/coding-style.md файлын импорттап, ол @docs/typescript.md файлын импорттаса, ережелер қайшы келген жағдайда жөндеу қиын. Мен импорттарды бір деңгеймен шектеймін (CLAUDE.md → AGENTS.md) және әрі қарай кірістірмеймін. Anthropic қай файлдар жүктелгенін тіркейтін InstructionsLoaded хугы ұсынады — қабатталған баптауларды жөндеуге пайдалы. Ескерту: бұл хук импорт немесе символдық сілтеме арқылы қосылған AGENTS.md үшін іске қосылады, бірақ Claude Code өзі оқыған AGENTS.md үшін іске қосылмайды.

Кешке арналған vibe coding-тің толық баптауы: AI көшірмесі + Екінші ми + контекст инженериясы.

Ailoot сайтына өтіңіз.