Módulo 2.1 — O Briefing ICCA

🎯 Intent — o quê e por quê

Declare objetivo e motivo de negócio em 1–3 linhas. Intent alto define a fronteira entre "fazer certo" e "fazer o certo".

💡 Conceito

Intent = What + Why. Sem "Why", o modelo não sabe onde cortar escopo.

✗ Ruim:  "Arruma o login"
✓ Bom:   "Bug: login falha com email maiúsculo. Causa
          reclamação semanal de ~15 usuários. Quero
          normalização case-insensitive na validação."

🚧 Constraints — o que não pode quebrar

Lista de invariantes. Sem constraints, o 4.7 pode refatorar APIs públicas "por iniciativa".

✓ Fazer

✓"Não mudar assinatura de getUser()"
✓"Preservar todos os testes existentes"
✓"Sem alterar schema da tabela users"

✗ Evitar

✗"Seja cuidadoso" (vago)
✗"Não quebre nada" (inútil)
✗"Use boas práticas" (anti-pattern)

✅ Criteria — como saber que terminou

Critério verificável, idealmente binário. Sem critério, o modelo para quando "sente" que terminou.

Critério de aceite:
- `npm test auth/` passa sem falhas novas
- `curl -X POST /login -d '{"email":"Foo@X.com"}'` retorna 200
- Diff envolve ≤ 3 arquivos
- Nenhuma mudança em schema.sql

💡 Dica

Peça ao 4.7: "antes de terminar, verifique contra o critério acima". Isso ativa auto-check sem scaffolding antigo.

📁 Arquivos — onde procurar e mexer

Liste caminhos absolutos dos arquivos a ler, modificar e testar. Economiza ~5k tokens de busca inicial.

Arquivos:
- LER:      /src/auth/validators.ts, /src/auth/login.ts
- MEXER:    /src/auth/validators.ts
- TESTAR:   /tests/auth/login.test.ts
- IGNORAR:  /src/auth/oauth/* (não é esse fluxo)

🧩 A ordem importa?

Sequência recomendada: Intent → Arquivos → Constraints → Criteria.

Intent primeiro

Ancora o objetivo antes dos detalhes.

Arquivos em seguida

Amarra contexto concreto cedo, reduz especulação.

Constraints

Define guarda-corpos antes da ação.

Criteria por último

Fecha com teste de aceitação — fica fresh no fim.

📏 Quantas linhas tem um bom briefing?

Tipo de tarefa	Linhas ideais	Sinal de problema
Bug fix simples	8–20	<5: drip-feed. >30: over-spec
Feature	20–60	>100: quebrar em 2
Migração	60–120	>200: falta um doc linkado
Review/análise	10–30	Intent confuso se >40

🚫 Anti-patterns

Três frases que ainda aparecem em briefings ruins e que o 4.7 interpreta mal:

✗ "Olha isso"

Zero intent. O modelo adivinha — e adivinha errado.

✗ "Arruma"

Sem critério, "arrumado" vira qualquer coisa.

✗ "Use boas práticas"

Convida over-engineering. 4.7 executa literal e inventa padrões.

📋 Resumo do Módulo

✓

ICCA — Intent, Constraints, Criteria, Arquivos

✓

Densidade > quantidade — cada linha deve ganhar seu lugar

✓

Ordem sugerida — I → A → C → C

✓

Anti-patterns — "olha", "arruma", "boas práticas"

Próximo Módulo:

2.2 — Templates ICCA Prontos

← Módulo Anterior Próximo Módulo →