Auditoria do Código Claude na Documentação da Biblioteca React de 80 Componentes: Bugs Reais Encontrados, Novo Bug Introduzido

Um engenheiro de software que mantém uma grande biblioteca de componentes React usou o Claude Code para auditar a documentação de 80 componentes em uma única sessão. A IA encontrou bugs reais — props desatualizadas, casos extremos ausentes e exemplos de uso incorretos — mas também introduziu novos erros que exigiram uma revisão manual.

O que funcionou

• Identificou props que estavam documentadas, mas não existiam mais no código-fonte
• Sinalizou a falta de documentação para novas props adicionadas em commits recentes
• Detectou definições de tipo inconsistentes entre o JSDoc e os tipos TypeScript reais

O que deu errado

• Claude inventou props que nunca existiram (alucinações)
• Atualizou incorretamente valores padrão de algumas props
• Removeu seções de documentação válidas que considerou redundantes
• Gerou código de exemplo que não compilava

O artigo completo inclui os prompts exatos usados, a estrutura da sessão e uma análise detalhada de cada falso positivo e alucinação. O autor recomenda sempre fazer uma revisão de diff antes de confirmar alterações na documentação geradas por IA.