Разберись в чужом проекте, ничего не сломав

Что это

Тебе достался проект: сайт от фрилансера, шаблон с GitHub, бот, который собирал знакомый, или твой же проект полугодовой давности. Первое желание — сразу попросить агента «поменяй цвет кнопки». Агент поменяет, но заодно может переписать то, чего ты не понимаешь, и сломать работающее.

Правильный первый шаг — экскурсия без правок. Агент проходит по файлам и рассказывает:

• что этот проект вообще делает и для кого;
• из каких частей состоит и где что лежит;
• как его запустить и что для этого нужно поставить;
• какие внешние сервисы и ключи он использует;
• где странные, опасные или устаревшие места;
• с чего безопаснее начинать изменения.

После этого ты ставишь задачи точечно. Плюс агент заодно собирает короткий файл правил проекта, чтобы следующие сессии не изучали всё заново.

Как использовать

1. Сделай копию папки проекта — на всякий случай.
2. Открой папку в Claude Code, Codex или Cursor и отправь Шаг 1.
3. Задавай уточняющие вопросы по ответу: «что такое этот файл», «зачем тут этот сервис», «что будет, если удалить …».
4. Когда картина ясна, отправь Шаг 2 — агент запишет карту проекта в файл правил.
5. Только потом ставь задачи на изменения, по одной.

Промпт

Шаг 1. Экскурсия без правок.

Я открыл проект — это [сайт / лендинг / бот / приложение], [скачанный из интернета / сделанный кем-то для меня / мой старый проект]. Я [не программист / немного разбираюсь].

Сначала изучи его структуру: пройдись по файлам и расскажи мне простыми словами:
1. Что этот проект делает и для кого — 3–5 предложений.
2. Из каких частей состоит: главные папки и файлы, за что каждая отвечает. Короткой картой, без перечисления всего подряд.
3. Как его запустить у меня: что нужно установить, какие команды, что я должен увидеть, если всё получилось. Если ничего запускать не нужно — так и скажи.
4. Какие внешние сервисы, ключи и настройки ему нужны и где они задаются. Значения ключей не показывай.
5. Что выглядит странно, устарело или опасно: ключи прямо в коде, мёртвые файлы, старые библиотеки, места, где всё держится на честном слове.
…

Шаг 2. Записать карту проекта.

Сохрани то, что ты выяснил, в короткий файл правил проекта: CLAUDE.md (если ты Codex — AGENTS.md).

В нём:
— что это за проект — 2–3 строки;
— где что лежит — короткая карта;
— как запускать и проверять;
— внешние сервисы и где их настройки (без значений ключей);
— что не трогать без моего согласия.
…

Что дальше

Теперь ставь задачи по одной и проси показывать план до правок — по шагам это расписано в Новая функция, которая не ломает остальное. Если в разборе всплыли ключи в коде или открытые места — следом прогони Найди дыры в проекте до того, как их найдут другие. Работаешь в Claude Code — поставь 12 модов Claude Code для вайбкодера (490 ₽): корзина вместо удаления и защита ключей подстрахуют, пока ты осваиваешь чужой проект.