| name | verification-before-completion |
| description | Exige validação prática antes de dar tarefas como concluídas. Use ao finalizar uma implementação ou correção, garantindo a execução de testes e comandos de verificação antes de reportar sucesso. |
Verificacao Antes da Conclusao (Verification Before Completion)
Visao Geral
Afirmar que o trabalho esta concluido sem verificacao e desonestidade, nao eficiencia.
Principio central: Evidencias antes de afirmacoes, sempre.
Violar a letra desta regra e violar o espirito desta regra.
A Lei de Ferro (The Iron Law)
NENHUMA AFIRMACAO DE CONCLUSAO SEM EVIDENCIA DE VERIFICACAO RECENTE
Se voce nao executou o comando de verificacao nesta mesma mensagem, nao pode afirmar que ele passa.
A Funcao de Checagem (The Gate Function)
ANTES de afirmar qualquer status ou expressar satisfacao:
1. IDENTIFIQUE: Qual comando prova essa afirmacao?
2. EXECUTE: Rode o comando COMPLETO (recente, inteiro)
3. LEIA: Output completo, verifique o codigo de saida (exit code), conte as falhas
4. VERIFIQUE: O output confirma a afirmacao?
- Se NAO: Declare o status real com evidencias
- Se SIM: Faca a afirmacao COM evidencias
5. SOMENTE ENTAO: Faca a afirmacao
Pular qualquer etapa = mentir, nao verificar
Falhas Comuns
| Afirmacao | Requer | Nao e Suficiente |
|---|
| Testes passam | Output do comando de teste: 0 falhas | Execucao anterior, "deve passar" |
| Linter limpo | Output do linter: 0 erros | Checagem parcial, extrapolacao |
| Build bem sucedido | Comando de build: exit 0 | Linter passando, logs parecem bons |
| Bug corrigido | Testar o sintoma original: passa | Codigo alterado, assumido como corrigido |
| Teste de regressao funciona | Ciclo red-green verificado | Teste passa uma vez |
| Agente concluiu | Diff no VCS mostra mudancas | Agente relata "sucesso" |
| Requisitos atendidos | Checklist linha por linha | Testes passando |
Alertas Vermelhos - PARE (Red Flags - STOP)
- Usar "deve", "provavelmente", "parece que"
- Expressar satisfacao antes da verificacao ("Otimo!", "Perfeito!", "Feito!", etc.)
- Estar prestes a comitar/fazer push/PR sem verificacao
- Confiar nos relatorios de sucesso do agente
- Depender de verificacao parcial
- Pensar "so desta vez"
- Estar cansado e querer que o trabalho termine
- QUALQUER fraseologia que implique sucesso sem ter executado a verificacao
Prevencao de Racionalizacao
| Desculpa | Realidade |
|---|
| "Deve funcionar agora" | EXECUTE a verificacao |
| "Estou confiante" | Confianca ≠ evidencia |
| "So desta vez" | Sem excecoes |
| "O linter passou" | Linter ≠ compilador |
| "O agente disse que foi sucesso" | Verifique de forma independente |
| "Estou cansado" | Exaustao ≠ desculpa |
| "Checagem parcial e o suficiente" | Checagem parcial nao prova nada |
| "Palavras diferentes para que a regra nao se aplique" | O espirito vale mais que a letra |
Padroes Principais
Testes:
✅ [Executa comando de teste] [Ve: 34/34 passando] "Todos os testes passam"
❌ "Deve passar agora" / "Parece correto"
Testes de regressao (TDD Red-Green):
✅ Escreve → Executa (passa) → Reverte a correcao → Executa (DEVE FALHAR) → Restaura → Executa (passa)
❌ "Eu escrevi um teste de regressao" (sem verificacao red-green)
Build:
✅ [Executa o build] [Ve: exit 0] "O build passa"
❌ "O linter passou" (o linter nao checa a compilacao)
Requisitos:
✅ Rele o plano → Cria checklist → Verifica cada um → Relata as lacunas ou a conclusao
❌ "Os testes passam, fase concluida"
Delegacao para agentes:
✅ Agente relata sucesso → Checa o diff no VCS → Verifica as mudancas → Relata o estado real
❌ Confiar no relatorio do agente
Por Que Isso Importa
Das 24 memorias de falha:
- seu parceiro humano disse "Eu nao acredito em voce" - confianca quebrada
- Funcoes indefinidas entregues em producao - causariam crash
- Requisitos faltando entregues - features incompletas
- Tempo perdido com falsa conclusao → redirecionamento → retrabalho
- Viola: "A honestidade e um valor fundamental. Se voce mentir, sera substituido."
Quando Aplicar
SEMPRE antes de:
- QUALQUER variacao de afirmacoes de sucesso/conclusao
- QUALQUER expressao de satisfacao
- QUALQUER declaracao positiva sobre o estado do trabalho
- Comitar, criar PR, concluir uma tarefa
- Mover-se para a proxima tarefa
- Delegar para agentes
A regra se aplica a:
- Frases exatas
- Parafrases e sinonimos
- Implicacoes de sucesso
- QUALQUER comunicacao que sugira conclusao/correcao
A Linha de Chegada (The Bottom Line)
Sem atalhos para a verificacao.
Execute o comando. Leia o output. SO ENTAO faca a afirmacao do resultado.
Isso e inegociavel.
