| name | update-claude-md |
| description | Актуализация CLAUDE.md — удаление устаревшей информации, обновление разделов под текущее состояние кода, добавление пропущенного. Используй когда пользователь просит обновить CLAUDE.md, почистить документацию проекта, убрать ненужное из контекста агента, синхронизировать документацию с кодом, или когда CLAUDE.md явно расходится с реальностью. |
Ты — технический писатель. Задача: привести CLAUDE.md в соответствие с реальным состоянием кодовой базы. CLAUDE.md — это контекст для AI-агента, не для людей: он должен быть точным, кратким и актуальным.
Алгоритм работы
Шаг 1: Прочитать текущий CLAUDE.md
Прочитай CLAUDE.md в корне проекта целиком. Выпиши из него:
- Какие разделы есть.
- Какие конкретные утверждения о коде/архитектуре/стеке делаются.
- Какие пути к директориям, файлам, командам упоминаются.
Шаг 2: Исследовать текущее состояние кода
Для каждого утверждения из CLAUDE.md найди подтверждение в коде. Универсальные источники истины:
- Стек и зависимости — манифест зависимостей проекта (
package.json, pyproject.toml, go.mod, Cargo.toml, pom.xml и т.д.).
- Точки входа / внешние интерфейсы — соответствующие директории (контроллеры, роутеры, CLI-команды, обработчики очередей).
- Структура проекта — реальное дерево директорий первого-второго уровня.
- Команды разработки — таск-раннер проекта (
Justfile, Makefile, package.json:scripts, и т.д.).
- Архитектурные единицы (агрегаты/модули/сервисы/пакеты) — посмотреть содержимое соответствующих директорий.
Не хардкодь конкретные пути или команды — каждый раз определяй их из текущего состояния проекта.
Шаг 3: Выявить расхождения
По каждому разделу CLAUDE.md фиксируй:
- Устарело: есть в CLAUDE.md, нет в коде
- Неверно: описано не так, как реально работает
- Пропущено: есть в коде, отсутствует в CLAUDE.md (важное)
Критерий важности для добавления: информация, которая нужна агенту чтобы не делать ошибок или не переспрашивать. Не добавляй всё подряд — только то, что влияет на решения.
Шаг 4: Подготовить список изменений
Перед правкой покажи пользователю список:
УДАЛИТЬ:
- [раздел/строка]: причина
ОБНОВИТЬ:
- [раздел]: что устарело → что актуально
ДОБАВИТЬ:
- [раздел]: что и зачем
Дождись подтверждения (или пропусти этот шаг если пользователь сказал «просто обнови»).
Шаг 5: Применить изменения
Правь CLAUDE.md через Edit tool точечно, не переписывая весь файл целиком.
Принципы:
- Сохраняй структуру разделов если она логична
- Сохраняй инструкции для агента (языковые настройки, порядок вызова скиллов и т.д.)
- Убирай капитан-очевидность — то, что видно из самого кода
- Убирай дублирование между CLAUDE.md и
.claude/rules/*.md
- Структура кода: обновляй только если изменения существенные (новые модули, удалённые модули)
Что не трогать
- Языковые настройки и инструкции по поведению агента
- Раздел «Оркестратор скиллов» и аналогичные мета-инструкции
- Вещи, которые не выводимы из кода: бизнес-контекст, причины архитектурных решений, неочевидные ограничения, подводные камни
Формат итогового ответа
После всех правок:
Обновлён CLAUDE.md:
- Удалено: [краткий список]
- Обновлено: [краткий список]
- Добавлено: [краткий список]
