39 lines
4.7 KiB
Markdown
39 lines
4.7 KiB
Markdown
# Вечерний детектив — правила работы агента
|
|
|
|
## Структура
|
|
|
|
- `evening_detective_server/` — отдельный Go-репозиторий бэкенда.
|
|
- `evening_detective_frontend/` — отдельный Vue/TypeScript-репозиторий фронтенда.
|
|
- `email_server/` — устаревающая инфраструктура собственного почтового сервера.
|
|
- `.agents/` и `.codex/` — локальная конфигурация среды; не менять без явного запроса.
|
|
|
|
## Правила
|
|
|
|
1. Сначала изучай существующий поток и используй текущие паттерны проекта.
|
|
2. Делай минимальный целевой diff; не добавляй зависимости и абстракции без необходимости.
|
|
3. Не трогай вложенные `.git` и не смешивай историю двух дочерних репозиториев.
|
|
4. Коммиты и push выполняет только пользователь. Агент никогда не коммитит и не отправляет изменения.
|
|
5. Не добавляй `.env`, ключи, пароли, сертификаты и локальные артефакты в Git.
|
|
6. После нетривиальных изменений запускай краткую релевантную проверку и сообщай результат.
|
|
|
|
## Команды проверки
|
|
|
|
- Бэкенд: `cd evening_detective_server && go test ./...`
|
|
- Фронтенд: `cd evening_detective_frontend && npm run type-check && npm run lint && npm run lint:css`
|
|
|
|
Для изменений protobuf сначала используй существующую команду `npm run proto:gen` во фронтенде и соответствующую генерацию в бэкенде.
|
|
|
|
Для задач, затрагивающих `evening_detective_frontend`, обязательный стандарт кода находится в [`evening_detective_frontend/docs/FRONTEND_CODE_STANDARD.md`](evening_detective_frontend/docs/FRONTEND_CODE_STANDARD.md); это единственный источник правил фронтенда.
|
|
|
|
## Работа со списком задач
|
|
|
|
- Команды взаимодействия с агентом описаны в `docs/agent/README.md`.
|
|
- Активные задачи находятся в `docs/agent/TASKS.md`, архив завершённых — в `docs/agent/COMPLETED_TASKS.md`; не создавай task-файлы в дочерних репозиториях.
|
|
- Используй только две канонические команды из `docs/agent/README.md`: `Новая задача:` и `Выполнить задачу:`.
|
|
- Для `Новая задача:` задавай необходимые уточняющие вопросы итеративно, пока задача не станет понятной: определены цель, границы, критерии готовности, проверка, ограничения и следующий шаг. До этого не добавляй её в `TASKS.md`; после подтверждения полноты добавь со следующим ID и статусом `TODO`. Код не меняй.
|
|
- Для `Выполнить задачу:` сначала проверь полноту требований и задай вопросы только при блокирующей неоднозначности.
|
|
- Простую задачу выполняй без отдельного плана. Для обычной задачи составь короткий внутренний план. Для сложной или рискованной задачи сначала покажи план пользователю и дождись подтверждения.
|
|
- Делегируй только независимое исследование или ревью, когда это сокращает риск или время; последовательную маленькую задачу выполняй сам.
|
|
- В процессе: изучи текущий flow и callers, внеси минимальный diff, после каждого существенного этапа запускай релевантную проверку, исправь ошибки и обнови статус и результат в `TASKS.md`. После перевода задачи в `DONE` перенеси её в `docs/agent/COMPLETED_TASKS.md`.
|
|
- После любого действия сообщи ID задачи и результат; коммиты и push не выполняй.
|