diff --git a/AGENTS.md b/AGENTS.md index 411b080..b9718cf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -22,3 +22,13 @@ - Фронтенд: `cd evening_detective_frontend && npm run type-check && npm run lint && npm run lint:css` Для изменений protobuf сначала используй существующую команду `npm run proto:gen` во фронтенде и соответствующую генерацию в бэкенде. + +## Работа со списком задач + +- Команды взаимодействия с агентом описаны в `docs/agent/README.md`. +- Единственный источник задач — `docs/agent/TASKS.md`; не создавай task-файлы в дочерних репозиториях. +- Используй только две канонические команды из `docs/agent/README.md`: `Новая задача:` и `Выполнить задачу:`. +- Неизвестное или неполное сообщение не изменяет файлы и не запускает код: попроси пользователя использовать каноническую команду. +- Для `Новая задача:` задай только необходимые вопросы, затем добавь задачу в `TASKS.md` со следующим ID, статусом `TODO`, приоритетом, целью, критериями готовности, проверкой и следующим шагом. Код не меняй. +- Для `Выполнить задачу:` реализуй указанную задачу, запусти релевантные проверки и обнови её статус и результат в `TASKS.md`. +- После любого действия сообщи ID задачи и результат; коммиты и push не выполняй. diff --git a/docs/agent/README.md b/docs/agent/README.md new file mode 100644 index 0000000..86828c4 --- /dev/null +++ b/docs/agent/README.md @@ -0,0 +1,41 @@ +# Команды для работы с задачами + +Источник задач: [`TASKS.md`](TASKS.md). + +Используй только две канонические команды. Регистр не важен; синонимы не +используются. + +## Создание задачи + +```text +Новая задача: <краткое описание> +``` + +Агент задаёт только необходимые уточняющие вопросы, затем добавляет задачу в +`TASKS.md` со статусом `TODO`. Код и продуктовые файлы не изменяются. + +Пример: + +```text +Новая задача: добавить повторную отправку письма подтверждения регистрации +``` + +## Выполнение задачи + +```text +Выполнить задачу: ED-001 +``` + +Агент читает задачу, изучает код, меняет статус на `IN_PROGRESS`, реализует её, +запускает проверки и обновляет `TASKS.md`. + +## Неизвестные сообщения + +Сообщение без одной из двух команд не выполняет действий и не изменяет файлы. +Агент просит использовать `Новая задача:` или `Выполнить задачу: ED-001`. + +## Общие правила + +- Единственный список задач — `TASKS.md`. +- Новые task-файлы в дочерних репозиториях не создаются. +- Агент не делает commit и push.