Projeto de Código Claude de 34 Dias do Desenvolvedor Sênior: Engenharia Sólida, Pontos Cegos Críticos

Visão Geral do Projeto

Um executivo sênior de tecnologia com mais de 35 anos de experiência (cargos de VP de Engenharia, CIO, Chefe de Engenharia de Software) usou o Claude Code para um projeto solo ao longo de 34 dias. O desenvolvedor atuou como dono do produto, arquiteto e líder de equipe enquanto o Claude escreveu todo o código.

Resultados Técnicos

O projeto gerou mais de 300 commits em 34 dias. Tanto o Claude quanto o ChatGPT revisaram independentemente a base de código e descobriram:

• Arquitetura limpa com sólida separação de responsabilidades
• Boa cobertura de testes (272 testes)
• Documentação completa descrita como "excepcional para o estágio do projeto"
• Arquitetura que "não era aspiracional; estava implementada"

Abordagem de Gestão de Projeto

O desenvolvedor criou um arquivo CLAUDE-md com regras de trabalho para gerenciar o assistente de IA, incluindo:

• Nunca descrever código sem lê-lo primeiro
• Nunca avançar sem permissão
• Diagnosticar antes de corrigir

Este documento de gestão foi chamado de "um dos melhores documentos de gestão de assistente de codificação de IA que já vi" pelos revisores. Gerenciar o Claude Code parecia "gerenciar um desenvolvedor júnior muito rápido e muito literal".

O Projeto: Pipeline de Conversão de Documentos

O projeto foi um complexo pipeline de conversão de documentos com cinco estágios:

1. Extrair conteúdo de páginas da web
2. Sanitizar conteúdo
3. Analisar em modelo estruturado
4. Renderizar como HTML acessível

O conceito original era uma CLI e biblioteca para desenvolvedores incorporarem em seus aplicativos.

Oportunidade Crítica Perdida

O desenvolvedor sabia sobre o mecanismo de extração do Modo Leitor do Firefox (Readability.js) mas nunca perguntou: "isso também é uma biblioteca independente que eu poderia usar?" Em vez disso, ele o viu apenas como um recurso do navegador. Esta única pergunta teria revelado que:

• A parte difícil já estava resolvida
• O verdadeiro valor (tipografia, temas, saída acessível) poderia ser uma extensão do navegador sobre um mecanismo existente

Nem o desenvolvedor nem o Claude apresentaram esta abordagem alternativa, apesar da própria regra de engenharia do desenvolvedor: "nunca construir algo se uma solução já existe".

Pivô da Interface do Usuário

Os usuários-alvo (pais, professores, estudantes) não conseguiam usar uma CLI ou pipeline. O desenvolvedor inicialmente tentou uma página de teste HTML simples para feedback, mas depois construiu uma interface web completa:

• Mais de 100 commits em oito dias
• Cinco temas
• Design responsivo
• Identidade visual e implantação

Esta interface se tornou o produto em vez de apenas um mecanismo de feedback.

Expansão da Infraestrutura de Testes

O projeto desenvolveu uma extensa infraestrutura de testes:

• Harness de avaliação com 16 métricas de qualidade
• Benchmarks contra mais de 4.000 páginas da web
• Pipeline de comparação
• Ferramenta de triagem

O efeito cumulativo foi "cinco linhas de infraestrutura de teste para cada uma linha de produto".

Experiência do Desenvolvedor

O desenvolvedor relatou: "Trabalhar com o Claude Code parecia gerenciar uma equipe novamente. Brainstorming para desbloquear problemas, tomando decisões arquitetônicas, vendo as coisas se unirem rapidamente. Foi como ter a Liga da Justiça escrevendo meu código."

No entanto, isso criou uma armadilha: "Toda vez que eu tinha uma dúvida persistente sobre se estava no caminho certo, eu podia deixá-la de lado construindo algo mais impressionante. A qualidade do trabalho se tornou sua própria justificativa para continuar."

O feedback do usuário foi coletado apenas no dia 30 de 34.