Update 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:
- Удалено: [краткий список]
- Обновлено: [краткий список]
- Добавлено: [краткий список]

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: megamott
• Source: megamott/vibe-skills
• License: MIT

Install and usage instructions live in the source repository linked above.