«Не трогать»: три способа работать с проклятым legacy, комментарий, séance с агентами и MCP в Cursor

Комментарий // DO NOT TOUCH переживает автора, а blame в GitHub не объясняет, зачем так написано. GitSéance, open-source «некромancer» с четырьмя агентами, переводит страх в число, голос Gemma и поиск CVE. Для соло-разработчика в Cursor тот же стек доступен через нативный MCP-сервер, без IDE-плагина.
От табу в коде к сеансу с моделями
Dhruv Jani (@dj29) собрал GitSéance (в репозитории имя GitSeance) как submission Hacktoberfest Open-Source AI Challenge, неделя 4, «Ghost in the Machine». Это не линтер: асинхронный multi-agent pipeline на FastAPI с веб-интерфейсом в духе «phosphor-green CRT Terminal» и live-версией на gitseance.onrender.com. Исходники под MIT; в описании автора 25 unit/integration тестов на CI (Ubuntu и Windows).
Боль узнаваемая: в каждой кодовой базе есть модуль с комментарием «NOBODY KNOWS WHY THIS WORKS», сменился владелец, diff уже не читается. Jani не предлагает «просто рефакторить»: он строит ритуал, находит «проклятые» файлы, оценивает «смертность», заставляет модель говорить от первого лица «призрака» разработчика и подсказывает, чем заменить зависимости.
Четыре агента вместо одного чата с LLM
Оркестрация разделена на роли; каждая закрывает свой класс задач для legacy под ИИ:
| Агент | Задача |
|---|---|
| Reaper | Обход дерева коммитов и AST; «abandoned», «orphaned», «cursed» код; эвристики по inline fear comments (hack, black magic, do not touch). |
| Oracle (TabPFN-3.5) | Семь признаков из истории репозитория → калиброванный риск «mortality» файла. |
Medium (Google Gemma gemma-4-26b-a4b-it) |
«Исповеди» от первого лица, сожаления, «revival blueprints»; отдельный разбор thought-тokens Gemma. |
| Searcher (SerpApi) | Актуальные замены пакетов и CVE. |
Семь измерений вектора, которые Jani перечисляет явно: days_since_last_commit, total_commits, unique_authors, bug_fix_commit_ratio, lines_ratio, has_tests, churn_velocity. TabPFN-3.5 (Prior Labs) калибруется на наборе из 50 артефактов (25 «мёртвых» vs 25 поддерживаемых); это его заявление, не универсальный бенчмарк продукта.
Интерактив идёт через
POST /api/seance/chat; системный промптSEANCE_SYSTEM_PROMPTзадаёт роль «ghost of a software developer»: объяснить зачем код, признать сожаления, дать совет по «revival».
Дополнительно в UI: conversational séance, Neural Voice Deck (ElevenLabs eleven_multilingual_v2), ASCII post-mortem certificates, CSV экспорт фич, SVG-бейджи mortality (/api/badge/{owner}/{repo}.svg).
MCP в Cursor и «rules» в контуре Copilot
Для vibe-coding интеграция важнее красного терминала: в репозитории лежит нативный MCP-сервер backend/mcp_server.py с инструментом tabpfn_predict_mortality; заявлена поддержка Cursor, Claude Desktop и Copilot. Соло-разработчик может вызывать «oracle» mortality из IDE, не копируя промпт вручную в каждый сеанс.
backend/mcp_server.py → tool: tabpfn_predict_mortality
→ Cursor / Claude Desktop / Copilot
Параллельный контур для GitHub Copilot: .github/copilot-instructions.md и шаблоны в .github/prompts/ (/resurrect-file, /tabpfn-mortality, /dep-modernize). По смыслу это тот же слой, что rules и skills в агентных IDE: повторяемые инструкции вместо ad-hoc чата.
У Jani отдельный акцент на open innovation: связка открытых весов (Gemma, TabPFN) и сценарий air-gapped / offline necromancer без обязательной привязки к облачному SaaS для всего пайплайна.
Демо на flask-cache и где ломается инфраструктура
На пресете thadeusb/flask-cache Reaper помечает Makefile как «Clinically Dead» (5986 дней без активности в примере); TabPFN в этом примере показывает 80% mortality probability; Gemma «каналит» автора Thadeus Burgess; SerpApi подсказывает pyproject.toml, twine, build. Цифры относятся к одному разбору, а не к SLA продукта.
Инженерные ограничения описаны честно:
- У Gemma internal thought tokens съедают budget; кастомный
_extract_textпоcandidates[0].content.parts. - GitHub REST blame без auth: лимит 60 запросов в час; Jani батчит
asyncio.gather(по 8), фильтрует расширения, для пресетов держит fallback snapshots (flask-cache,jquery-color). - Python 3.11: нюансы SSE и f-string/backslash потребовали рефактор сериализации буферов.
Если ваш legacy живёт за комментарием «не трогать», полезный вывод не в мистике, а в связке история Git → табличная модель риска → persona LLM → MCP/tooling в редакторе. Другие submission той же недели Hacktoberfest Jani не сравнивает; опираться на них здесь нельзя.
Источники
- Dhruv Jani (@dj29), «Every Codebase Has a '// DO NOT TOUCH' File. I Built an AI Necromancer…», Dev.to (дата публикации по ленте: 2026-10-31; доступ при обогащении: 2026-11-01 UTC)
- Репозиторий GitSeance, https://github.com/JaniDhruv/GitSeance
- Live-терминал, https://gitseance.onrender.com