AGENTS.md за Grok Build - как да научиш машината да мисли като теб
Агентът без контекст е чист потенциал без посока. 🜂 Сурова изчислителна мощ, която гадае какво искаш и сбърква там, където ти би минал на сляпо. AGENTS.md е законът, който му даваш - конституцията на проекта, записана на език, който и човек, и машина четат еднакво. Сложи я в репото и Grok Build спира да гадае. Започва да изпълнява.
Това не е README.
README е за хората, които идват след теб. AGENTS.md е за машината, която работи вместо теб - и разликата е дали ще ти счупи main branch-а в 3 сутринта, или ще те попита първо.
Какво всъщност прави този файл
Казва на агента как се събужда проектът - старт, билд, тест
Дефинира code style и архитектурата - неговите закони, не неговите догадки
Тегли границата - какво пипа свободно, какво пита, какво е забранена зона
Сваля ентропията. По-малко грешки, повече сигнал
Къде живее
В root-а на проекта, до README.md. Може и nested - по-близкият до текущата директория командва. Grok Build мерджва файловете от git root надолу, като контекст, който се натрупва пласт по пласт. А сложиш ли AGENTS.override.md в дадена папка - той е последната дума за тази територия. 
Локалното правило бие глобалното. Както трябва да бъде.
Code:
cd my-project
touch AGENTS.md
Шаблонът - скелетът, който облечи в своя проект
Bash:
# AGENTS.md - [Име на проекта]
## Project Overview
Next.js 15 + TypeScript + Tailwind + Supabase. Monorepo с Turbo.
Използва Server Actions и React Server Components.
## Key Commands
- Инсталация: pnpm install
- Dev server: pnpm dev
- Build: pnpm build
- Lint: pnpm lint
- Typecheck: pnpm typecheck
- Tests: pnpm test
- Single test: pnpm vitest run path/to/test.ts
## Code Style & Conventions
- Named exports (не default)
- Single quotes, 2 spaces indent
- Tailwind класовете на един ред
- Компонентите в src/components/
- Server Components по подразбиране, Client само при нужда ("use client")
## Non-Obvious Patterns
- Всички API calls връщат { data, error } формат
- Никога не хвърляй exception от API layer - винаги return error object
- Server Actions вместо API routes, където е възможно
## Testing Rules
- Unit + integration тестове за всяка нова функционалност
- Всички тестове deterministic
- Mock-вай всички външни зависимости
- Преди да завършиш задача - пусни pnpm test и pnpm lint
## Boundaries & Rules
### ✅ Винаги може (без да пита)
- Чете файлове и директории
- Пуска lint, typecheck и тестове
- Създава нови файлове в src/
### ⚠️ Пита преди
- Инсталиране на нови пакети
- Промяна на database schema
- Git push или PR
### 🚫 Никога не прави
- Не commit-ва secrets или .env
- Не пипа node_modules/, dist/, .next/
- Не force push към main
## Key Files
- src/app/ - App Router
- supabase/ - миграции и types
- components/ui/ - Shadcn компоненти
## Security
- Винаги валидирай входни данни
- Не log-вай sensitive информация
Кои секции носят тежест
| Секция | Кога е полезна | Пример |
|---|---|---|
| Project Overview | Големи/сложни проекти | Stack + уникални решения |
| Key Commands | Винаги | Точни команди за dev |
| Code Style | Различен от default | Indent, quotes, naming |
| Non-Obvious Patterns |  Сърцето на файла | Специфични архитектурни решения |
| Boundaries | Контрол над агента | Може / пита / забранено |
| Testing Rules | Проекти с тестове | Какво да проверява |
Non-Obvious Patterns е секцията, заради която всичко това има смисъл. Командите ги налучква. Стила го отгатва. Но онова знание, което живее само в главата ти - че API-то никога не хвърля exception, че този хак е там по причина - агентът няма откъде да го знае. Запишеш ли го, спираш да повтаряш едни и същи поправки до безкрай.
Провери дали машината те чува
Да напишеш закон е едно. Да си сигурен, че е прочетен - друго. Пусни:
Code:
grok inspectКомандата отваря очите на агента пред теб - показва точно какво вижда от проекта: AGENTS.md, skills, hooks, MCP servers, всички открити източници на контекст.
Това е sanity check-ът, преди да му дадеш ключовете. Доверявай се, но проверявай. Дисциплината, която отделя сигнала от шума
Кратко - под 150-200 реда. Дълъг файл, който никой не чете, е мъртъв код
Важното най-отгоре. Машината чете отгоре надолу, като всеки от нас
Конкретни примери, не философски абстракции. Тук иронията спира - агентът иска факти
Жив документ. Актуализирай го като код, не като архив
В monorepo - по един AGENTS.md във всяка територия, която има свои закони
Останалата екипировка
AGENTS.md не работи сам - skills, plugins, hooks и MCP servers се вдигат out of the box до него
Plan mode - предпазителят. Агентът ти показва плана, преди да пипне един байт. Одобряваш, коментираш или го пренаписваш. Без изненади
/skillify- превръща цяла сесия в reusable skill. Каквото си научил веднъж, не го учиш пак
/sandbox- изолирана клетка без достъп до хост системата. За когато не вярваш напълно. А ти никога не вярваш напълно
Долната линия
AGENTS.md не прави агента по-умен. Прави го твой. Превръща общия инструмент в колега, който познава терена - твоите команди, твоите правила, твоите граници. Останалото е изпълнение.Машината ще направи точно това, което си ѝ казал. Въпросът е дали си ѝ казал точно. 🜃
Автор: Тони Ангелчовски | Ексклузивно за DTGaraGe Копирането и препубликуването без разрешение не е позволено
Подкрепи проекта: https://dtgarage.eu/donate