Код бүрийн эхэнд "AGENTS.md": AI агентуудад зориулсан "README for Machines" нээлттэй стандарт эрчээ авч байна

Программ хангамж хөгжүүлэлтийн ертөнцөд шинэ репозитор (repo) нээх бүрд README.md файл үүсгэдэг нь бичигдээгүй хууль билээ. Энэ файл нь шинээр ирсэн инженер, хамтран ажиллагсдад төслийн бүтэц, хэрхэн ажиллуулах, тестлэх удирдамжийг өгдөг.

Гэвч сүүлийн саруудад кодын сантай ажилладаг гол "хамтрагч" нь зөвхөн хүн биш, харин Claude Code, Cursor, GitHub Copilot, OpenAI Codex зэрэг бие даасан AI агентууд болж хувирав. Ингэснээр хэрэгсэл бүрт зориулж .cursorrules, CLAUDE.md, .github/copilot-instructions.md гэх мэт тусдаа тохиргооны файлууд үүсгэх эмх замбараагүй байдал үүсээд байсан юм.

Энэхүү асуудлыг нэг мөр цэгцлэхээр салбарын томоохон компаниуд нэгдэн бүтээсэн AGENTS.md стандарт Linux Foundation-ий удирдлага дор нээлттэй эхээр өргөжиж, богино хугацаанд 60,000 гаруй нээлттэй эхийн репозиторуудад албан ёсоор нэвтрээд байна.

Тохиргооны талцлыг зогсоох "Нэгдмэл хэл"

Өмнө нь хөгжүүлэгчид ямар AI хэрэгсэл ашиглаж байгаагаасаа шалтгаалан өөр өөр форматтай context файл үүсгэдэг байв. Энэ нь багийн гишүүд өөр өөр агент (жишээ нь нэг нь Cursor, нөгөө нь Claude Code) ашиглах үед агентуудын ажиллах заавар зөрөх, оновчгүй код бичих гол шалтгаан болдог байв.

AGENTS.md бол яг л төслийн README.md шиг 엔гийн Markdown форматтай боловч зөвхөн AI агентуудын ойлгох контекст, төслийн далд дүрмүүдийг (tribal knowledge) төвлөрүүлдэг стандарт юм.

OpenAI, Anthropic, Google, Cursor зэрэг багуудын хамтын ажиллагааны үр дүнд гарч ирсэн тус стандартыг одоо Linux Foundation-ий дэргэдэх Agentic AI Foundation (AAIF) хариуцан хөгжүүлж байна.

AI агентууд эх кодоос юуг "тааж" чаддаггүй вэ?

Орчин үеийн LLM-үүд төслийн кодын бүтцийг уншиж, аль хэлийг ашиглаж байгааг төвөггүй мэддэг. Гэвч тэдний алдаа гаргадаг гол шалтгаан нь файлын цаана нуугдсан төслийн тусгай хязгаарлалтууд байдаг:

Далд хамаарал: Жишээлбэл, хоёр салангид package хоорондоо хамааралгүй мэт харагдах боловч архитектурын хувьд шууд импорт хийхийг хориглосон байх.
Тусгай Build/Validation дараалал: Энгийн npm test биш, тодорхой integration тест эсвэл lint командыг заавал ажиллуулж байж PR гаргах ёстой гэх мэт заавар.
Автоматаар үүсгэгддэг (Generated) кодууд: Агент дур мэдэн засварлаж болохгүй ORM migration эсвэл protobuf-ын файлууд.

AGENTS.md нь чухам эдгээр асуултад товч, тодорхой хариулт өгч, агентыг анхны үйлдлээсээ зөв чиглэлд ажиллах нөхцөлийг бүрдүүлдэг.

AGENTS.md файлын бүтэц ямар байдаг вэ?

AGENTS.md нь хатуу JSON эсвэл YAML схем шаардахгүй. Хүний уншихад болон LLM-ийн задлан шинжлэхэд (parse) хамгийн тохиромжтой 엔гийн Markdown бүтцээр бичигддэг.

Ихэвчлэн дараах 4 үндсэн хэсгийг агуулна:

# Project Context for AI Agents

## 1. Environment & Setup
- Node.js version: v22.x
- Package manager: pnpm (do not use npm/yarn)

## 2. Build & Test Commands
- Build command: `pnpm build`
- Run local unit tests: `pnpm test:unit`
- Validation rule: Before finishing any task, run `pnpm typecheck` and fix all typing errors.

## 3. Code Architecture & Rules
- Do not edit files inside `/src/generated/` directly.
- All database queries must go through the repository layer under `/src/repositories/`.
- Use TypeScript strict mode everywhere.

## 4. Git & PR Conventions
- Branch naming: `feat/issue-number-short-desc`
- Commit format: Conventional Commits (`feat:`, `fix:`, `refactor:`)

Monorepo болон олон түвшний дэмжлэг

Томоохон бүтэцтэй Monorepo төслүүдэд төслийн root хавтсанд AGENTS.md байхаас гадна дэд хавтас (microservices, sub-packages) бүрт өөрийн AGENTS.md-ийг байршуулах боломжтой.

Агент тодорхой дэд хавтасны файлтай ажиллах үед хамгийн ойр байрлах AGENTS.md файлын дүрмийг давуу эрхтэйгээр баримталдаг (Hierarchical precedence) архитектуртай. Энэ нь frontend болон backend нь тэс өөр технологийн стек, өөр линт дүрмүүдтэй багуудад маш том давуу тал олгож байна.

Хөгжүүлэгчид юунд анхаарах ёстой вэ?

README-тэй бүү холь: Хүнд зориулсан маркетинг, суулгах урт заавруудыг README дээрээ үлдээж, агентад зөвхөн түүний шийдвэр гаргалтад нөлөөлөхүйц товч, бодит дүрмүүдийг AGENTS.md-д бич.
Токен хэмнэлт: AGENTS.md хэт урт байх тусам агент бүрийн prompt контекстэд илүү токен үрж, зардал нэмэгддэг. Зайлшгүй чухал хязгаарлалтуудыг bullet-point хэлбэрээр бичих нь хамгийн үр дүнтэй.
Хуучин файлуудаа цэгцэл: Хэрэв та одоог хүртэл .cursorrules эсвэл тусдаа тохиргоо ашиглаж байсан бол төслийнхөө root хавтсанд AGENTS.md үүсгэж шилжүүлэхийг зөвлөж байна.

AI хөгжүүлэлт ердөө чатлах төдий байснаа больж, бүрэн бие даасан систем болон хувирч буй энэ үед AGENTS.md нь хүн болон машины хамтын ажиллагааны шинэ гүүр болж байна.

Эх сурвалж: Agentic AI Foundation (Linux Foundation), GitHub Engineering Blog, Hacker News Tech Community