# Онбординг легаси-репозитория

> Незнакомый сервис без тестов и документации перестаёт быть чёрным ящиком — от «как это вообще работает» до первой безопасной доработки.

Сценарий

# Онбординг легаси-репозитория

Вам передали незнакомый сервис — например, notes-api: без тестов, без документации, с невнятной историей коммитов. Трогать страшно, а дорабатывать надо. С чего начать и как не сломать то, что работает?

[Подключить репозиторий](https://buff.systems/app) [Все сценарии](https://buff.systems/use-cases)

Ситуация

## Незнакомый сервис без тестов и документации перестаёт быть чёрным ящиком — от «как это вообще работает» до первой безопасной доработки.

Что мешает

- Непонятно, как устроен проект — где что лежит, какие домены и связи.
- Нужно понять логику конкретного места — например, как формируется ответ /search.
- Нужны выверенные ответы по логике работы, чтобы приложить к задаче.
- Неясно, где риск-зоны и техдолг — за что хвататься в первую очередь.
- Нет тестов и документации — вносить правки вслепую опасно.
- Нет рабочего окружения — код нельзя собрать и прогнать на тестах.

Решение 01

## Аудит — картина проекта «как есть»

Сквозной разбор кодовой базы: домены, архитектура, зависимости, поведение, риск-зоны и техдолг — с приоритетами и понятными выводами. Разделы готовятся автоматически, даже когда тестов и документации нет. Из аудита сразу видно, как устроен notes-api и за что хвататься в первую очередь.

**Аудит — картина проекта «как есть»**

Аудит проекта: готовые разделы по коду, архитектуре и рискам.

[Про аудит](https://buff.systems/docs/audits)

Решение 02

## «Спросить» — точечный ответ по коду

Когда нужно понять конкретное место, а не весь проект, — задайте вопрос. Buff читает исходники и отвечает со ссылками на файлы, ничего не меняя. Например: «Где формируется ответ /search и как экранируется запрос?» — ответ укажет на notes-api/src/search.ts и объяснит логику.

**«Спросить» — точечный ответ по коду**

«Спросить»: ответ по коду со ссылками на конкретные файлы.

[Про «Спросить»](https://buff.systems/docs/ask)

Решение 03

## Глубокое исследование — выверенный документ под задачу

Когда нужен не быстрый ответ, а проработанное решение, — два агента (аналитик и ревьюер) готовят выверенный документ по вашему коду, проверяя выводы друг друга. Его удобно приложить к задаче, чтобы разработка шла от фактов, а не догадок.

**Глубокое исследование — выверенный документ под задачу**

Глубокое исследование: разобранная логика с вариантами и рекомендацией.

[Про исследование](https://buff.systems/docs/research)

Решение 04

## Инструменты и первая задача — без правок вслепую

Прежде чем что-то менять, для проекта готовятся инструменты разработки — среда, где код собирается, запускается и проверяется тестами. Только после этого первая задача идёт по обычному циклу: описание простыми словами, задание на ваше утверждение — и никаких изменений вслепую.

**Инструменты и первая задача — без правок вслепую**

Первая задача: описание, уточнения и задание, которое вы утверждаете.

[Быстрый старт](https://buff.systems/docs/quickstart)

Итог

Незнакомый легаси перестаёт быть чёрным ящиком: вы понимаете его устройство и логику, знаете риск-зоны, а доработки идут безопасно — с тестами и под вашим контролем.

Первый шаг ничего не меняет в коде

## Начните с вопроса о своём проекте

Подключите репозиторий и спросите систему, как устроен ваш код: она читает исходники и отвечает за минуты, ничего не меняя. На знакомство даётся стартовый баланс.

[Подключить репозиторий](https://buff.systems/app) [Написать нам](mailto:info@buff.systems)

Юрлицам и ИП — оплата переводом по реквизитам и закрывающие документы