# update-docs

Слэш-команда проходит по specs/, CLAUDE.md и README.md, отмечает выполненное и обновляет проценты готовности проекта.

- команда · `type=command` · Claude Code · 3861 установка
- Автор: davila7
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/documentation/update-docs.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/update-docs

## Что делает

Команда собирает текущее состояние документации: ищет markdown-файлы, считает статусные метки в `docs/` и `specs/`, смотрит свежие коммиты по `*.md` за неделю. Дальше сверяет написанное с тем, что реально сделано в последней фазе, и правит расхождения.

Обновляет она четыре вещи: документ фазы, `specs/implementation_status.md`, спецификации реализации и корневые `CLAUDE.md` с `README.md`. Выполненные пункты помечаются ✅, проценты пересчитываются, к сложным компонентам дописываются пояснения. Новые файлы спецификаций команда не создаёт — только правит существующие в `specs/`. Это стоит держать в голове, если вы ждёте от неё генерации структуры с нуля.

Аргумент задаёт режим: `--implementation`, `--api`, `--architecture`, `--sync` или `--validate`. Инструменты ограничены `Read`, `Write`, `Edit` и `Bash`, так что правки идут прямо в файлы. В конце команда выдаёт сводку: что обновлено, какие проценты стали, какие практики записаны.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --command documentation/update-docs
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/update-docs.md` — Вызов — /update-docs. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/update-docs.md` — Вызов — /prompts:update-docs. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/update-docs.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/update-docs.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/documentation/update-docs.md

## Когда брать
- отметить выполненные задачи фазы и пересчитать проценты готовности
- сверить спецификацию с тем, что реально закодили
- дописать в `CLAUDE.md` новые практики и известные ограничения
- обновить раздел про API после изменений в интерфейсах
- привести `testing_plan.md` в соответствие со свежими прогонами тестов

## Примеры запросов агенту
- /update-docs --implementation
- /update-docs --api
- /update-docs --sync

## Похожие
- [update-docs-on-code-change](https://affpapa.org/nevibecode/rules/update-docs-on-code-change.md) — правило · ★ 40418
- [docs-write](https://affpapa.org/nevibecode/skills/docs-write.md) — скилл · 2100 установок
- [create-tldr-page](https://affpapa.org/nevibecode/skills/create-tldr-page.md) — скилл · 8800 установок
- [update-llms](https://affpapa.org/nevibecode/skills/update-llms.md) — скилл · 8800 установок
- [convert-plaintext-to-md](https://affpapa.org/nevibecode/skills/convert-plaintext-to-md.md) — скилл · 9000 установок
- [revise-claude-md](https://affpapa.org/nevibecode/commands/revise-claude-md.md) — команда · ★ 44635

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 205 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md