Карта кодовой базы: агент разбирает проект в map.md

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

map.md — карта проекта: из каких частей он состоит, как данные идут от клика до базы, где хрупко и что непонятно без автора. Промпт ниже заставляет агента пройти по коду, ничего не меняя, и подкрепить каждое утверждение путём к файлу. Потом карта лежит в проекте, и агент читает её в начале каждой сессии.

Что получишь

• 🗂Модули

  Таблица: папка, за что отвечает, главные файлы. Стек — по файлам зависимостей.

• 🔀Потоки данных

  Главные сценарии по шагам: страница → обработчик → модель → таблица → письмо, с путями.

• 🧨Узкие места

  Где нет проверок, где дублируется логика, где секреты в коде и что сломается при правках.

• ❓Вопросы к автору

  Что из кода понять нельзя. С этим списком идут к прошлому разработчику.

Общий подход к незнакомому проекту описан в гайде Разберись в чужом проекте, ничего не сломав, а здесь — промпт, который выдаёт готовый файл. Если агент найдёт в коде ключи, дальше пригодится проверка на утечки ключей.

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

1. 1Открой агента в папке проекта

   Claude Code или Cursor. В обычном чате приготовь дерево папок, файл зависимостей и 2–3 главных файла.

2. 2Напиши, зачем тебе карта

   Конкретная следующая задача, например «добавить оплату». По ней агент соберёт последний раздел.

3. 3Проверь пути

   Открой 3–4 файла из карты и убедись, что они есть и делают то, что написано.

4. 4Подключи карту к агенту

   Сохрани как docs/map.md и добавь в CLAUDE.md строку «перед правками читай docs/map.md».

Как сохранить: в Claude Code попроси «запиши результат в docs/map.md», в чате скопируй ответ и создай файл сам. После крупных изменений проси агента обновить карту, иначе она быстро устареет.

Рядом по теме: Cursor Rules для архитектуры: готовый architecture.mdc, Папка клиента за вечер, Исправить ошибку в проекте и доказать, что она решена, статья «Cursor или Claude Code» и 12 модов Claude Code для вайбкодера (490 ₽).

Что дальше

• CLAUDE.md, который агент правда читает — подключить карту к постоянным инструкциям агента.
• Новая функция, которая не ломает остальное — следующий шаг, когда карта готова.