Files
mtusi2026lab4/openspec/changes/archive/2026-09-30-graphify/tasks.md
T
ricoromaandClaude Opus 5.5 5d5d8f9d2a chore: carry lab 3 over
- carry the lab 3 solution over from mtusi2026lab3-safronov
  (solution/bvt2301-safronov, ce89eba): src, migrations, student-tests,
  bench, openspec, .claude, infra/haproxy and infra/valkey, own scripts,
  Dockerfile, compose, pyproject and uv lock
- merge Makefile, .gitignore and .dockerignore (the lab 3 versions only
  add lines to the skeleton, which is the same in lab 4) and
  .env.example (lab 4 skeleton names listed in the header)
- rename the compose project to mtusi-lab4 and the image to :lab4 so
  the stand does not reuse the lab 3 containers and volumes
- update AGENTS.md for lab 4: current lab, origin commit, contract and
  test files of the new skeleton

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 17:32:33 +03:00

10 KiB
Raw Blame History

Tasks

Как строить — design.md, что должно получиться — specs/code-knowledge-graph/spec.md. Перед правкой .dockerignore прочитать .claude/rules/docker.md. Снимки и копии для сравнения класть в scratchpad сессии, не в репозиторий. Git — только смотреть: без commit, add и хуков.

Задачи 2.3, 2.4, 4.1, 4.2, 4.3, 5.1, 5.2 и 7.1 написаны и выполнены под первую реализацию — со скиллом /graphify и семантическим разбором документов (копирование скилла, /graphify . --update, порт через docker-compose.yml, фраза про инструкции скилла в AGENTS.md, .claude/skills/graphify/ в ожидаемых файлах). От неё отказались (design.md, решение 3a); итоговое состояние и его проверки — группа 8.

1. Снимок до установки

  • 1.1 Снять снимок по design, решение 2: копии и sha256 ~/.claude/CLAUDE.md, ~/.claude/settings.json, .claude/settings.local.json; списки ~/.claude/skills/, .claude/, .git/hooks/; git config --local --list; sha256 uv.lock; git status --short --ignored. Проверка: все файлы снимка есть в scratchpad и не пустые.

2. Установка

  • 2.1 Узнать последнюю версию graphifyy и поставить CLI: uv tool install 'graphifyy==<версия>'. Проверка: graphify --version печатает эту версию; uv tool list показывает graphifyy; sha256 uv.lock совпадает со снимком.
  • 2.2 Сверить команды по graphify --help и graphify install --help: флаг --project, запросы (query, path, explain), --update, export callflow-html. Если что-то расходится с design — остановиться и сказать пользователю до установки скилла. Проверка: список реальных команд и флагов записан в ответе пользователю.
  • 2.3 Скопировать скилл в корне репозитория командой из design, решение 1 (_copy_skill_file('claude', project=True, ...)), без graphify install. Проверка: появился .claude/skills/graphify/SKILL.md с references/; .claude/settings.json и .claude/CLAUDE.md не появились, CLAUDE.md совпадает со снимком; повторный снимок по 1.1 отличается только новым каталогом скилла. Иное отличие — остановиться, показать diff пользователю, откат из копий — только с его согласия.
  • 2.4 Прочитать .claude/skills/graphify/SKILL.md и references/ целиком, выбрать исход по таблице в design, решение 4. Проверка: исход и цитата места, которое к нему привело, есть в ответе пользователю. При третьем исходе (хук или правка CLAUDE.md/AGENTS.md) — стоп до решения пользователя.

3. Исключения

  • 3.1 Создать .graphifyignore со списком из design, решение 3. Проверка: каждый путь из требования «Состав графа» (MUST NOT) покрыт этим файлом или .gitignore.
  • 3.2 Добавить graphify-out/ в .gitignore (секция артефактов) и graphify-out в .dockerignore (к своим исключениям). Проверка: git check-ignore -v graphify-out/x указывает на .gitignore; git diff .dockerignore — одна добавленная строка.

