# document-generator-expert

Субагент document-generator-expert генерирует технические отчёты, спецификации функций, регламенты процессов и оценки кодовой базы на основе файлов проекта.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-core/agents/document-generator-expert.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/document-generator-expert

## Что делает

Субагент изучает репозиторий с помощью инструментов `Read`, `Glob`, `Grep` и терминала `Bash`, чтобы собрать контекст перед написанием текстов. В его структуру заложены готовые шаблоны для четырёх основных типов документов: технических оценок, продуктовых спецификаций (FR и TR), аналитических отчётов и стандартных операционных процедур (SOP).

Генерация проходит в четыре этапа: сбор контекста кодовой базы, проектирование структуры, наполнение разделов техническими деталями со схемами Mermaid или PlantUML и итоговая вычитка. Для работы субагенту назначена модель `sonnet`, а в конфигурации заявлены дополнительные навыки `drawio-logical-diagrams`, `docs-updater` и `adr-drafting`.

Тексты формируются на английском по умолчанию, но в инструкциях заложена прямая адаптация под итальянский, испанский, французский, немецкий и португальский языки. Если проект требует русской локализации, субагенту нужно явно задать язык в промпте.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit@developer-kit
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-core/agents/document-generator-expert.md

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

## Примеры запросов агенту
- Проанализируй кодовую базу и составь technical assessment по текущему техническому долгу
- Подготовь feature specification для нового модуля авторизации на основе текущих контроллеров
- Напиши SOP по развёртыванию релиза в формате markdown со схемой шагов

## Похожие
- [utility-mermaid-diagrams](https://affpapa.org/nevibecode/skills/utility-mermaid-diagrams.md) — скилл · 829 установок
- [md-document](https://affpapa.org/nevibecode/skills/md-document.md) — скилл · 49 установок
- [design-doc-mermaid](https://affpapa.org/nevibecode/skills/design-doc-mermaid.md) — скилл · 101800 установок
- [document](https://affpapa.org/nevibecode/skills/rudolf-s-document.md) — скилл · ★ 587 у репозитория
- [GEML — a plain-text document format built to be edited in place, one section at a time](https://affpapa.org/nevibecode/mcp/geml-a-plain-text-document-format-built-to-be-edited-in-place-one-section-at-a-t.md) — MCP-сервер · ★ 31 у репозитория
- [kb-document](https://affpapa.org/nevibecode/skills/kb-document.md) — скилл · ★ 45 у репозитория

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

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

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