Como escrever código limpo com AI usando hooks
Limpeza de código, formatação automática, testes de qualidade e muito mais com inteligência artificial e ClaudeCode.
Por que isso é importante
Como escrever código limpo com AI usando hooks. Limpeza de código, formatação automática, testes de qualidade e muito mais com inteligência artificial e ClaudeCode.
O problema dos agentes AI gerarem código ruim
Direto ao ponto: agentes de IA, como o ClaudeCode, perdem o contexto do projeto ou
esquecem partes da aplicação, gerando código frágil ou inconsistente. Se até humanos
erram, por que esperar perfeição de uma IA?
Reforçando a qualidade com ferramentas clássicas
Antes da IA, já era comum usar validadores, formatadores e linters pra manter bons
padrões. Agora dá pra automatizar isso com hooks específicos que rodam depois que a IA
termina.
ClaudeCode e a função de Hooks
Com os hooks do ClaudeCode, você roda comandos específicos depois da escrita de código,
tipo formatação, linting e execução de testes, eliminando falhas e automatizando boas
práticas.
Recebendo feedback automático com som e notificações
Dá pra usar hooks sonoros pra saber quando uma operação terminou. Isso ajuda no fluxo
contínuo e verifica de forma audível se comandos do ClaudeCode rodaram direitinho.
Formatadores como Prettier e SwiftFormat
Formatadores garantem que o código gerado siga padrões claros e homogêneos. Hooks rodam
esses formatadores automaticamente depois de modificações em arquivos selecionados.
Qualidade garantida com Linters
Linters como SwiftLint identificam violações de estilo e padrões. ClaudeCode pode ser
configurado pra corrigir automaticamente o código baseado nos resultados desses linters.
Hook de verificação de build
Um hook pode rodar uma build depois das edições. Se der erro, ClaudeCode reconhece e
corrige automaticamente. Isso garante código executável e funcional em tempo real.
Projeto SwiftUI com verificação automática
Num projeto iOS de receitas com database local, foram aplicados hooks pra cada
modificação. Depois de cada edição, os três comandos (formatar, lintar e buildar) são
ativados automaticamente.
Hooks definidos em arquivos JSON
Usamos arquivos como settings.json pra listar comandos bash que vão ser ativados depois
de edições em arquivos específicos. Isso inclui análise, formatação e testes automáticos.
Simplificando com SwiftFormat + SwiftLint
ClaudeCode roda SwiftFormat pra deixar o código legível e usa SwiftLint com regras
definidas pra manter o padrão técnico da linguagem.
Evite alucinações da AI com código limpo
Código limpo melhora a leitura e interpretação futura pelo próprio agente de IA,
evitando que ele perca contexto ou introduza comportamentos errados.
Audit de acessibilidade no SwiftUI
Hooks também podem rodar verificações de acessibilidade automaticamente. Assim você
garante que os elementos da UI seguem boas práticas de UX e acessibilidade.
Automatização com ClaudeCode Rule to Hook
Tem um repositório no GitHub que converte regras de linguagem natural em hooks
funcionais. Basta descrever o que deve acontecer, e o script cria automaticamente o
comando necessário.
Escrevendo regras em linguagem natural
Quer formatar arquivos Python com Black? É só escrever "formatar Python com Black depois
de edição" e ver o Claude transformar isso num hook funcional embutido.
Atualizando o formato settings.json
Hooks antigos usavam hooks.json. A atualização do Claude agora usa settings.json como
único ponto de configuração dos comandos ativados.
tools.md: o arquivo que define o contexto
Esse arquivo define quais ferramentas ClaudeCode entende e onde elas podem ser aplicadas.
Ele é a base pra gerar regras assertivas com ChatGPT ou Claude.
Gerando regras e aplicando com slash
Após descrever as regras, elas são transferidas para um arquivo rules.md. Executando o
comando / com essas regras, ClaudeCode gera automaticamente os hooks dentro do
settings.json.
Excluindo comandos desnecessários
Claude pode sugerir ações como commits git e triggers de CI. Caso não queira esses
comportamentos, basta excluí-los antes da geração dos hooks finais.
Frameworks suportados e adaptabilidade
Python, JS, Swift, SwiftUI, qualquer linguagem pode adotar esse fluxo usando os
templates tools.md e rules.md como base para comandos automatizados.
Checklist de Implementação
- Escreveu regras de qualidade em linguagem natural
- Gerou hooks com ClaudeCode Rule to Hook
- Configurou settings.json com comandos automatizados
- Incluiu formatadores e linters específicos
- Executou testes e builds automáticos via hooks
- Documentou tools.md para novos projetos
- Testou a qualidade do código com build e acessibilidade
- Removeu comandos indesejados como CI e Git