# schematize-node

> Skill normativa para Claude Code de MANUTENÇÃO de legado Node.js/TypeScript —
> não para criar serviço backend novo (isso é Go/Rust: ver schematize-go/rust).
> Governa manter bem o que já roda em Node/TS e conduzir a saída para Go/Rust
> (strangler-fig): regra escoteiro (escopo-diff), higiene de npm, TypeScript
> estrito incremental, riscos de runtime, archive obrigatório. Nova funcionalidade
> NUNCA nasce em Node. Frontend Node (Next/Astro) fica no schematize-web.

## Install
- Clonar e instalar (projeto): `git clone https://github.com/schematizeme/skill-node.git && ./skill-node/install.sh`
- Global (em ~/.claude): `git clone https://github.com/schematizeme/skill-node.git && ./skill-node/install.sh ~`
- Pronta para instalar (.zip): https://github.com/schematizeme/skill-node/releases/latest/download/skill-node.zip
- Versão fixa (.zip): https://github.com/schematizeme/skill-node/releases/download/v0.4.0/skill-node.zip
- Código-fonte / todos os .md (.zip): https://github.com/schematizeme/skill-node/archive/refs/tags/v0.4.0.zip
- Repositório (navegar/clonar): https://github.com/schematizeme/skill-node

## Após instalar
- Comando de ajuda na sessão do Claude Code: `/node-help`
- Copie a regra sempre-on para a raiz do repo: `.claude/skills/schematize-node/assets/CLAUDE.md` -> `CLAUDE.md`
- Em repo multi-linguagem, `/node-claude` MESCLA o CLAUDE.md (não sobrescreve go/rust/web).

## Comandos
- /node-help — lista todos os comandos
- /node-audit — higiene de dependências (npm audit, contagem de pacotes) e riscos do runtime
- /node-migrate-status — estado da saída Node → Go/Rust (o que migrou, o que falta)
- /node-review — gate de escopo-diff e anti-padrões no diff (não reprova dívida herdada)
- /node-qa — fluxo de Q.A. plan-first (aprovação antes de rodar)
- /node-index — (re)gera o índice de microfunções
- /node-load — carrega o corpo normativo completo da skill na sessão
- /node-claude — cria/mescla a regra sempre-on (CLAUDE.md) na raiz do repo
- /node-cc — context compact (gera handoff e roda /compact)
- /node-handoff — gera handoff sem compactar

## Pisos inegociáveis
- Nenhum backend novo em Node; nova funcionalidade nasce em Go/Rust (schematize-go/rust).
- Regra escoteiro: pisos de qualidade valem para arquivo novo e o trecho tocado; dívida herdada entra em baseline que só decresce.
- Higiene de npm: ≥200 dependências = lixo, >100 = questionável. any/@ts-ignore novos vetados (os antigos, grandfathered).
- TypeScript estrito incremental; saída strangler-fig na fronteira de processo, sem SLA forçado.
- Arquivos ≤300 linhas + doc-comment + MAPA + índice; archive obrigatório.

## Formato
Skill no padrão aberto Agent Skills. Funciona em Claude Code, Claude.ai e API.
Irmã de https://skills.schematize.me/go (Go), https://skills.schematize.me/rust (Rust)
e https://skills.schematize.me/web (frontend). Node backend está em saída — esta skill
é de manutenção e migração, não de green-field.