📋 Templates ICCA Prontos

# INTENT
Bug: [sintoma em 1 frase]
Impacto: [quem é afetado, com que frequência]
Repro: [passos ou curl/payload]

# ARQUIVOS
- Suspeitos: [paths]
- Teste que deve passar: [path::caso]

# CONSTRAINTS
- Não alterar [assinatura/schema/etc]
- Sem cleanup adjacente

# CRITERIA
- [comando de teste] passa
- Diff ≤ [N] arquivos

# INTENT
Adicionar [feature] para [perfil de usuário]
Motivo de negócio: [uma frase mensurável]
Comportamento esperado: [happy path em 3 linhas]

# ARQUIVOS
- Novos: [paths que serão criados]
- Alterar: [paths]
- Não tocar: [paths relacionados mas fora do escopo]

# CONSTRAINTS
- API pública mantida
- [framework/versão] compatível
- Sem novas deps sem avisar

# CRITERIA
- Testes novos passam: [path]
- Nenhum teste existente quebra
- Feature toggle: [flag] (desativada por padrão)

# INTENT
Entender por que [sintoma]. NÃO corrigir ainda.
Output: 3 hipóteses ranqueadas por probabilidade,
        cada uma com teste de confirmação.

# ARQUIVOS
- Logs: [path]
- Suspeitos: [paths]
- Config relevante: [path]

# CONSTRAINTS
- Não edite código
- Não rode comandos destrutivos

# CRITERIA
- 3 hipóteses concretas
- Cada hipótese com evidência + contra-evidência
- Recomendação final

# INTENT
Refatorar [padrão] para [padrão novo]
Motivo: [dado concreto — 3x copy/paste, DRY, etc]

# ARQUIVOS (todos os call-sites)
- /src/a.ts:42
- /src/b.ts:87
- /src/c.ts:15
(liste TUDO — resultado de grep inclusive)

# CONSTRAINTS
- Comportamento idêntico (testes passam sem mudança)
- Sem renomear funções públicas
- Commit único

# CRITERIA
- `npm test` verde
- `git diff --stat` ≤ 5 arquivos
- Sem `any` novos

# INTENT
Migrar [módulo] de [tech A] para [tech B]
Critério de equivalência: comportamento em [spec link]

# ARQUIVOS
- Origem: [path]
- Destino: [path novo]
- Testes caracterizadores: [path] (criar antes)

# CONSTRAINTS
- Nenhuma regressão nos testes caracterizadores
- API pública inalterada
- Deprecation warning nos call-sites, não remoção

# CRITERIA
- Testes caracterizadores ≥ 20 casos
- Cobertura de linha ≥ 85%
- Doc de migração em /docs/migrations/[nome].md

# INTENT
Integrar com [API Xyz] para [ação específica]

# CONTRATOS
- Endpoint: POST https://api.xyz/v1/...
- Auth: Bearer token via env var X
- Response: { "id": string, "status": enum }
- Rate limit: 60/min
- Idempotency-Key: UUID por request

# ARQUIVOS
- Client: /src/integrations/xyz-client.ts (novo)
- Testes: /tests/integrations/xyz.test.ts

# CONSTRAINTS
- Retry exponencial (max 3) só em 5xx
- Timeout 10s
- Sem fallback silencioso em 4xx

# CRITERIA
- Mock server roda localmente
- Testes cobrem: 200, 4xx, 5xx, timeout
- Nenhum secret hard-coded