Convergencia

---
name: convergencia
description: Use after implementation to compare code against spec/plan/tasks and surface remaining work. Triggers on "/convergencia", "converge a implementação", "código bate com o spec?", "o que falta implementar?", "gap entre código e requisitos". Avalia o estado ATUAL do código contra spec/plano/tarefas, classifica gaps (missing/partial/contradicts/unrequested) e ANEXA tarefas restantes à lista — append-only, nunca reescreve.
---

# Skill: /convergencia — Feche o gap entre spec e código

Feche a distância entre o que spec/plano/tarefas pedem e o que o código
implementa hoje. Os artefatos são a **única fonte de intenção** (com a
constituição como restrição de governança).

## Quando usar (gatilhos)

- "/convergencia"
- "O código bate com o spec?"
- "O que falta implementar?"
- "Converge a implementação com o plano"
- "Lista os gaps entre tarefas e código"

## Exemplo

```text
[parcial] US1/AC2: exportação existe mas sem filtro por data
[faltando] FR-020: nenhuma tarefa cobre "notificar por e-mail"
```

Isto **não** é ferramenta de diff: não usa git, não compara branches, não
rastreia histórico. Avalia o estado presente do código contra os artefatos.

## Restrições de operação

**APPEND-ONLY, NUNCA REESCREVE**. A única escrita permitida é **anexar** uma
nova seção `## Fase N: Convergência` à lista de tarefas. Proibido:

- modificar spec ou plano de qualquer forma;
- reescrever, renumerar, reordenar ou deletar tarefa existente (inclusive de
  fase de convergência anterior);
- criar/modificar/deletar código de aplicação — completar as tarefas anexadas
  é trabalho da fase de implementação.

Se o código já satisfaz tudo: **nenhuma alteração** na lista de tarefas (nem
header vazio) e reporte resultado limpo.

**Constituição**: inegociável. Código que viola princípio MUST = achado de
maior severidade + tarefa de remediação. Constituição ainda em template não
preenchido → pule a checagem graciosamente.

## Passos

### 1. Localize os artefatos

SPEC, PLAN, TASKS e constituição (se existir). Algum dos três primeiros
faltando → pare com mensagem indicando qual etapa rodar antes (especificar,
planejar, ou gerar tarefas). Sem output parcial.

### 2. Carregamento progressivo

- **Spec**: requisitos funcionais, critérios de sucesso (só itens construíveis
  — exclua métricas pós-launch), user stories com cenários de aceite, edge cases.
- **Plano**: decisões de arquitetura/stack, modelo de dados, fases e
  touch-points nomeados (arquivos/componentes a criar/editar), restrições.
- **Tarefas**: IDs (para calcular o próximo ID e próxima fase), descrições,
  fases, caminhos referenciados.
- **Constituição**: princípios e regras MUST/SHOULD.

### 3. Inventário de intenção

- Chave estável por requisito/critério/cenário de aceite (ex.: `US1/AC2`),
  mais decisões de plano e princípios de constituição que impõem obrigação
  construível.
- **Mapa de escopo de código**: a partir dos caminhos nomeados no plano/tarefas
  + busca por palavras-chave dos conceitos de cada requisito. Avalie **só**
  dentro desse escopo — não infira além dos artefatos.

### 4. Avalie o código e classifique gaps

Para cada item do inventário, inspecione o código no escopo e crie um
`Achado` apenas onde há gap. Tipos:

- **`faltando`** (missing): o trabalho está ausente do código.