Construindo uma CLI de Revisão de Código com IA usando Claude: Um Caminho Não Tradicional

GrandCru é uma ferramenta CLI de revisão de código que foi desenvolvida e publicada no npm por um ex-oficial militar sem formação formal em ciência da computação. Esta ferramenta fornece feedback técnico sobre código empregando um método único que combina análise estruturada de dados com comunicação criativa.

Detalhes Principais

• A ferramenta é iniciada pelo comando grandcru review src/, entregando feedback da persona lúdica de um sommelier francês de vinhos.
• Utiliza um esquema Zod de duplo canal; um canal lida com dados rigorosos como tipo de problema, gravidade, número da linha e correções sugeridas, enquanto o outro fornece feedback narrativo com 'observações do sommelier' sobre a qualidade do código.
• Claude IA facilita saídas estruturadas usando decodificação restrita, garantindo consistência no formato JSON gerado durante as revisões de código.
• A função .describe() do Zod em cada campo atua como um prompt do sistema para manter a personalidade do feedback dentro da estrutura JSON, prevenindo o que o criador chama de 'lobotomia JSON'.
• GrandCru revisou seu próprio código-fonte, identificando problemas críticos como validação de entrada ausente e interpolação de strings não sanitizada, e avaliou sua própria qualidade com uma pontuação divertida de 79/100, indicando que 'precisa decantar antes de servir'.

Esta ferramenta é particularmente interessante para quem explora caminhos não convencionais para o desenvolvimento tecnológico, utilizando IA como Claude para gerar, entender e melhorar rapidamente estruturas de código.