AGENTS.md: зачем нужен файл инструкций для AI-разработчика

Короткий ответ: AGENTS.md — это инструкция для AI-разработчика внутри репозитория

AGENTS.md фиксирует правила команды в месте, где AI-агент точно их найдет: как запускать проект, какие команды проверки использовать, что нельзя менять, как оформлять результат и где искать дополнительный контекст.

Какие разделы должны быть в AGENTS.md

• краткое описание проекта и основных модулей;
• команды установки, запуска, тестов и сборки;
• стиль кода и локальные паттерны;
• правила безопасности: секреты, миграции, внешние API;
• как действовать с dirty worktree и чужими изменениями;
• формат финального отчета после задачи.

Пример короткого AGENTS.md

# AGENTS.md

## Project
Laravel + React landing. Public pages live in resources/views, React app in resources/js.

## Commands
- npm run build
- php artisan test

## Rules
- Do not edit .env files.
- Keep SEO metadata in Blade templates.
- For UI changes, preserve existing dark Dev Wraith style.

## Final response
List changed files and checks performed.

Частые ошибки в AGENTS.md

• слишком общие фразы без конкретных команд;
• устаревшие инструкции после переезда проекта;
• секреты, токены и пароли в тексте;
• противоречивые правила в корневом и вложенных файлах;
• отсутствие критериев проверки.

FAQ