# docs-maintenance

Команда проверяет документацию, ссылки, структуру и стиль, а затем помогает подготовить обновления. Пригодится для регулярного аудита Markdown-файлов.

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

## Что делает

\`docs-maintenance` запускает аудит документации и предлагает систему её обслуживания. Команда ищет файлы `*.md` и `*.mdx`, проверяет свежесть, структуру, объём, незаполненные разделы и маркеры `TODO`/`FIXME`. Доступны режимы `--audit`, `--update`, `--validate`, `--optimize` и `--comprehensive`.

В проверку входят внешние и внутренние ссылки, изображения, Markdown-разметка, иерархия заголовков, блоки кода, alt-текст, метаданные, орфография и читаемость. Команда также описывает синхронизацию через Git, отчёты с приоритетами, мониторинг и процедуры отката. Она использует `Read`, `Write`, `Edit`, `Bash` и `Grep`; автоматические подсчёты ориентированы на Markdown и MDX, поэтому документация в других форматах не попадёт в этот поиск.

## Установка

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

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

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Когда брать
- провести аудит Markdown-документации
- найти битые ссылки и отсутствующие изображения
- проверить структуру заголовков и форматирование
- собрать отчёт по незаполненным разделам
- подготовить правила регулярного обновления docs

## Примеры запросов агенту
- Запусти аудит документации проекта с помощью `/docs-maintenance --audit`.
- Проверь ссылки, изображения и Markdown-разметку через `/docs-maintenance --validate`.
- Подготовь систему обслуживания документации и отчёт с приоритетами через `/docs-maintenance --comprehensive`.

## Похожие
- [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