# AGENTS.md

Этот файл является коротким маршрутизатором по документации агента.

## Порядок работы

Перед началом работы агент обязан определить свою роль в таком порядке:

1. Если пользователь явно указал роль в запросе — использовать её.
2. Если доступна переменная окружения `AGENT_ROLE` — использовать её значение.
3. Если пользователь не указал роль и `AGENT_ROLE` пуста — использовать роль `developer`.

Агент не должен читать `.env` ради определения роли. В CI роль передаётся через переменную окружения `AGENT_ROLE`.

Допустимые роли:

- `developer` — реализация задач, исправление багов, рефакторинг, настройка проекта.
- `reviewer` — ревью кода, поиск ошибок, рисков и регрессий.
- `architect` — проектирование архитектуры, модулей, слоёв и технических решений.

Если определена неизвестная роль, агент обязан сообщить об ошибке конфигурации и уточнить дальнейшие действия.

После определения роли агент обязан открыть соответствующую инструкцию:

- `developer` → [DEVELOP.md](./ai/nextjs-style-guide/DEVELOP.md)

Если для определённой роли нет отдельной инструкции, агент обязан сообщить об этом пользователю и уточнить дальнейшие действия.

`AGENTS.md` не содержит правил разработки, ревью или архитектуры. Все правила находятся в документации соответствующей роли.