sync

AGENTS.md

@@ -1,11 +1,29 @@
-# AGENTS.md — правила для агента
+# AGENTS.md
 
-## Frontend-разработка
+Этот файл является коротким маршрутизатором по документации агента.
 
-Если задача связана с frontend-разработкой, агент должен писать код по правилам из:
+## Порядок работы
 
-👉 [ai/nextjs-style-guide/DEVELOP.md](./ai/nextjs-style-guide/DEVELOP.md)
+Перед началом работы агент обязан определить свою роль в таком порядке:
 
-Если правило конфликтует с текущим проектом, стеком или фреймворком, приоритет имеет корректная реализация для фактически используемого фреймворка.
+1. Если пользователь явно указал роль в запросе — использовать её.
+2. Если доступна переменная окружения `AGENT_ROLE` — использовать её значение.
+3. Если пользователь не указал роль и `AGENT_ROLE` пуста — использовать роль `developer`.
 
-Next.js-специфичные правила применяются только в Next.js-проектах.
+Агент не должен читать `.env` ради определения роли. В CI роль передаётся через переменную окружения `AGENT_ROLE`.
+
+Допустимые роли:
+
+- `developer` — реализация задач, исправление багов, рефакторинг, настройка проекта.
+- `reviewer` — ревью кода, поиск ошибок, рисков и регрессий.
+- `architect` — проектирование архитектуры, модулей, слоёв и технических решений.
+
+Если определена неизвестная роль, агент обязан сообщить об ошибке конфигурации и уточнить дальнейшие действия.
+
+После определения роли агент обязан открыть соответствующую инструкцию:
+
+- `developer` → [DEVELOP.md](./ai/nextjs-style-guide/DEVELOP.md)
+
+Если для определённой роли нет отдельной инструкции, агент обязан сообщить об этом пользователю и уточнить дальнейшие действия.
+
+`AGENTS.md` не содержит правил разработки, ревью или архитектуры. Все правила находятся в документации соответствующей роли.