- 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>
10 KiB
10 KiB
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.