# doc-updater

Субагент doc-updater для Claude Code пересобирает README, гайды и кодмапы по файлам проекта после правок кода. Обновляет документацию, разошедшуюся с кодом.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 880 у репозитория
- Автор: sangrokjung
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sangrokjung/claude-forge/tree/HEAD/agents/doc-updater.md
- Обновлён: 2026-09-03
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/doc-updater

## Что делает

Субагент читает код, а не память: кодмапы, README и гайды он собирает заново по файлам проекта. Работает в фоне на модели haiku, до 15 ходов, память проектная — после рефакторинга не нужно просить отдельно, изменения он подхватит сам.

Внутри четыре шага. Сначала структура репозитория: воркспейсы, точки входа, паттерны фреймворка. Потом разбор модулей — экспорты, импорты, роуты, модели, воркеры. Дальше генерация `INDEX.md` и карт по областям с ASCII-схемами и таблицами модулей, каждая не длиннее 500 строк. Замыкает проверка: пути существуют, ссылки открываются, примеры кода собираются, отметки времени обновлены. Тяжёлую сборку через Bash делают `madge` и `jsdoc2md`.

Инструменты ограничены набором Read, Write, Edit, Bash, Grep, Glob. Отчёт выходит фиксированной формы: область работы, обновлённые и созданные файлы, список изменений и чек-лист проверок. Документ, который расходится с кодом, хуже отсутствующего — на этом правиле агент и держится.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sangrokjung/claude-forge/tree/HEAD/agents/doc-updater.md

## Когда брать
- пересобрать кодмап после переезда модулей
- обновить README, когда команды запуска поменялись
- найти битые пути и ссылки в гайдах
- разбить кодмап, который перевалил за 500 строк
- сверить примеры кода в документации с текущим исходником

## Примеры запросов агенту
- Обнови README и кодмапы после рефакторинга модуля оплаты
- Сгенерируй `INDEX.md` по реальному коду, а не по памяти
- Проверь пути и ссылки в `docs/` и обнови отметки времени

## Похожие
- [doc-forge](https://affpapa.org/nevibecode/plugins/doc-forge.md) — плагин · ★ 2858 у репозитория
- [docs-updater](https://affpapa.org/nevibecode/skills/docs-updater.md) — скилл · 3700 установок
- [readme-updater](https://affpapa.org/nevibecode/skills/readme-updater.md) — скилл · ★ 788 у репозитория
- [gsd-doc-writer](https://affpapa.org/nevibecode/agents/gsd-doc-writer.md) — субагент · ★ 3785 у репозитория
- [doc-gen](https://affpapa.org/nevibecode/skills/sethgammon-doc-gen.md) — скилл · ★ 937 у репозитория
- [gsd-doc-verifier](https://affpapa.org/nevibecode/agents/gsd-doc-verifier.md) — субагент · ★ 3785 у репозитория

## Другие версии с тем же именем
- [doc-updater · worldflowai](https://affpapa.org/nevibecode/agents/affaan-mustafa-doc-updater.md) — ★ 6739 у репозитория

Из того же набора: [sangrokjung/claude-forge](https://affpapa.org/nevibecode/by/sangrokjung/claude-forge.md) — 44 карточки

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

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