Сценарий
Онбординг легаси-репозитория
Незнакомый сервис без тестов и документации перестаёт быть чёрным ящиком — от «как это вообще работает» до первой безопасной доработки.
Ситуация
Вам передали незнакомый сервис — например, notes-api: без тестов, без документации, с невнятной историей коммитов. Трогать страшно, а дорабатывать надо. С чего начать и как не сломать то, что работает?
Проблемы
- Непонятно, как устроен проект — где что лежит, какие домены и связи.
- Нужно понять логику конкретного места — например, как формируется ответ /search.
- Нужны выверенные ответы по логике работы, чтобы приложить к постановке задачи.
- Неясно, где риск-зоны и техдолг — за что хвататься в первую очередь.
- Нет тестов и документации — вносить правки вслепую опасно.
- Нет рабочего окружения — код нельзя собрать и прогнать на тестах.
Как это решает Buff
Аудит — картина проекта «как есть»
Сквозной разбор кодовой базы: домены, архитектура, зависимости, поведение, риск-зоны и техдолг — с приоритетами и понятными выводами. Разделы готовятся автоматически, даже когда тестов и документации нет. Из аудита сразу видно, как устроен notes-api и за что хвататься в первую очередь.
«Спросить» — точечный ответ по коду
Когда нужно понять конкретное место, а не весь проект, — задайте вопрос. Buff читает исходники и отвечает со ссылками на файлы, ничего не меняя. Например: «Где формируется ответ /search и как экранируется запрос?» — ответ укажет на notes-api/src/search.ts и объяснит логику.
Глубокое исследование — выверенный документ под задачу
Когда нужен не быстрый ответ, а проработанное решение, — два агента (аналитик и ревьюер) готовят выверенный документ по вашему коду, проверяя выводы друг друга. Его удобно приложить к постановке задачи, чтобы разработка шла от фактов, а не догадок.
Инструменты и первая задача — без правок вслепую
Прежде чем что-то менять, для проекта готовятся инструменты разработки — среда, где код собирается, запускается и проверяется тестами. Только после этого первая задача идёт по пайплайну: постановка простыми словами, план на ваше утверждение — и никаких изменений вслепую.
Итог
Незнакомый легаси перестаёт быть чёрным ящиком: вы понимаете его устройство и логику, знаете риск-зоны, а доработки идут безопасно — с тестами и под вашим контролем.