Vibe Coding para engenheiros: construa suas próprias ferramentas BIM sem ser programador

A IA amplifica o que você dá. Se sua ideia é difusa, o resultado será difuso.

Antes de abrir o Claude ou ChatGPT, escreva numa folha:

• Que tarefa concreta você quer eliminar. Não "automatizar a modelagem", e sim "renomear todos os alinhamentos seguindo o formato AL-<nível>-<sequencial>".
• Qual é a entrada. O que o usuário seleciona? O desenho todo? Só o selecionado?
• Qual é a saída esperada. Modifica o modelo? Gera um arquivo? Mostra um relatório?
• O que NÃO deve fazer. O limite explícito. "Não mexe em alinhamentos que já cumpram o formato".

O erro mais comum: pedir código sem dizer em que versão e com que ferramenta.

Uma mensagem de contexto que você deveria reutilizar em cada sessão:

Contexto do meu ambiente:
- Civil 3D 2025 (.NET 8)
- Windows 11, Visual Studio Community 2022
- Objetivo: add-in em C# usando a API oficial
- Nível: nunca programei em C#, me explique o que fizer

Quando propuser código, me diga também:
- O que cada bloco faz, em linguagem simples
- O que preciso instalar ou referenciar
- Como eu testo

Sem isso, a IA assume uma versão qualquer e te dá código que não compila. Com isso, acerta de primeira muito mais vezes.

Peça primeiro o esqueleto: que arquivos, que pastas, o que cada parte faz. Só depois entre no detalhe.

Ordem que funciona:

1. Estrutura do projeto — pastas e arquivos vazios, com a responsabilidade de cada um.
2. O caso mais simples — que faça UMA coisa mínima e faça bem.
3. Os casos reais — agora sim, sua lógica de negócio com as exceções.
4. Tratamento de erros — o que acontece se não achar nada, se o dado vier vazio.
5. Interface — botão, janela, opções. No final, não no começo.

Essa ordem vem da arquitetura em camadas que explicamos em detalhe em criar um plugin de Civil 3D com Claude Code.

Uma mudança por vez. Verifique cada resultado antes de pedir o próximo.

O loop correto:

1. Você pede uma coisa pequena.
2. Lê o que ele propõe (mesmo sem entender cada linha, entenda a intenção).
3. Testa numa cópia de um modelo pequeno.
4. Se funciona: salva o avanço. Se não: dá o erro completo, não um resumo.
5. Próxima coisa pequena.

Quando algo falha: não peça "conserte". Cole a mensagem de erro exata, diga o que esperava e o que aconteceu. A diferença na qualidade da resposta é enorme.

Você não precisa escrever código de cor. Precisa sim entender o que faz o que está na sua frente.

O mínimo viável para não depender cegamente da IA:

• Variáveis e tipos — o que cada coisa guarda.
• Condicionais e laços — como decide e como repete.
• Funções — como se organiza e reutiliza a lógica.
• Em BIM especificamente: o que é uma Transaction (o bloco que agrupa mudanças no modelo e permite desfazê-las) e por que toda mudança vai dentro de uma.

Se faltam esses fundamentos, a rota mais curta é nosso guia de programar do zero para engenheiros civis. São umas semanas, e multiplicam o que você pode fazer com IA.

Aqui é onde o Vibe Coding sozinho deixa de bastar, e precisa somar disciplina.

O que separa um experimento de uma ferramenta real:

• Controle de versão. Instale o GitHub Desktop, crie um repositório, faça um "commit" toda vez que algo funcionar. É seu backup infinito. 20 minutos de aprendizado, valor permanente.
• Tratamento de erros decente. Que mostre "Não foram encontrados alinhamentos no desenho" em vez de estourar com um texto vermelho incompreensível.
• Testado com dados estranhos. Modelo vazio, 10 000 elementos, nomes com acentos e emojis, dados incompletos.
• Documentação mínima. Três linhas: o que faz, como se instala, quando NÃO usar.
• Distribuição. Um arquivo solto serve para você. Para a equipe, empacote como bundle.

Se a ferramenta vai ser crítica para a operação, chega a hora de decidir entre sustentá-la você ou encomendá-la. Os fatores estão em quanto custa um add-in.