Преврати чужой репозиторий в интерактивную карту архитектуры с переходами к исходному коду Codebase Map — open-source Skill для Codex и Claude Code, который исследует репозиторий и создаёт интерактивную HTML-карту того, как работает приложение. Он показывает путь от API-запроса до базы данных, связи между функциями, очереди, обработчики событий, проверки авторизации и тесты. Для найденных участков указывает конкретные файлы и номера строк.

🔗 GitHub: https://github.com/mpaul3/codebase-map

💡 Как применить

Допустим, тебе нужно изменить систему авторизации в backend. Но прежде чем писать код, важно выяснить:

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

Вместо ручного поиска по десяткам файлов можно попросить агента построить карту конкретного сценария. Получится отдельный HTML-файл, который можно открыть в браузере и использовать для изучения проекта.

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

Как попробовать сегодня 🤝

1. Установи Node.js 18+ и открой проект в Codex. 2. Попроси встроенный установщик добавить Skill: $skill-installer Install the codebase-workflow-mapper skill from https://github.com/mpaul3/codebase-map 3. Запусти команду: $codebase-workflow-mapper Map the main workflows in this repository. 4. Найди созданный файл outputs/<название-проекта>-workflow-map.html и открой его в браузере.

Можно начать с конкретного сценария, например: Trace POST /api/orders through authorization, persistence, events, and tests.

Что важно: для работы нужны Codex или Claude Code с доступом к репозиторию и терминалу. Результат строится по исходникам, а не по живому production-окружению. Динамические вызовы, внедрение зависимостей и некоторые другие конструкции могут быть разрешены не полностью, поэтому карту нужно воспринимать как инструмент исследования, а не абсолютное доказательство архитектуры.