# product-docs

Субагент product-docs создаёт и обновляет внутреннюю документацию проекта: спецификации агентов, шаблоны процессов, артефакты решений.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 121 у репозитория
- Автор: yahor-punko
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/yahor-punko/mavericks-os/tree/HEAD/.claude/agents/product-docs.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/product-docs

## Что делает

Субагент запускается, когда задача требует изменить внутреннюю процессную документацию, отредактировать спецификацию агента или обновить шаблоны `BACKLOG` и `TASK_STATUS`. Работает с файлами в `docs/`, `templates/`, `.claude/rules/` и `.claude/agents/`, не трогая код и скрипты. Перед коммитом проверяет изменения валидатором `./scripts/mavp-operator --validate` и фиксирует правки через `git add` + `git commit -m`. Субагент не пишет пользовательские README и туториалы — это зона technical-writer.

Перед началом работы читает критерии приёмки из `BACKLOG.md` и правила архивирования из `.claude/rules/docs.md`. Если файл-пререквизит отсутствует или критерии неоднозначны, останавливается и сообщает блокер вместо догадок. В конце доклада возвращает список изменённых файлов, подтверждение выполнения каждого критерия и добавленные кросс-ссылки.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/yahor-punko/mavericks-os/tree/HEAD/.claude/agents/product-docs.md

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

## Примеры запросов агенту
- Создай спецификацию субагента для автоматизации релизов по критериям из `BACKLOG.md` слайса T-142
- Обнови шаблон `templates/TASK_STATUS.md` — добавь поле для метки риска устаревания
- Зафиксируй решение о структуре папок агентов в `docs/decisions/ADR-008.md`

## Похожие
- [claude-docs-validate](https://affpapa.org/nevibecode/skills/claude-docs-validate.md) — скилл · ★ 58 у репозитория
- [qt-cpp-docs](https://affpapa.org/nevibecode/skills/qt-cpp-docs.md) — скилл · 897 установок
- [qt-qml-docs](https://affpapa.org/nevibecode/skills/qt-qml-docs.md) — скилл · 830 установок
- [docs-updater](https://affpapa.org/nevibecode/skills/docs-updater.md) — скилл · 3700 установок
- [docs-sync-audit](https://affpapa.org/nevibecode/skills/docs-sync-audit.md) — скилл · 68 установок
- [update-docs](https://affpapa.org/nevibecode/skills/update-docs.md) — скилл · 1400 установок

Из того же набора: [yahor-punko/mavericks-os](https://affpapa.org/nevibecode/by/yahor-punko/mavericks-os.md) — 16 карточек

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

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