К основному содержанию
команда CX Codex

update-codemaps — команда для Claude Code: что делает и как установить

Команда update-codemaps для Claude Code анализирует структуру проекта и обновляет архитектурные карты в codemaps/. Синхронизирует документацию при изменениях кода.

MIT ★ 880 обновлён 2026-09-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/update-codemaps.md
Открыть на GitHub

Что делает 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/

Вопросы об 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

Похожие слэш-команды

Все слэш-команды по теме «Тексты и документация» →
doc-updater Affaan Mustafa doc-updater — субагент Claude Code, который синхронизирует документацию и карты архитектуры с кодовой базой. Обновляет устаревшие README.md и схемы. CX Codex ★ 6 739звёзд репо update assistant-ui Скилл update для Claude Code обновляет существующее приложение assistant-ui и проводит через миграции AI SDK и API assistant-ui. Он подключается при обновлении пакетов или ошибках типов после него. CX Codex +1 6 100установок session-log-canvas-update microsoft Скилл session-log-canvas-update сверяет схемы событий сессий Copilot с базовой структурой канваса. Помогает адаптировать парсер, тесты и отображение к новым релизам. CX Codex +1 ★ 1 627звёзд репо prisma-upgrade-v7 prisma Скилл prisma-upgrade-v7 для Claude Code описывает переход с Prisma ORM v6 на v7: генератор, драйверы, ESM-конфиг и импорты. Включают при обновлении Prisma или разборе ошибок v7. CX Codex +1 425 400установок update-implementation-plan официальный github Скилл update-implementation-plan для GitHub Copilot обновляет план реализации под новые требования, рефакторинг, обновление пакетов и изменения архитектуры. Превращает план в исполнимый список задач. CX Codex +1 11 107установок migrate-ai-sdk-v6-to-v7 vercel Скилл migrate-ai-sdk-v6-to-v7 переводит проекты с Vercel AI SDK 6.x на версию 7.0. Помогает обновить зависимости, исправить сломанные типы и заменить устаревшие параметры вызовов. CX Codex +1 6 000установок

Из того же набора44

Весь набор →
test-coverage Команда test-coverage прогоняет тесты с отчётом покрытия, находит файлы ниже 80% и дописывает недостающие юнит-, интеграционные и E2E-тесты. CX Codex +1 ★ 880звёзд репо build-fix Команда build-fix по очереди находит и правит ошибки сборки TypeScript. Она запускает npm или pnpm, показывает контекст кода и проверяет исправление повторным билдом. CX Codex +1 ★ 880звёзд репо update-docs Команда update-docs пересобирает docs/CONTRIB.md и docs/RUNBOOK.md из package.json и .env.example и заодно показывает, какие файлы в docs устарели. CX Codex +1 ★ 880звёзд репо testing Правило testing задаёт строгий TDD-процесс для Claude Code: планку покрытия от 80%, три уровня проверок и сценарии Playwright. CX Codex +1 ★ 880звёзд репо refactor-clean Команда refactor-clean ищет мёртвый код, предлагает безопасное удаление и проверяет тесты до и после каждого изменения. CX Codex +1 ★ 880звёзд репо date-calculation Правило date-calculation запрещает ассистенту считать даты в уме и заставляет вызывать системные утилиты вроде date или python3. Страхует от ошибок при вычислении дней недели, високосных годов и интервалов. CX Codex +1 ★ 880звёзд репо korean-character-count Скилл korean-character-count считает символы, строки и байты корейского текста по правилам графемных кластеров — для самопрезентаций и форм с лимитами. CX Codex +1 ★ 880звёзд репо loop-forge Команда loop-forge превращает краткое описание рутинного действия в готовую слэш-команду с проверками безопасности и точками остановки. CX Codex +1 ★ 880звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой