# docs-drift-editor

Обновляет Markdown-страницы, которые разошлись с кодом, и не выдумывает команды и ссылки, которых нет в диффе.

- субагент · `type=agent` · Claude Code · ★ 26065
- Автор: VoltAgent Community
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-claude-code-subagents/tree/HEAD/categories/06-developer-experience/docs-drift-editor.md
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/agents/docs-drift-editor

## Что делает

Субагент работает как шаг исполнения в конвейере поиска расхождений: список страниц и причины уже определены выше, ему остаётся внести минимальную правку. Он читает файл, находит места, где упомянут переименованный символ или удалённый API, и меняет только их. Проза вокруг остаётся нетронутой.

Правки идут в изолированном git worktree, поэтому рабочее дерево вызывающего не затрагивается. Перед редактированием агент считает строки файла: если правка затронет больше примерно 40% файла, он не переписывает раздел, а оставляет комментарий `<!-- TODO(docs-sync): section needs manual review after <symbol> was changed -->` и помечает страницу пропущенной. Заголовки не добавляются, не удаляются и не меняются местами; при переименовании заголовка старый якорь сохраняется HTML-комментарием, чтобы входящие ссылки не сломались.

Команды установки, URL и номера версий берутся только из диффа, README, `package.json` или самой страницы. Если источник расплывчат, агент пишет указатель на README вместо догадки. На выходе — один JSON-объект со списками `edited` и `skipped`, без пояснений текстом. Целый файл через `Write` не заменяется: только точечные `Edit`, чтобы ревьюер видел маленький дифф.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add VoltAgent/awesome-claude-code-subagents
```
В чате агента (не в терминале):
```text
/plugin install voltagent-dev-exp@voltagent-subagents
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/docs-drift-editor.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/docs-drift-editor.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/docs-drift-editor.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-claude-code-subagents/tree/HEAD/categories/06-developer-experience/docs-drift-editor.md

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

## Примеры запросов агенту
- Дифф переименовал `createSession` в `initSession`, обнови `docs/api/sessions.md` в worktree `/tmp/docs-drift-wt-3`
- Вот дифф и список разошедшихся страниц — внеси минимальные правки и верни JSON-отчёт
- Проверь `docs/guides/getting-started.md`: если правка затронет больше 40% файла, оставь TODO и пометь страницу пропущенной

## Похожие
- [update-docs](https://affpapa.org/nevibecode/commands/update-docs.md) — команда · 3861 установка
- [docs-write](https://affpapa.org/nevibecode/skills/docs-write.md) — скилл · 2100 установок
- [qt-cpp-docs](https://affpapa.org/nevibecode/skills/qt-cpp-docs.md) — скилл · 782 установки
- [qt-qml-docs](https://affpapa.org/nevibecode/skills/qt-qml-docs.md) — скилл · 717 установок
- [write-docs](https://affpapa.org/nevibecode/skills/write-docs.md) — скилл · 693 установки
- [backend-to-frontend-handoff-docs](https://affpapa.org/nevibecode/skills/backend-to-frontend-handoff-docs.md) — скилл · 164 установки

Из того же набора: [voltagent/awesome-claude-code-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-claude-code-subagents.md) — 143 карточки

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

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