As 50 Funcionalidades de Claude Implodiram. Eis o Porquê.

O desenvolvedor Shiv Bhosale embarcou num ambicioso projeto de sete meses, construindo o K10s, um dashboard Kubernetes com reconhecimento de GPU, inteiramente com Claude. Este esforço intensivo de "vibe coding" resultou em 50 funcionalidades distintas, cada uma aparentemente implementada de forma limpa numa única sessão de desenvolvimento. A rápida geração de componentes individuais fomentou uma sensação inebriante de progresso, sugerindo um futuro onde aplicações complexas poderiam materializar-se a velocidades sem precedentes.

Esta abordagem cultivou o fascínio sedutor da 10x velocity, onde os desenvolvedores se sentiam capacitados para prototipar e implementar novas capacidades com notável facilidade. A saída eficiente e baseada em sessões de Claude reforçou a perceção de que cada funcionalidade era um sucesso autónomo, exigindo um esforço mínimo de integração. Criou uma falsa sensação de solidez arquitetónica, mascarando problemas subjacentes com a pura velocidade de geração.

No entanto, a ilusão desfez-se catastroficamente quando Bhosale finalmente tentou combinar as 50 funcionalidades numa aplicação coesa. O sistema inteiro implodiu, revelando inconsistências arquitetónicas fundamentais: a troca de visualizações exibia dados desatualizados, tabelas outrora preenchidas apareciam inexplicavelmente vazias, e funções-chave críticas executavam três ações diferentes e imprevisíveis dependendo do ecrã ativo. Esta falha completa, impulsionada pela falta de previsão arquitetónica da IA, forçou Bhosale a abandonar sete meses de trabalho, arquivar toda a base de código e reiniciar o projeto do zero.

O erro fundamental da IA surgiu rapidamente: ela excela na geração de funcionalidades isoladas, não de arquiteturas coesas. Cada prompt funciona como uma diretiva isolada, completamente alheia às outras 49 funcionalidades que partilham estado dentro do projeto K10s de Shiv Bhosale. Claude entregou componentes individuais, mas, criticamente, faltava-lhe qualquer compreensão de como essas peças deveriam interagir como um sistema unificado.

Esta abordagem fragmentada levou inevitavelmente a uma base de código frágil e de difícil manutenção. Quando Bhosale tentou usar tudo junto, a estrutura inteira implodiu. A troca de visualizações mostrava dados desatualizados, tabelas outrora preenchidas apareciam vazias, e uma única chave executava três ações diferentes dependendo do ecrã. As funcionalidades individuais, limpas em isolamento, simplesmente não funcionavam juntas.

A solução de Bhosale era clara: o desenvolvedor deve recuperar o papel de arquiteto. Ele projetou manualmente a arquitetura do sistema, documentando-a minuciosamente num ficheiro `Claude MD`. Só então ele aproveitou Claude para as "tarefas aborrecidas" — implementando funcionalidades específicas estritamente dentro do projeto estrutural pré-definido e escrito à mão. Esta mudança transformou a IA de um construtor autónomo numa ferramenta de implementação poderosa e guiada.

A abordagem padrão da IA é o anti-padrão god object, que agrupa toda a lógica numa única e massiva estrutura de dados para encontrar o caminho mais curto para uma funcionalidade em funcionamento. A base de código K10s de Shiv Bhosale exemplificou isso de forma marcante, apresentando uma única `struct` que abrangia espantosas 1.690 linhas. Este objeto monolítico continha um método `Update()` de 500 linhas e 110 `switch cases`, um testemunho claro do seu escopo incontrolável.

Um design monolítico torna a manutenção impossível, promovendo um acoplamento forte entre funcionalidades díspares. Uma pequena mudança em uma área arrisca falhas em cascata por todo o sistema frágil. A experiência de Bhosale com dados desatualizados, tabelas vazias e funções-chave inconsistentes entre as visualizações derivou diretamente dessa falha arquitetônica, tornando a aplicação inerentemente instável.

Retificar isso exige instruções explícitas ao LLM. Os desenvolvedores devem forçar o Claude a segregar as preocupações, dividindo a lógica em visualizações, componentes e estruturas de dados distintos. Essa orientação arquitetônica impede ativamente que a IA adote estruturas monolíticas por padrão, promovendo uma base de código mais modular e sustentável. Para mais informações sobre o projeto de Bhosale e sua evolução, explore o repositório K10s GitHub: shvbsle (Shiv Bhosale) / k10s - GitHub.

A percebida "gratuidade" do código gerado por IA prova ser perigosamente enganosa, levando diretamente a uma expansão descontrolada do escopo. Quando o Claude pode aparentemente conjurar 50 funcionalidades em tantas sessões isoladas, o impulso de adicionar continuamente mais se torna irresistível. Essa velocidade rápida, embora inicialmente empolgante, mascara uma dívida técnica crescente e atrai os desenvolvedores para um projeto em constante expansão.

Cada nova funcionalidade, por mais trivial que seja sua criação, introduz custos ocultos significativos: - suporte de longo prazo - documentação abrangente - tratamento de casos de uso imprevistos - aumento da carga cognitiva do usuário O K10s de Bhosale, com suas 50 funcionalidades colapsadas, exemplifica claramente essa armadilha; a velocidade mascarou o verdadeiro fardo da expansão não arquitetada.

Para combater essa expansão insidiosa, os desenvolvedores devem estabelecer limites rígidos. Shiv Bhosale definiu explicitamente para quem ele *não estava* construindo, estabelecendo restrições negativas. Ele então codificou esses limites de escopo explícitos diretamente no arquivo de contexto `Claude MD`, impedindo que a IA reconstruísse funcionalidades existentes ou excedesse o escopo do projeto. Essa restrição proativa garante que a velocidade da IA sirva a um propósito precisamente definido, em vez de criar uma expansão incontrolável de funcionalidades.

O que é 'programação por vibe' com IA?

É um estilo de desenvolvimento rápido onde um programador usa um LLM como o Claude para gerar funcionalidades com base em prompts de alto nível ou 'vibes', muitas vezes sem um plano arquitetônico estrito e predefinido.

Por que a IA cria 'god objects'?

A IA segue o caminho mais curto para uma solução funcional. Agrupar todo o estado e lógica em um único objeto é frequentemente a maneira mais simples de atender a um prompt para uma nova funcionalidade, ignorando a manutenibilidade a longo prazo.

Como os desenvolvedores podem evitar as armadilhas da programação com IA?

Ao definir manualmente a arquitetura central, estabelecendo limites claros de escopo e usando a IA como uma ferramenta para implementar tarefas menores e bem definidas, em vez de como um arquiteto autônomo.

Quem é **Shiv Bhosale** e o que é **K10s**?

Shiv Bhosale é o desenvolvedor que compartilhou esta experiência. O K10s é o seu projeto, um GPU-aware Kubernetes dashboard, que ele reconstruiu com sucesso após a versão inicial gerada por IA falhar devido a problemas arquitetônicos.