# typescript-type-expert

Субагент typescript-type-expert помогает проектировать сложные типы в TypeScript, исправлять рекурсию и ошибки инференса в дженериках.

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

## Что делает

Субагент специализируется на программировании на уровне типов: шаблонных литералах, условных типах и брендировании. Внутри заложены готовые шаблоны решений для 18 типичных проблем компилятора, включая ошибки чрезмерной глубины инстанцирования (`Type instantiation is excessively deep and possibly infinite`).

Для предотвращения бесконечной рекурсии субагент выстраивает счётчики глубины через длины кортежей или предлагает уплощение структуры данных. При работе с узкими типами применяются номинальные типы через `unique symbol` и управление дистрибутивностью условных конструкций через оборачивание в кортежи `[T]`.

Без проверки через `tsc --extendedDiagnostics` сложная типовая логика может заметно замедлить сборку проекта.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/typescript/typescript-type-expert.md

## Когда брать
- Ограничить глубину рекурсивных типов через счётчики на кортежах
- Настроить парсинг строк в типах через шаблонные литералы
- Внедрить номинальную типизацию с помощью брендированных типов
- Исправить распределение типов в условных конструкциях

## Примеры запросов агенту
- Помоги ограничить глубину рекурсивного типа `DeepReadonly` до 5 уровней.
- Напиши шаблонный тип для парсинга параметров из роута вида `/api/v1/users/:id`.
- Исправь ошибку компилятора Type instantiation is excessively deep в этом дженерике.

## Похожие
- [typescript-magician](https://affpapa.org/nevibecode/skills/typescript-magician.md) — скилл · 3000 установок
- [typescript](https://affpapa.org/nevibecode/skills/gentleman-programming-typescript.md) — скилл · 500 установок
- [typescript-pro](https://affpapa.org/nevibecode/agents/typescript-pro.md) — субагент · 9602 установки
- [typescript-discriminated-unions](https://affpapa.org/nevibecode/skills/typescript-discriminated-unions.md) — скилл · 4200 установок
- [typescript-patterns](https://affpapa.org/nevibecode/skills/typescript-patterns.md) — скилл · 202 установки
- [typescript-advanced-patterns](https://affpapa.org/nevibecode/skills/curiositech-typescript-advanced-patterns.md) — скилл · 148 установок

Из того же набора: [carlrannaberg/claudekit](https://affpapa.org/nevibecode/by/carlrannaberg/claudekit.md) — 54 карточки

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

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