# typescript-documentation-expert

Субагент typescript-documentation-expert пишет документацию по проекту на TypeScript: разбирает структуру и архитектуру, готовит API-справочники, ADR и руководства по установке.

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

## Что делает

Субагент читает проект на TypeScript и превращает его в набор документов. Сначала разбирает структуру: `package.json`, `tsconfig.json`, модули и границы пакетов. Потом вытаскивает архитектурные решения и паттерны, которые видны в коде, и раскладывает результат по четырём уровням: для заказчика, для архитектора, для разработчика и для технического писателя.

Внутри два скилла, `typescript-docs` и `clean-architecture`, и модель sonnet. Инструменты только на чтение: `Read`, `Glob`, `Grep` и `Bash`. Файлы субагент не создаёт, готовые тексты отдаёт в ответ, сохранять их придётся самому.

Покрывает то, что обычно и просят: REST, GraphQL и tRPC, ORM вроде TypeORM, Prisma и Mongoose, фронтенд на React, Next.js, Vue и Angular, конфиг TypeDoc и ADR. Чем больше в проекте разнородных слоёв, тем полезнее: на одном `index.ts` ему нечего анализировать.

## Установка

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

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- собрать ADR по решениям, которые уже видны в коде
- описать tRPC-процедуры и схемы GraphQL
- настроить TypeDoc и получить справочник по типам
- объяснить слои Clean Architecture новому разработчику
- сделать вводную по стеку для заказчика

## Примеры запросов агенту
- Разбери `src/` и собери ADR по архитектурным решениям, которые найдёшь.
- Опиши tRPC-роутеры в `src/server/api` и сделай справочник процедур.
- Сгенерируй конфиг TypeDoc и черновик API-документации для пакета `packages/core`.

## Похожие
- [create-architecture-documentation](https://affpapa.org/nevibecode/commands/create-architecture-documentation.md) — команда · 6136 установок
- [code-documentation-code-explain](https://affpapa.org/nevibecode/skills/code-documentation-code-explain.md) — скилл · 1000 установок
- [code-documentation-docs-architect](https://affpapa.org/nevibecode/agents/code-documentation-docs-architect.md) — субагент · ★ 42780 у репозитория
- [documentation-and-adrs](https://affpapa.org/nevibecode/skills/documentation-and-adrs.md) — скилл · 80700 установок
- [Documentation Architect](https://affpapa.org/nevibecode/skills/documentation-architect.md) — скилл · 1 установка
- [catalog-documentation-creator](https://affpapa.org/nevibecode/skills/catalog-documentation-creator.md) — скилл · 1400 установок

Из того же набора: [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
