update-codemaps — команда для Claude Code: что делает и как установить
Команда update-codemaps для Claude Code анализирует структуру проекта и обновляет архитектурные карты в codemaps/. Синхронизирует документацию при изменениях кода.
MIT ★ 880 обновлён 2026-09-03
.claude/commands/update-codemaps.mdЧто делает update-codemaps
update-codemaps просматривает исходные файлы, их импорты, экспорты и зависимости. Затем команда создаёт или обновляет четыре карты: codemaps/architecture.md с общей схемой, codemaps/backend.md, codemaps/frontend.md и codemaps/data.md с моделями и схемами данных. Описание структуры остаётся на высоком уровне, без разбора деталей реализации.
Для анализа используются TypeScript и Node.js, а самой команде разрешены инструменты Read, Write, Glob и Bash. Она считает процент изменений относительно предыдущей версии, добавляет к каждой карте отметку свежести и пишет отчёт в .reports/codemap-diff.txt. Если diff превышает 30%, команда сначала запрашивает подтверждение пользователя, поэтому крупное обновление не проходит без его решения.
Какие задачи решает
- собрать карту общей архитектуры проекта
- описать структуру backend и frontend
- зафиксировать модели и схемы данных
- сравнить новую структуру с предыдущими картами
Примеры запросов агенту
- Запусти
/update-codemapsи обнови карты архитектуры проекта. - Просканируй импорты и зависимости, затем сформируй
codemaps/architecture.mdи остальные карты. - Сравни текущую структуру с предыдущей версией и сохрани отчёт в
.reports/codemap-diff.txt.
Как установить update-codemaps
Вручную: положить файлы
.claude/commands/update-codemaps.mdВызов — /update-codemaps. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/update-codemaps.mdВызов — /prompts:update-codemaps. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/update-codemaps.prompt.mdВручную: положить файлы
.gemini/commands/update-codemaps.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об update-codemaps
Как установить update-codemaps в Claude Code?
Положите файл команды по пути .claude/commands/update-codemaps.md.
Что делает update-codemaps?
Команда анализирует исходные файлы, зависимости и структуру проекта, после чего обновляет архитектурные карты в codemaps/ и отчёт о diff.
Что произойдёт, если изменения превышают 30%?
Команда запросит подтверждение пользователя перед обновлением карт. Процент изменений сравнивается с предыдущей версией.
Исходный текст
update-codemaps.md · MIT
--- description: Analyze codebase structure and update architecture documentation in codemaps/ allowed-tools: Read, Write, Glob, Bash --- # Update Codemaps Analyze the codebase structure and update architecture documentation: 1. Scan all source files for imports, exports, and dependencies 2. Generate token-lean codemaps in the following format: - codemaps/architecture.md - Overall architecture - codemaps/backend.md - Backend structure - codemaps/frontend.md - Frontend structure - codemaps/data.md - Data models and schemas 3. Calculate diff percentage from previous version 4. If changes > 30%, request user approval before updating 5. Add freshness timestamp to each codemap 6. Save reports to .reports/codemap-diff.txt Use TypeScript/Node.js for analysis. Focus on high-level structure, not implementation details.
© sangrokjung · MIT · sangrokjung/claude-forge