5fa5a391d7
The agent team workflow lives in .opencode/agent role files; the human-readable guide is redundant and removed. README and analyst role updated accordingly. Added analytics baseline documenting the current project state as a starting point for future tasks.
49 lines
5.9 KiB
Markdown
49 lines
5.9 KiB
Markdown
# Удалить AGENT_TEAM.md и почистить ссылки на него
|
||
|
||
## Задача
|
||
|
||
Удалить `AGENT_TEAM.md` из репозитория и убрать/заменить все ссылки на него в `README.md` и `.opencode/agent/analyst.md`. Задача чисто документационная: код продукта не меняется.
|
||
|
||
## Контекст
|
||
|
||
`AGENT_TEAM.md` — человекочитаемое руководство по агентской команде (opencode). Оно стало избыточным: рабочий цикл и правила команды теперь описаны в `.opencode/agent/orchestrator.md` (порядок `orchestrator → analyst → coder → reviewer → tester`, правила деплоя) и в ролях субагентов (`.opencode/agent/analyst.md`, `coder.md`, `reviewer.md`, `tester.md`). Краткое описание команды для человека остаётся в `README.md` (секция «Локальная разработка → Агентская команда (opencode)», строки 48–67) — её нужно сохранить, убрав из неё ссылку-инструкцию на удаляемый файл.
|
||
|
||
Рабочее дерево чистое, ветка `master` впереди `origin/master` на 1 коммит. Коммит/пуш не входят в скоуп задачи.
|
||
|
||
## Затронутые подсистемы и файлы
|
||
|
||
Проверено `rg AGENT_TEAM --hidden --no-ignore` — в репозитории ровно 4 упоминания (плюс сам файл):
|
||
|
||
1. `AGENT_TEAM.md` (корень репозитория) — удалить целиком.
|
||
2. `README.md:4` — интро: «Работа агентской команды (opencode) описана в [руководстве по агентской команде](./AGENT_TEAM.md).» — переформулировать без ссылки (либо убрать предложение).
|
||
3. `README.md:50` — «Подробная инструкция: [AGENT_TEAM.md](./AGENT_TEAM.md).» в секции «Агентская команда (opencode)» — убрать строку; остальное описание команды (строки 52–67) сохранить, при необходимости дополнить упоминанием папки `analytics/` (аналитика задач, ведёт Analyst).
|
||
4. `README.md:121` — дерево проекта: `└── AGENT_TEAM.md # руководство по агентской команде opencode` — убрать строку.
|
||
5. `.opencode/agent/analyst.md:12` — шаг 1: «read `AGENTS.md`, `AGENT_TEAM.md`, the relevant code and docs…» — заменить `AGENT_TEAM.md` на актуальные источники (например, `README.md` и/или `.opencode/agent/`), оставив смысл шага.
|
||
|
||
## Критерии приёмки
|
||
|
||
- `AGENT_TEAM.md` удалён из репозитория.
|
||
- Нигде не осталось ссылок на удалённый файл: `rg AGENT_TEAM` по `README.md`, `.opencode/`, `backend/`, `frontend/` и т.д. — 0 совпадений (упоминания имени файла в тексте самой этой аналитики не считаются).
|
||
- В `README.md` ссылок на `AGENT_TEAM.md` не осталось; секция «Агентская команда (opencode)» сохранена и при необходимости дополнена упоминанием `analytics/`; дерево проекта не содержит удалённого файла.
|
||
- В `.opencode/agent/analyst.md` упоминание `AGENT_TEAM.md` заменено/убрано без потери смысла шага 1.
|
||
- Код продукта (`backend/`, `frontend/`, `migrations/`, `tests/`, `compose.yml`, `Dockerfile` и т.п.) не тронут.
|
||
- `git status` — ожидаемый набор: `deleted: AGENT_TEAM.md`, `modified: README.md`, `modified: .opencode/agent/analyst.md` (+ новый файл этой аналитики).
|
||
- Коммит/пуш не выполняется без явного запроса пользователя.
|
||
|
||
## План
|
||
|
||
1. Удалить `AGENT_TEAM.md`.
|
||
2. `README.md`: переформулировать интро (строка 4), убрать строку 50, при необходимости дополнить описание команды упоминанием `analytics/`, убрать строку 121 из дерева проекта. Остальное в README не трогать.
|
||
3. `.opencode/agent/analyst.md`: в шаге 1 заменить `AGENT_TEAM.md` на актуальные источники (`README.md`, роли в `.opencode/agent/`).
|
||
4. Проверить: `rg AGENT_TEAM` вне `analytics/` → 0 совпадений; `git status` — только ожидаемые файлы.
|
||
5. Деплой не требуется: изменены только документация и описание агентов, они не входят в Docker-образы; решение за Orchestrator.
|
||
|
||
## Риски и ограничения
|
||
|
||
- Не потерять информацию: рабочий цикл после удаления должен оставаться описан в `.opencode/agent/orchestrator.md` + ролях субагентов + секции «Агентская команда» в README.
|
||
- Задача документационная — ни один файл продукта не должен попасть в diff.
|
||
- Минимальные правки: не рестайлить нетронутые части README/analyst.md.
|
||
|
||
## Журнал изменений
|
||
|
||
- 2026-09-17 — создан документ задачи (Analyst). Факты сверены с репозиторием: найдено 4 упоминания `AGENT_TEAM` (README ×3, analyst.md ×1) + сам файл.
|