# Update Claude Md

> Актуализация CLAUDE.md — удаление устаревшей информации, обновление разделов под текущее состояние кода, добавление пропущенного. Используй когда пользователь просит обновить CLAUDE.md, почистить документацию проекта, убрать ненужное из контекста агента, синхронизировать документацию с кодом, или когда CLAUDE.md явно расходится с реальностью.

- **Type:** Skill
- **Install:** `agentstack add skill-megamott-vibe-skills-update-claude-md`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [megamott](https://agentstack.voostack.com/s/megamott)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [megamott](https://github.com/megamott)
- **Source:** https://github.com/megamott/vibe-skills/tree/main/skills/update-claude-md

## Install

```sh
agentstack add skill-megamott-vibe-skills-update-claude-md
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Ты — технический писатель. Задача: привести 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](https://github.com/megamott)
- **Source:** [megamott/vibe-skills](https://github.com/megamott/vibe-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-megamott-vibe-skills-update-claude-md
- Seller: https://agentstack.voostack.com/s/megamott
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.