4. Сборка графа

  • 4.1 Собрать граф /graphify . в сессии Claude Code. Проверка: есть graphify-out/graph.json и graphify-out/GRAPH_REPORT.md; git status --short не показывает graphify-out/.
  • 4.2 Проверить состав по сценариям требования «Состав графа»: запрос о сервисе чатов даёт узел из src/core/services/ и узел из .claude/rules/ или openspec/specs/; запрос о порте даёт docker-compose.yml и src/config/; поиск по tests/, scripts/, .claude/commands/, .claude/skills/, openspec/changes/ пуст; grep значений из .env и config.toml по graphify-out/ ничего не находит. Проверка: вывод запросов в ответе пользователю.
  • 4.3 Проверить обновление: добавить в src/utils/ временный модуль с одной функцией, выполнить /graphify . --update, найти модуль в графе, удалить модуль, снова --update. Проверка: модуль появился и исчез; в выводе видно, что неизменённые файлы взяты из кэша; git status после удаления чистый по src/.

5. Инструкции агента

  • 5.1 AGENTS.md: пункт про граф в «Где лежат инструкции» по design, решение 4, с учётом исхода 2.4 и реальных имён команд из 2.2. Вводную «Три уровня» поправить на четыре. Проверка: в пункте есть «перед правкой — Read» и «важнее инструкций скилла graphify».
  • 5.2 AGENTS.md: в «Окружение и команды» — строки установки (uv tool install --python 3.12 'graphifyy==0.9.72', копирование скилла из design, решение 1, и запрет graphify install / graphify claude install с причиной) и обновления (/graphify . --update); в «Переход в следующую лабу» — .graphifyignore в «Переносить», graphify-out/ в «Не копировать». Проверка: grep -n graphify AGENTS.md показывает три раздела.

6. Схема для отчёта

  • 6.1 Получить Mermaid потока отправки сообщения по design, решение 6: сначала graphify export callflow-html, при неудаче — вручную по graphify path / query. Проверка: каждая стрелка сверена с кодом через Read (импорт или вызов есть), узлов не больше ~15.
  • 6.2 REPORT.md: подзаголовок «Слои кода» с блоком ```mermaid после «Процессы и хранилище»; в строку «помощь ИИ» — graphify и для чего он. Текст о процессах и хранилище не менять. Проверка: git diff REPORT.md — только добавления; схема рендерится в превью Markdown с Mermaid (PyCharm или GitHub).

7. Итоговая проверка

  • 7.1 Повторить снимок по 1.1 и сравнить. Проверка: глобальные CLAUDE.md и settings.json, .claude/settings.local.json, .git/hooks/, git config --local и uv.lock совпадают со снимком; в git status новые и изменённые только .claude/skills/graphify/, .graphifyignore, .gitignore, .dockerignore, AGENTS.md, REPORT.md и файлы этого change.
  • 7.2 make lint и make check. Проверка: make lint не меняет файлов (git status до и после одинаковый), make check — PASS.
  • 7.3 docker build -t mtusi-messenger:lab1 . Проверка: сборка проходит, graphify-out не попадает в контекст (размер контекста в выводе того же порядка, что до change).
  • 7.4 Проверка на живом агенте: попросить пользователя открыть новую сессию и дать задачу правки в src/core/services/. Проверка: в транскрипте файл прочитан через Read до правки, и правило service-layer.md подгружено. Результат записать в ответе, правку из проверки не оставлять.

8. Переход на CLI без скилла

  • 8.1 Удалить .claude/skills/graphify/ и graphify-out/, собрать граф с нуля graphify update .. Проверка: сборка без LLM за секунды; в .claude/skills/ только run-mtusi-messenger.
  • 8.2 Проверить состав по требованию «Состав графа»: ни одного пути из списка MUST NOT; связи разделов правил и спек с кодом есть; запрос "ChatService ChatNotFound chat" находит src/core/services/, .claude/rules/ и openspec/specs/; запрос о порте — src/config/ и раздел о запуске. Проверка: вывод в ответе пользователю.
  • 8.3 Сборка в чистом clone: копия git ls-files в scratchpad, graphify update .. Проверка: граф собирается, связи «документ → код» те же.
  • 8.4 Переписать AGENTS.md, REPORT.md (строка про ИИ), proposal, design и спеку под CLI. Проверка: grep -n "skills/graphify\|/graphify ." AGENTS.md пусто; openspec validate graphify --strict проходит.
  • 8.5 Повторить 7.1–7.2: глобальные файлы, хуки, uv.lock как в снимке; make lint без изменений; make check — PASS.