documentation-expert — субагент для Claude Code: установка
Субагент создаёт, обновляет и поддерживает документацию проекта, включая README, API-описания и руководства. Пригодится для работы с документацией из кода.
npx claude-code-templates@latest --agent expert-advisors/documentation-expertЧто делает documentation-expert
documentation-expert помогает писать и поддерживать техническую документацию проекта. Он работает с README, CONTRIBUTING и USAGE, описывает новые функции и API, улучшает существующие тексты, создаёт руководства и учебные материалы. Также субагент умеет формировать документацию по комментариям в коде.
В его набор входят Read, Write, Edit, Glob, Grep, WebFetch и WebSearch. Для структуры он использует подход Diátaxis: разделяет учебные материалы, инструкции, справку и объяснения. В процесс Docs as Code входят проверка ссылок, Markdown- и prose-лингтеры, а также ревью изменений вместе с кодом.
У субагента нет Bash, поэтому он не запускает линтеры сам. Проверку корректности кода он передаёт code-reviewer или architect-reviewer, а вопросы конфигурации Docusaurus — docusaurus-expert.
Какие задачи решает
- создать README для проекта или новой функции
- обновить устаревшее описание API
- сформировать документацию по комментариям в коде
- написать руководство или учебный материал
- проверить структуру и ссылки в документации
Примеры запросов агенту
- Используй субагента
documentation-expert, чтобы создать README для этого проекта. - Попроси
documentation-expertобновить описание нового API и сверить его со структурой проекта. - Пусть
documentation-expertподготовит руководство для новой функции на основе кода и существующих документов.
Как установить documentation-expert
1Через claude-code-templates
npx claude-code-templates@latest --agent expert-advisors/documentation-expert2Вручную: положить файлы
.claude/agents/documentation-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/documentation-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/documentation-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о documentation-expert
Как установить documentation-expert в Claude Code?
Выполни npx claude-code-templates@latest --agent expert-advisors/documentation-expert, затем используй файл .claude/agents/documentation-expert.md.
Что делает documentation-expert?
Субагент создаёт, редактирует и поддерживает документацию проекта: README, API-описания, руководства, учебные материалы и комментарии к коду. Он также помогает выстроить структуру документации по Diátaxis.
Может ли documentation-expert сам запустить линтеры?
Нет. У субагента нет Bash, поэтому он может рекомендовать проверки Vale, alex и markdownlint, но не запускает их сам.
