vrubelroman/myYouTube
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
myYouTube/analytics/2026-09-17-remove-agent-team-guide.md
vrubelroman 5fa5a391d7 Remove AGENT_TEAM.md, add project baseline analytics 
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.
2026-09-17 21:42:30 +00:00

5.9 KiB
Raw Blame History

Удалить 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) описана в руководстве по агентской команде.» — переформулировать без ссылки (либо убрать предложение).
  3. README.md:50 — «Подробная инструкция: 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) + сам файл.