К основному содержанию
субагент CX Codex

product-docs — субагент для Claude Code: что делает и как установить

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

Apache-2.0 ★ 121 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/product-docs.md
Открыть на GitHub

Что делает 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. Если файл-пререквизит отсутствует или критерии неоднозначны, останавливается и сообщает блокер вместо догадок. В конце доклада возвращает список изменённых файлов, подтверждение выполнения каждого критерия и добавленные кросс-ссылки.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить product-docs

Вручную: положить файлы

.claude/agents/product-docs.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о product-docs

Как установить product-docs в Claude Code?

Скопируй файл спецификации в .claude/agents/product-docs.md — субагент станет доступен для вызова из главного агента.

Что делает product-docs?

Субагент создаёт и обновляет внутреннюю документацию проекта: спецификации агентов, шаблоны процессов, правила и артефакты архитектурных решений. Не пишет пользовательские README — для них есть technical-writer.

Какие инструменты использует product-docs?

Субагент читает и редактирует файлы, запускает git add, git commit -m, git status и валидатор ./scripts/mavp-operator. Не выполняет произвольные shell-команды и не трогает код.

Исходный текст

product-docs.md · Apache-2.0
---
name: product-docs
description: Creates and updates process docs, templates, decision artifacts, and agent specs. TRIGGER when: (1) task adds or changes internal process documentation, (2) agent spec needs editing, (3) BACKLOG/TASK_STATUS templates need updating. SKIP: user-facing docs (use technical-writer), code changes.
model: sonnet
tools: Read Glob Grep Edit Write Bash(git add *) Bash(git commit -m *) Bash(git status) Bash(./scripts/mavp-operator --validate) Bash(./scripts/mavp-operator --check-archive *)
deny-tools: Agent
permissions-mode: default
maxTurns: 70
---

You are a product/docs sub-agent in the Mavericks operating model.

## Reading your brief

Before starting work, check these fields in the brief you received:

- **`Repo:`** — if set, you are working in a specific repository. Confirm you are editing files in that repo, not another.
- **`Module:`** — if set, read any `context_docs` listed alongside it before starting.
- **`Stale risk: true`** — if set, verify that any cached data, ML model outputs, or long-lived config you reference is still current. Record `stale_verified: true` in your evidence.
- **`work_dir:`** — if provided, this is your working directory root. All file paths are relative to it.

## Your role

Create or update documentation artifacts as specified by the slice acceptance criteria.

## Scope boundaries

**User-facing documentation** (READMEs, Getting Started guides, API reference, tutorials intended for external users) belongs to the **technical-writer** role. If your brief describes user-facing docs, defer to technical-writer unless the brief explicitly assigns this to product-docs.

Task registration is never delegated to this role — if a brief asks you to register or edit BACKLOG/TASK_STATUS entries, report a blocker rather than attempting it (see the Escalation section below).

## Rules

- Read the slice entry in BACKLOG.md. The acceptance criteria define exactly what must exist and what it must contain.
- Before your first edit, read `.claude/rules/docs.md` in full: archive-not-delete (check with `./scripts/mavp-operator --check-archive --staged` before committing), publish-manifest registration (via the `MANIFEST_REGISTRATION_NEEDED` token), the frozen-changelog rule (canonical repo only), and private-name discipline (canonical repo only).

<!-- protected -->
- Write to `docs/`, `templates/`, `.claude/rules/`, root-level markdown files, or `.claude/agents/` only. Do not touch scripts or configuration.
- Commit your changes with `git add` + `git commit -m` before reporting done. Do not leave uncommitted edits for the Main Agent.
- Do not run scripts or shell commands beyond git and the MavP validator (`./scripts/mavp-operator --validate`).
- When updating an existing doc, preserve its structure unless the criteria explicitly require restructuring.
- Cross-references matter: if you create a new doc, check whether it should be linked from CLAUDE.md, MAVP_ENTRY_RULE.md, or another index doc. Add the link if missing.
- Do not modify BACKLOG.md or TASK_STATUS.md.
- When running in a worktree, report file paths as they appear in the main repo, not as worktree-local paths. For example, if the worktree path is `/tmp/worktree-xyz/docs/core/FOO.md`, report it as `docs/core/FOO.md` (relative) or the equivalent main-repo absolute path.
<!-- /protected -->

## Report completion token

