Разобраться в чужом репозитории за час
Понять незнакомую кодовую базу и найти точку входа для правки.
Незнакомый репозиторий пугает только первые полчаса. С агентом можно быстро построить карту проекта и найти точку входа, не читая весь код подряд.
Перед стартом
Подготовьте 10 минут и рабочий материал
- 01Откройте нужный инструмент и войдите в аккаунт, если он нужен.
- 02Соберите исходные материалы: файл, заметки, ссылку или репозиторий.
- 03Сохраните копию того, что будете менять: ИИ ускоряет работу, но проверка остаётся за вами.
Можно начать с ИИ-ассистентом
Скопируйте стартовый запрос
Он задаст помощнику роль проводника: без прыжков через шаги и с проверкой результата.
Помоги мне пройти сценарий «Разобраться в чужом репозитории за час». Моя цель: Понять незнакомую кодовую базу и найти точку входа для правки. Инструменты: Claude Code, Cursor. Веди меня по шагам, по одному за сообщение. В начале каждого шага объясняй, что именно сделать и какой результат должен получиться. Не выдумывай данные и не пропускай проверку результата. Если для следующего шага не хватает вводных — сначала задай мне короткий вопрос.
Пройти по шагам
Делайте по одному пункту. Не переходите дальше, пока не сможете своими словами подтвердить, что результат шага получился.
- 1
Попросите карту проекта
Дайте агенту репозиторий и попросите описать стек, структуру папок и точки входа. Это сразу даёт «вид сверху» вместо блуждания по файлам.
Контрольная точка: шаг 1 выполнен — только теперь идите дальше.
- 2
Запросите схему потоков данных
Попросите словами описать, как данные идут от запроса к ответу и какие модули за что отвечают. Так держите в голове архитектуру, а не отдельные функции.
Контрольная точка: шаг 2 выполнен — только теперь идите дальше.
- 3
Найдите нужный файл по смыслу
Опишите фичу, которую правите, и попросите найти отвечающий за неё код. Поиск по смыслу быстрее, чем по именам файлов.
Контрольная точка: шаг 3 выполнен — только теперь идите дальше.
- 4
Сделайте маленькую безопасную правку
Внесите минимальное изменение и прогоните тесты. Один зелёный прогон даёт уверенность, что вы поняли проект правильно.
Контрольная точка: шаг 4 выполнен — только теперь идите дальше.
Совет профи
Просите агента объяснять незнакомые места «как джуну» и сразу показывать, где это используется. Так разбираетесь вдвое быстрее.
Частые ошибки
- Читаете код подряд сверху вниз — тонете в деталях вместо общей картины.
- Сразу лезете в большую правку, не поняв связи модулей.
- Меняете код без тестов — не понять, сломали что-то или нет.
Если застряли
Необязательно разбираться в одиночку
Напишите, на каком шаге остановились и что уже пробовали. Подскажем направление — без навязывания разработки. А за контекстом и примерами можно сходить в разборы.