architecture-map — скилл
Скилл рисует интерактивную изометрическую карту репозитория: здания по размеру кода, потоки по реальным вызовам.
- 383 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скилл копирует компоненты и скрипт в репозиторий и меняет `package.json`.
- Подключенная проверка в CI может блокировать слияние, пока карта не обновлена.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/architecture-mapОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл копирует компоненты и скрипт в репозиторий и меняет `package.json`.
- Подключенная проверка в CI может блокировать слияние, пока карта не обновлена.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
architecture-map строит в репозитории страницу с картой архитектуры в виде изометрического города. Здания обозначают подсистемы и масштабируются по измеренному объему кода, кварталы объединяют подсистемы, а анимированные потоки повторяют реальные пути вызовов. Счетчик расхождений роняет проверку в CI, когда карта отстает от кода. Скилл сначала определяет фреймворк, дизайн-токены и механизм темной темы, запускает `propose-coverage.mjs` и задает четыре вопроса: где разместить страницу, что охватывать, какую дизайн-систему взять, нужны ли проверка в CI и синхронизация в `predev` и `prebuild`. Дальше он копирует компоненты на React, пишет `architecture.config.json` и составляет граф: от четырех до семи групп и от 15 до 25 узлов с описаниями, прочитанными из кода. Описания и связи пишутся вручную, а счет файлов, охват и геометрия измеряются скриптом.
Для кого. Командам, которые вводят новичков в большой репозиторий и хотят карту, не устаревающую после первого рефакторинга.
Подходит, если
- Новому разработчику надо показать, как устроен репозиторий, за час, а не за неделю.
- Внутри самого проекта нужна страница архитектуры на React в цветах его дизайн-системы.
- Карта должна падать в CI, когда код ушел вперед, а описание осталось прежним.
- Описание подсистем в вики устарело, и его заменяют картой, которую обновляют повторным запуском скилла.
Не подходит, если
- Статичная схема для документа: результат скилла остается интерактивной страницей внутри приложения.
- Быстрый черновик без чтения кода: описания узлов пишутся после чтения файлов, скрипт их не генерирует.
- Репозиторий без React: готовые компоненты карты написаны на React.
Пример запроса к агенту
Построй карту архитектуры этого репозитория на странице `/~/architecture` в цветах нашей дизайн-системы.Ограничения
Готовые компоненты карты зависят только от React и проходят проверку типов в режиме `strict`. Описания групп, узлов и потоков агент пишет вручную после чтения кода, поэтому построение занимает заметное время. Скилл копирует компоненты и скрипт `architecture-sync.mjs` в репозиторий и добавляет команду `architecture:sync` в `package.json`. Проверка в CI подключается по желанию и падает, пока карту не обновят. В репозитории лежит один скилл, версия 1.0.0, а скрипты в нем написаны на Node.js.
Как отключить. Удалите символическую ссылку на скилл из каталога скиллов. Скопированные в проект файлы (`src/architecture/`, `scripts/architecture-sync.mjs`, `architecture.config.json`) и команду `architecture:sync` в `package.json` удалите вручную.
Частые вопросы
Как установить скилл?
Клонируйте репозиторий и создайте символическую ссылку: `ln -s "$PWD/architecture-map" ~/.claude/skills/architecture-map`. Для Codex каталог `~/.codex/skills/architecture-map`. Скиллы загружаются при старте сессии, поэтому откройте новую.
Какие вопросы задает скилл?
Четыре: где разместить страницу (по умолчанию `/~/architecture`), что охватывать, какую дизайн-систему взять и какие дополнения подключить: проверку в CI, синхронизацию, историю версий.
Почему карта не устаревает?
Описания пишутся вручную, а счет файлов, охват и геометрия измеряются скриптом. Счетчик непривязанных файлов показывает расхождение, и CI падает, пока карту не обновят.
Сколько узлов получится на карте?
Скилл советует 4–7 групп и 15–25 узлов.
Как обновить карту?
Запустите скилл повторно. Если в корне есть `architecture.config.json`, он работает как обновление, а не как новое построение.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл превращает разговор об архитектуре в интерактивную изометрическую карту системы и текстовую копию SYSTEM.md из одного файла данных
Скилл рисует архитектуру проекта, его правила и границы будущей правки на HTML-карте, чтобы согласовать план до изменения кода.
Скилл строит карту репозитория по смысловым блокам, разбирает на ней код по шагам и подсвечивает сломанные места
Скилл, который вместо ASCII-схем в терминале собирает самодостаточные HTML-страницы: диаграммы, разбор диффов, ревью планов, таблицы и слайды
stack-diagram, скилл для архитектурных схем, встраивает логотипы и шрифты в HTML: готовый файл можно открыть без сети.
Скилл рисует архитектурные схемы, блок-схемы и диаграммы последовательностей как размеченный вручную SVG в едином стиле
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| architecture-map (эта карточка) | нет | 383 | |
| Diagram Design | нет | 65 471 | рисует отдельные диаграммы файлами HTML и SVG, а architecture-map строит интерактивную карту внутри приложения со счетчиком расхождений |
| stack-diagram | нет | 1 880 | встраивает логотипы и шрифты в схему для офлайн-просмотра, а architecture-map измеряет объем кода и следит за устареванием в CI |
Коротко о README
Репозиторий задуман как набор переносимых скиллов формата `SKILL.md`, но пока содержит один. README объясняет, как ставить скиллы ссылкой, чтобы `git pull` обновлял все установки сразу, и из каких каталогов состоит скилл: `references`, `scripts`, `assets`.