# Specsfy Specialist Typescript

> Modelar e revisar TypeScript seguro com strictness, narrowing, generics, modules, declarations, validação runtime e APIs públicas. Use para tsconfig, tipos, erros de compilação, bibliotecas ou contratos TS/JS; não confunda tipos estáticos com validação de dados externos.

- Skill: `promovaweb/specsfy-specialist-typescript` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add promovaweb/specsfy-specialist-typescript`
- Raw SKILL.md: https://api.skillmd.com/api/skills/promovaweb/specsfy-specialist-typescript/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools, Web & Frontend
- Author: promovaweb (https://skillmd.com/u/promovaweb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/promovaweb/specsfy-specialist-typescript

---


# TypeScript

## Fluxo

1. Ler `tsconfig`, package type, bundler, runtime e versões.
2. Identificar fronteiras não confiáveis e tipos públicos.
3. Modelar estados válidos com unions, narrowing e invariantes.
4. Inferir internamente e anotar APIs onde o contrato precisa ser estável.
5. Eliminar `any`, assertions e `!` injustificados na área alterada.
6. Validar dados externos em runtime antes de tipá-los.
7. Rodar typecheck, testes, lint e build nos targets reais.

## Padrões

- Ativar opções strict compatíveis e corrigir erros sem casts cosméticos.
- Preferir unions discriminadas a combinações inválidas de booleanos.
- Usar `unknown` em fronteiras e narrowing explícito.
- Manter generics mínimos e vinculados a relações reais entre valores.
- Evitar enums quando objetos literais ou unions preservam interoperabilidade.
- Separar type-only imports e respeitar ESM/CJS do projeto.
- Testar tipos públicos quando regressões de inferência forem relevantes.

## Validação

- Typecheck sem emissão e build de todos os targets.
- Testes runtime das validações e serialização.
- API declarations quando biblioteca; compatibilidade de consumers.
- Busca focal por suppressions, casts duplos e tipos duplicados.

Leia [references/standards.md](references/standards.md) para modelagem,
configuração, módulos, bibliotecas e validação runtime.