2026-05-12 07:54:32 +03:00
|
|
|
|
# AGENTS.md
|
2026-05-05 14:05:43 +03:00
|
|
|
|
|
2026-05-12 07:54:32 +03:00
|
|
|
|
Этот файл является коротким маршрутизатором по документации агента.
|
2026-05-05 14:05:43 +03:00
|
|
|
|
|
2026-05-12 07:54:32 +03:00
|
|
|
|
## Порядок работы
|
2026-05-05 14:05:43 +03:00
|
|
|
|
|
2026-05-12 07:54:32 +03:00
|
|
|
|
Перед началом работы агент обязан определить свою роль в таком порядке:
|
2026-05-05 14:05:43 +03:00
|
|
|
|
|
2026-05-12 07:54:32 +03:00
|
|
|
|
1. Если пользователь явно указал роль в запросе — использовать её.
|
|
|
|
|
|
2. Если доступна переменная окружения `AGENT_ROLE` — использовать её значение.
|
|
|
|
|
|
3. Если пользователь не указал роль и `AGENT_ROLE` пуста — использовать роль `developer`.
|
2026-05-05 14:05:43 +03:00
|
|
|
|
|
2026-05-12 07:54:32 +03:00
|
|
|
|
Агент не должен читать `.env` ради определения роли. В CI роль передаётся через переменную окружения `AGENT_ROLE`.
|
|
|
|
|
|
|
|
|
|
|
|
Допустимые роли:
|
|
|
|
|
|
|
|
|
|
|
|
- `developer` — реализация задач, исправление багов, рефакторинг, настройка проекта.
|
|
|
|
|
|
- `reviewer` — ревью кода, поиск ошибок, рисков и регрессий.
|
|
|
|
|
|
- `architect` — проектирование архитектуры, модулей, слоёв и технических решений.
|
|
|
|
|
|
|
|
|
|
|
|
Если определена неизвестная роль, агент обязан сообщить об ошибке конфигурации и уточнить дальнейшие действия.
|
|
|
|
|
|
|
|
|
|
|
|
После определения роли агент обязан открыть соответствующую инструкцию:
|
|
|
|
|
|
|
|
|
|
|
|
- `developer` → [DEVELOP.md](./ai/nextjs-style-guide/DEVELOP.md)
|
|
|
|
|
|
|
|
|
|
|
|
Если для определённой роли нет отдельной инструкции, агент обязан сообщить об этом пользователю и уточнить дальнейшие действия.
|
|
|
|
|
|
|
|
|
|
|
|
`AGENTS.md` не содержит правил разработки, ревью или архитектуры. Все правила находятся в документации соответствующей роли.
|
