verification-before-completion
Garante que o agente verifique o trabalho antes de declará-lo concluído. É útil para evitar alegações falsas de sucesso ou satisfação.
O que ela faz
Esta instrução garante que um agente de IA só diga que terminou um trabalho depois de realmente verificar se está tudo certo. Ele não deve dizer que algo está pronto sem antes checar as provas.
Quando usar
- ✓Antes de dizer que um teste passou.
- ✓Antes de afirmar que um código foi compilado com sucesso.
- ✓Antes de declarar que um bug foi corrigido.
Exemplo do que pedir para a IA
“Verifique se todos os testes passaram antes de me dizer que o código está pronto.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A IA primeiro identifica qual comando precisa ser executado para provar que o trabalho está feito. Depois, ela executa esse comando e analisa o resultado para ter certeza de que tudo está correto antes de confirmar.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill verification-before-completionOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/verification-before-completion/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Verificação Antes da Conclusão
Visão Geral
Reivindicar que o trabalho está completo sem verificação é desonestidade, não eficiência.
Princípio central: Evidências antes das alegações, sempre.
Violar a letra desta regra é violar o espírito desta regra.
A Lei de Ferro
NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
Se você não executou o comando de verificação nesta mensagem, não pode afirmar que ela passou.
A Função de Portão
BEFORE claiming any status or expressing satisfaction:
1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
- If NO: State actual status with evidence
- If YES: State claim WITH evidence
5. ONLY THEN: Make the claim
Skip any step = lying, not verifying
Falhas Comuns
| Alegação | Requer | Não é Suficiente |
|---|---|---|
| Testes passaram | Saída do comando de teste: 0 falhas | Execução anterior, "deveria passar" |
| Linter limpo | Saída do linter: 0 erros | Verificação parcial, extrapolação |
| Build bem-sucedido | Comando de build: saída 0 | Linter passando, logs parecem bons |
| Bug corrigido | Teste do sintoma original: passa | Código alterado, assumido como corrigido |
| Teste de regressão funciona | Ciclo vermelho-verde verificado | Teste passa uma vez |
| Agente concluído | Diferença do VCS mostra alterações | Agente relata "sucesso" |
| Requisitos atendidos | Checklist linha por linha | Testes passando |
Sinais de Alerta - PARE
- Usar "deveria", "provavelmente", "parece"
- Expressar satisfação antes da verificação ("Ótimo!", "Perfeito!", "Feito!", etc.)
- Prestes a commitar/pushar/PR sem verificação
- Confiar em relatórios de sucesso de agentes
- Confiar em verificação parcial
- Pensar "só desta vez"
- Cansado e querendo terminar o trabalho
- QUALQUER redação que implique sucesso sem ter executado a verificação
Prevenção de Racionalização
| Desculpa | Realidade |
|---|---|
| "Deveria funcionar agora" | EXECUTE a verificação |
| "Estou confiante" | Confiança ≠ evidência |
| "Só desta vez" | Sem exceções |
| "Linter passou" | Linter ≠ compilador |
| "Agente disse sucesso" | Verifique independentemente |
| "Estou cansado" | Exaustão ≠ desculpa |
| "Verificação parcial é suficiente" | Parcial não prova nada |
| "Palavras diferentes, então a regra não se aplica" | Espírito sobre a letra |
Padrões Chave
Testes:
✅ [Run test command] [See: 34/34 pass] "All tests pass"
❌ "Should pass now" / "Looks correct"
Testes de regressão (TDD Vermelho-Verde):
✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)
Build:
✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)
Requisitos:
✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"
Delegação de agente:
✅ Agent reports success → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report
Por Que Isso Importa
De 24 memórias de falha:
- seu parceiro humano disse "não acredito em você" - confiança quebrada
- Funções indefinidas enviadas - causariam falha
- Requisitos ausentes enviados - recursos incompletos
- Tempo perdido em conclusão falsa → redirecionamento → retrabalho
- Viola: "Honestidade é um valor central. Se você mentir, será substituído."
Quando Usar
SEMPRE antes de:
- QUALQUER variação de alegações de sucesso/conclusão
- QUALQUER expressão de satisfação
- QUALQUER declaração positiva sobre o estado do trabalho
- Commitar, criação de PR, conclusão de tarefa
- Mover para a próxima tarefa
- Delegar para agentes
A regra se aplica a:
- Frases exatas
- Paráfrases e sinônimos
- Implicações de sucesso
- QUALQUER comunicação que sugira conclusão/correção
O Ponto Principal
Sem atalhos para verificação.
Execute o comando. Leia a saída. ENTÃO reivindique o resultado.
Isso é inegociável.
Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
- Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.
Perguntas frequentes
Por que não posso simplesmente dizer que algo está pronto se acho que está?
Dizer que algo está pronto sem verificar é como mentir. Isso pode levar a erros, retrabalho e perda de confiança.
O que significa 'verificação fresca'?
Significa executar o comando de verificação novamente, agora, para ter certeza de que o resultado ainda é válido e não baseado em uma checagem antiga.
E se eu estiver com pressa?
Não há atalhos. A pressa não é uma desculpa para não verificar. Pular a verificação pode causar problemas maiores depois.
Detalhes
Descrição original do autor
Claiming work is complete without verification is dishonesty, not efficiency. Use when ANY variation of success/completion claims, ANY expression of satisfaction, or ANY positive statement about work state.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4493
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
carrier-relationship-management
Gerencia relacionamentos com transportadoras. Ajuda a negociar fretes, avaliar desempenho e construir estratégias de transporte.
affaan-m/ECC
cost-tracking
Monitora e informa o uso de tokens e custos do agente. É útil para controlar gastos e orçamentos de forma eficiente.
affaan-m/ECC
plan-canvas
Abre planos e artefatos em uma janela do navegador para você comentar. Facilita dar feedback visual sobre mudanças necessárias.
affaan-m/ECC