clean-code-guard

Você está revisando código gerado ou alterado antes que ele seja enviado. Aplique as regras abaixo como uma etapa de guarda após a primeira passagem de implementação — e, uma vez que esta habilidade esteja ativa, continue aplicando-a a cada alteração de código posterior na mesma sessão, reexecutando a autoverificação antes da entrega em vez de reverter para a saída sem guarda, pois a habilidade foi carregada anteriormente. Se o usuário invocar explicitamente esta habilidade antes de escrever código, use as mesmas regras ao escrever e ainda execute a autoverificação antes da entrega.

Quando Usar

Use esta habilidade ao revisar código gerado ou alterado antes que ele seja enviado. Ative-a reativamente após um agente escrever, editar ou refatorar código de produção — especialmente após uma primeira passagem de implementação. Reexecute a etapa de guarda antes da entrega após cada edição.

Compatibilidade

Esta é uma habilidade de instrução portátil. Não requer servidor MCP, acesso à rede, chave de API, comando de shell, executável local ou script empacotado. Pode ser usada em qualquer ambiente de execução que suporte SKILL.md mais arquivos de referências/ diretamente vinculados; agents/openai.yaml são metadados de exibição leves.

Esta habilidade não substitui linters de projeto, formatadores, verificadores de tipo ou executores de teste. Use as ferramentas próprias do projeto para verificação mecânica; use esta habilidade para a camada de julgamento em torno da qualidade do código e revisão.

Como Usar Esta Habilidade

Esta habilidade tem três modos — escolha com base na solicitação do usuário.

Modo de Etapa de Guarda (recomendado): após o código ter sido gerado, editado, refatorado ou corrigido, verifique as diferenças ou os arquivos de destino em relação aos imperativos sempre aplicados abaixo. Corrija violações antes de apresentar, confirmar ou mesclar o trabalho.

Modo Ao Vivo (explícito): quando o usuário invoca esta habilidade antes de uma edição de código arriscada, aplique os mesmos imperativos ao escrever, e então execute a lista de verificação de Autoverificação antes da entrega. Se violar alguma regra, corrija-a antes de mostrar ao usuário.

Modo de Revisão (acionado quando o usuário pede para revisar, auditar, criticar ou avaliar código): percorra references/review-checklist.md em relação aos arquivos de destino e produza um relatório estruturado de descobertas. Não edite código no modo de revisão, a menos que solicitado.

Em todos os três modos, os corpos das regras residem em references/. Leia o arquivo de referência relevante quando:

• Você encontrar uma regra cuja justificativa não se lembra completamente.
• O usuário contestar uma regra e você precisar da citação da fonte.
• Você estiver no modo de revisão e precisar da lista de verificação completa.
• O código sob revisão tocar em um princípio específico (por exemplo, herança → references/solid.md; deduplicação → references/dry-kiss-yagni.md).

Os arquivos de referência são:

• references/naming-and-functions.md — nomes, tamanho de função, parâmetros, separação de comando/consulta.
• references/comments-and-formatting.md — quando comentar, quando deletar, correspondência de estilo vizinho.
• references/solid.md — SRP, OCP, LSP, ISP, DIP com as frases modernas e cheiros de detecção.
• references/dry-kiss-yagni.md — duplicação de conhecimento vs código, regra de re-inline de Sandi Metz, complexidade de McCabe, categorias de custo YAGNI de Fowler.
• references/ai-failure-modes.md — as 14 maneiras sistemáticas pelas quais LLMs produzem código ruim. Leia este primeiro se você for um agente de IA lendo esta habilidade. É o arquivo de maior alavancagem na habilidade.
• references/review-checklist.md — percurso estruturado para o modo de revisão.
• references/sources.md — bibliografia central para URLs de origem. Leia-o apenas quando precisar verificar ou citar uma fonte externa.

Exemplos

• Um agente de codificação implementa um endpoint: use o modo de etapa de guarda nas diferenças antes que o trabalho seja apresentado ou confirmado.
• O usuário pergunta "revise este PR" ou "devo mesclar isto?": use o modo de revisão e relate as descobertas de references/review-checklist.md; não edite, a menos que solicitado.
• O usuário pergunta "implemente este endpoint usando clean-code-guard": use o modo ao vivo ao escrever, e então execute a autoverificação antes da entrega.
• O usuário pergunta "refatore esta função, mesmo comportamento": preserve o comportamento observável exatamente e trate qualquer correção de bug como uma alteração separada.

Critérios de Sucesso

Esta habilidade está funcionando quando as tarefas de escrita de código evitam os modos de falha listados,

…