44 lines
3.4 KiB
Markdown
44 lines
3.4 KiB
Markdown
|
# AGENTS.md
|
|||
|
|
|
|||
|
|
Это корневой диспетчер. Он определяет твою роль и отправляет тебя к твоему файлу инструкций. Дальше ты работаешь **строго** по нему.
|
|||
|
|
|
|||
|
|
## Жёсткие правила
|
|||
|
|
|
|||
|
|
1. Прочитай **только** файл своей роли из таблицы ниже.
|
|||
|
|
2. Не читай файлы других ролей. Не читай `ai/` рекурсивно «для контекста».
|
|||
|
|
3. Внутри файла роли есть свои обязательные разделы, прикладные разделы и триггеры — следуй его внутреннему протоколу, не додумывай свой.
|
|||
|
|
4. Дополнительные файлы из `ai/` читай **только** когда на них явно ссылается твой файл роли или сработавший триггер.
|
|||
|
|
|
|||
|
|
## Определение роли
|
|||
|
|
|
|||
|
|
Роль определяется в таком порядке:
|
|||
|
|
|
|||
|
|
1. Переменная окружения `AI_ROLE`.
|
|||
|
|
2. Явное указание в первом сообщении пользователя («работай как developer», «ты reviewer» и т.п.).
|
|||
|
|
3. Если ни того, ни другого нет — **остановись и спроси**. Не выбирай роль сам.
|
|||
|
|
|
|||
|
|
## Карта ролей
|
|||
|
|
|
|||
|
|
| Роль | Файл инструкций | Назначение |
|
|||
|
|
|--------------|-------------------|-----------------------------------------------|
|
|||
|
|
| `developer` | `ai/DEVELOP.md` | Написание и редактирование кода проекта |
|
|||
|
|
| `reviewer` | `ai/REVIEW.md` | Код-ревью, проверка на соответствие стайлгайду |
|
|||
|
|
| `architect` | `ai/ARCHITECT.md` | Проектирование модулей, слоёв, API |
|
|||
|
|
| ... | ... | ... |
|
|||
|
|
|
|||
|
|
> Оставь в таблице только те роли, которые реально существуют в `ai/`.
|
|||
|
|
|
|||
|
|
## Протокол запуска
|
|||
|
|
|
|||
|
|
1. Определи роль (см. выше).
|
|||
|
|
2. Открой соответствующий файл из таблицы — это твой единственный источник истины.
|
|||
|
|
3. Выполняй его внутренний протокол: сначала обязательные правила, затем прикладные разделы и триггеры по мере появления задач.
|
|||
|
|
4. Если в ходе работы нужна инструкция, которой нет ни в твоём файле роли, ни в её триггерах — **не ищи её сам в других ролях**. Сообщи пользователю и спроси, как быть (переключить роль, дополнить инструкцию, и т.п.).
|
|||
|
|
|
|||
|
|
## Что запрещено
|
|||
|
|
|
|||
|
|
- Читать файлы других ролей даже выборочно.
|
|||
|
|
- Сканировать `ai/` целиком или строить по ней собственную карту.
|
|||
|
|
- Смешивать правила из разных ролей в одном ответе.
|
|||
|
|
- Додумывать правила, которых нет в твоём файле роли.
|