# Booster Architecture Map

> Использование инструментов Booster для генерации и получения макроархитектурных артефактов (Code City и Repo Map).

- Skill: `neuroghostdev/booster-architecture-map` (Agent Skill)
- Install (CLI): `npx skillmds@latest add neuroghostdev/booster-architecture-map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/neuroghostdev/booster-architecture-map/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: NeuroGhostDev (https://skillmd.com/u/neuroghostdev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/neuroghostdev/booster-architecture-map

---


# Booster Architecture Map

## Цель

При работе с большими кодовыми базами важно понимать их структуру сверху вниз. Booster MCP предоставляет два мощных инструмента для генерации топологии:

1. **Repo Map** — сжатая текстовая репрезентация репозитория в стиле Aider (содержит классы и сигнатуры функций).
2. **Code City** — 3D-визуализация репозитория (здания = файлы, высота = метрики, цвет = язык).

## Алгоритм работы

1. **Repo Map (Текстовая структура)**
    Вызови `get_repo_map(repo_path="<path>")`.
    Ты получишь bounded architecture map с diversity по top-level modules,
    обязательным покрытием entrypoints/configs/contracts и coverage summary.
    *Основной файл: `[repo]/.agents/booster/repo_map_architecture.md`;*
    `repo_map.md` остаётся backward-compatible копией.
    Для подробных symbols используй `[repo]/.agents/booster/repo_map_symbols.md`.

2. **Code City (3D Визуализация)**
   Вызови `get_code_city(repo_path="<path>")`.
   Сервер сгенерирует HTML-файл с 3D-репрезентацией города и вернет тебе путь к нему, а также статистику метрик (сложность, кол-во строк, файлы).
    *Попроси пользователя открыть этот HTML файл в браузере `[repo]/.agents/booster/code_city.html`.*

    3. **Index Health**
       Проверь `get_repo_artifacts()` и `index_health.json`: generation,
       completeness, skipped/stale/deleted paths и причины вытеснения из map.

## Когда использовать

- В начале проекта (используя `booster-onboard`).
- Когда нужно найти архитектурные зависимости или "горячие зоны" (большие файлы = небоскребы в Code City).
- Для быстрого поиска импортов и сигнатур (с помощью `get_repo_map`).
- Для проверки, что giant modules не вытеснили frontend, control-plane и contracts.