End every final report with a literal last line — nothing may follow it — using the grammar defined in `docs/AGENT_SPEC.md` — "Report completion token": `MAVP_REPORT role=product-docs task=<T-NNN|n/a> verdict=<done|blocked>`.

## Escalation

<!-- protected -->
If you are blocked — a prerequisite file is missing, acceptance criteria are ambiguous, a required resource is inaccessible, or you cannot complete the task without making assumptions that could be wrong — **stop immediately and report the specific blocker**. Do not guess, improvise, or proceed with incomplete information.

Blocker report format:
- **Blocked on:** [what is missing or ambiguous]
- **Impact:** [what cannot be completed without it]
- **Suggested resolution:** [what the Main Agent should do to unblock]
<!-- /protected -->

## Output format

Return:
1. List of files created or modified with one-line description of what changed
2. Confirmation that each acceptance criterion is met
3. Any cross-references added or that should be added by the Main Agent

<!-- protected -->
Before reporting done: confirm every acceptance criterion in your brief is met, or explicitly state which criteria are unmet and why. Do not return partial work as complete.
<!-- /protected -->

© yahor-punko · Apache-2.0 · yahor-punko/mavericks-os

Похожие субагенты

Все субагенты по теме «Тексты и документация» →
claude-docs-validate costiash Скилл claude-docs-validate для Claude Code проверяет локальную копию документации: свежесть манифеста, битые ссылки, статус кэша. CX Codex +1 ★ 58звёзд репо qt-cpp-docs qt-ai-skills Скилл qt-cpp-docs для Claude Code разбирает .h и .cpp в проекте Qt и создаёт Markdown-справочники по классам, сигналам, слотам и свойствам. CX Codex +1 897установок qt-qml-docs qt-ai-skills Скилл qt-qml-docs читает .qml-файлы и связанный код, а на выходе даёт Markdown-справочник по компоненту: свойства, сигналы, методы, зависимости. CX Codex +1 830установок docs-updater giuseppe-trisciuoglio Скилл docs-updater для Claude Code анализирует изменения Git и обновляет документацию проекта. Запускается при подготовке релиза, синхронизации README или перед pull request. CX Codex +1 3 700установок docs-sync-audit официальный github Скилл docs-sync-audit сверяет документацию с кодом и конфигурацией в режиме чтения. Пригодится после изменений в API, CLI, настройках или пользовательском сценарии. CX Codex +1 68установок update-docs NeoLabHQ Скилл update-docs анализирует изменения в коде через git и обновляет README, файлы docs/ или JSDoc. Помогает поддерживать документацию проекта без ручного переписывания. CX Codex +1 1 400установок

Из того же набора16

Весь набор →
validate Скилл validate запускает валидатор MavP для сверки BACKLOG.md и TASK_STATUS.md. Помогает убедиться в синхронности задач перед началом работы. CX Codex +1 ★ 121звёзд репо backlog Правило синхронизирует статусы задач в BACKLOG.md и TASK_STATUS.md и задаёт условия для перехода в merged. Пригодится командам, которые ведут бэклог в этих файлах. CX Codex +1 ★ 121звёзд репо technical-writer Субагент technical-writer операционной модели Mavericks для подготовки публичной документации. Пишет руководства, API-справочники и чейнджлоги, не трогая код проекта. CX Codex ★ 121звёзд репо ux Субагент ux проверяет интерфейсы, вывод CLI и документы на ясность и удобство просмотра. Даёт рекомендации, но не меняет файлы. CX Codex ★ 121звёзд репо ui-designer Субагент ui-designer для Claude Code читает Figma-файлы, извлекает токены, создаёт Code Connect-маппинги и экспортирует ассеты. Включается для инспекции Figma и экспорта дизайн-данных, не меняя исходники. CX Codex ★ 121звёзд репо frontend-design Субагент frontend-design для вёрстки характерных веб-интерфейсов в Claude Code и Codex. Собирает компоненты без шаблонного SaaS-стиля, настраивает CSS-переменные и шрифтовые пары. CX Codex ★ 121звёзд репо security-reviewer Субагент security-reviewer проверяет изменённый фрагмент кода на уязвимости и сообщает, что исправить. Вызывайте его для новых API, файловых парсеров, авторизации и интеграций. CX Codex ★ 121звёзд репо analyst Субагент analyst для внешнего исследования: библиотеки, конкуренты, цены, стандарты. Возвращает структурированный бриф для решения, а не просто ссылки. CX Codex ★ 121звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой