# agent-6-docs-writer

Субагент agent-6-docs-writer для роя контрибьюторов, который обновляет README, документацию API, комментарии и CHANGELOG на основе изменений в кодовой базе.

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

## Что делает

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

Для работы агенту необходима файловая структура роя: манифест задачи `issue-analysis.json` от Агента 2, карта репозитория от Агента 3 и список правок `code-changes.json` от Агента 4. Без этих входных JSON-файлов в папке `./workspace/` субагент не сможет сопоставить изменения с текущими документами.

Результаты работы сохраняются в `./workspace/docs-changes.json` со статусом, списком изменённых файлов, описанием правок и валидацией ссылок и примеров.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/agents/agent-6-docs-writer.md

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

## Примеры запросов агенту
- Проверь изменения в `code-changes.json` и обнови README.md с примерами использования новой функции
- Запусти субагента agent-6-docs-writer для анализа влияния правок на API docs
- Сформируй отчёт `docs-changes.json` и добавь запись в CHANGELOG.md

## Похожие
- [ns-docs-writer](https://affpapa.org/nevibecode/skills/ns-docs-writer.md) — скилл · 151 установка
- [docs-writer](https://affpapa.org/nevibecode/skills/docs-writer.md) — скилл · ★ 7191 у репозитория
- [tech-docs-writer](https://affpapa.org/nevibecode/agents/tech-docs-writer.md) — субагент · ★ 1064 у репозитория
- [wiki-writer](https://affpapa.org/nevibecode/agents/wiki-writer.md) — субагент · ★ 3232 у репозитория
- [technical-writer](https://affpapa.org/nevibecode/agents/yahor-punko-technical-writer.md) — субагент · ★ 121 у репозитория
- [slack-docs](https://affpapa.org/nevibecode/skills/slack-docs.md) — скилл · 4300 установок

Из того же набора: [happycapy-ai/happycapy-skills](https://affpapa.org/nevibecode/by/happycapy-ai/happycapy-skills.md) — 41 карточка

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

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