# docs-sync

Команда docs-sync сравнивает свежие изменения кода с документацией и выявляет несоответствия. Помогает найти устаревшие примеры, неправильные сигнатуры API и несовпадения в типах параметров.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 6091 у репозитория
- Автор: ChrisWiles
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ChrisWiles/claude-code-showcase/tree/HEAD/.claude/commands/docs-sync.md
- Обновлён: 2026-01-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/docs-sync

## Что делает

docs-sync анализирует коммиты за последний месяц, ищет затронутые файлы и находит связанную документацию в `/docs/`, README рядом с кодом и комментариях TSDoc. Затем проверяет, совпадают ли примеры в документации с текущей реализацией, актуальны ли описания функций и типы свойств.

Команда работает с Git — получает список изменённых файлов через `git log` и сравнивает их с документацией. Выводит контрольный список того, что нужно обновить. Главное отличие от поиска просто всей документации: команда флагирует только реальные ошибки, не предлагает писать доки ради самих доков.

## Установка

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

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ChrisWiles/claude-code-showcase/tree/HEAD/.claude/commands/docs-sync.md

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

## Примеры запросов агенту
- Проверь документацию на синхронизацию с кодом
- Что нужно обновить в доках после моих правок?
- Сравни docs с последними изменениями в коде

## Похожие
- [docs-sync-audit](https://affpapa.org/nevibecode/skills/docs-sync-audit.md) — скилл · 68 установок
- [sync](https://affpapa.org/nevibecode/commands/florianbruniaux-sync.md) — команда · ★ 6529 у репозитория
- [docs-updater](https://affpapa.org/nevibecode/skills/docs-updater.md) — скилл · 3700 установок
- [docs-curator](https://affpapa.org/nevibecode/agents/docs-curator.md) — субагент · ★ 1472 у репозитория
- [update-project-docs](https://affpapa.org/nevibecode/skills/update-project-docs.md) — скилл · ★ 1198 у репозитория
- [docs-guard](https://affpapa.org/nevibecode/skills/docs-guard.md) — скилл · 4200 установок

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

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