Dynamo e plugins C# para Civil 3D e Revit com IA: como desenvolvê-los 10x mais rápido com Claude

O que sim muda:

• Escrever o primeiro rascunho de código é 10x mais rápido. Você diz em português o que precisa, ela devolve C# funcional.
• Aprender a API fica mais fácil: peça "explique-me FilteredElementCollector" e recebe exemplos claros.
• Debug — cole a mensagem de erro e a IA traduz para um plano de ação.
• Explorar alternativas — "dá para fazer com menos código?" — recebe 3 opções.

O que NÃO muda:

• Você precisa entender o que está pedindo. Se não sabe o que é uma Transaction no Revit, a IA vai dar código que compila mas não funciona.
• Você precisa testar num modelo real. A IA não tem seu modelo aberto.
• Você precisa decidir a arquitetura de um projeto grande. A IA faz peças, você desenha o quebra-cabeça.
• Você precisa se responsabilizar — se o código apagar um elemento errado, sua assinatura vai, não a do Claude.

O que você precisa instalado antes de escrever a primeira linha:

1. Visual Studio Community 2022 (grátis, visualstudio.microsoft.com). Ao instalar, escolha a carga "Desenvolvimento desktop com .NET".
2. Revit / Civil 3D que você já usa.
3. SDK do Revit / Civil 3D — Google "Revit SDK 2024 download" ou busque o instalador oficial da Autodesk.
4. Claude ou ChatGPT (versão Pro recomendada para conversas longas, mas grátis funciona).
5. Um template de projeto: existem templates gratuitos oficiais da Autodesk. Economizam horas.

Para Dynamo o setup é ainda mais simples: só instale Dynamo (vem com Revit e com Civil 3D como pacote). Nada para compilar.

A diferença entre um prompt bom e um ruim são horas de trabalho. Regra de ouro: a IA não adivinha seu contexto.

Prompt ruim:

"Me faça um plugin para renomear coisas."

Prompt bom:

"Preciso de um comando C# para Revit 2024 que:

• Pegue todas as vistas do tipo Seção e Elevação.
• Renomeie no formato: {TipoAbrev}-{Nivel}-{Numero}, onde Numero é sequencial por nível.
• Se uma vista já cumpre o formato, ignore.
• Use uma única Transaction. Me dê o código completo do IExternalCommand com tratamento de erros."

O segundo tem contexto (versão, categoria exata, formato, edge cases, padrão esperado). O código que a IA devolve compila e funciona de primeira com muito mais frequência.

Estrutura de um prompt eficaz:

1. Qual software e versão (Revit 2024, Civil 3D 2024).
2. O que deve fazer em detalhe.
3. Quais elementos toca (categorias, tipos exatos).
4. Edge cases — o que acontece se não encontrar nada, se o nome já existe etc.
5. Formato de saída — código completo, com imports, com transações.

Lista honesta:

• API desatualizada. Os modelos às vezes usam métodos que já não existem ou mudaram entre versões. Solução: cole o link ou snippet da doc oficial no chat quando duvidar.
• Bugs de negócio. Se sua regra é "vigas menores de 3 m não contam" e você não avisou, a IA não vai adivinhar.
• Performance em modelos gigantes. O código da IA funciona no seu modelo de teste de 500 elementos. Em produção com 200 000 elementos, pode travar. Toca otimizar.
• Distribuição — instalador .msi, assinatura digital, atualizações. A IA começa, mas requer critério humano.
• Segurança — se o plugin apaga elementos, tem "undo"? pede confirmação? Isso é design de UX, não código puro.

O padrão que equipes mistas usam hoje:

Passo a passo:

1. Ideia: "quero automatizar a renomeação de famílias".
2. Protótipo em Dynamo: rápido, visual. Em 1-2 dias tem algo funcional. Mostra para a equipe e validam se é isso que precisam.
3. Se ninguém vai usar: economizou uma semana de C#. Salve o .dyn, passe ao próximo problema.
4. Se muita gente vai usar: peça ao Claude que porte o grafo Dynamo para um add-in C#. Cole a lógica do grafo (ou explique em palavras) e ele devolve o código base. Você refina.
5. Empacota como plugin .msi com instalador. Distribui para a equipe.
6. Mantém o .dyn original como "spec executável": se amanhã quiser mudar a lógica, itera no Dynamo primeiro e regenera o C# com IA.

Esse fluxo reduz o "risco de desenvolvimento" — você não investe 3 semanas em algo que ninguém vai usar.

Você não precisa ser engenheiro de software. Precisa de 5 hábitos:

a) Nomes claros. BotaoRenomearVistas é melhor que Botao1. A IA respeita o que você diz; se disser "use nomes claros", usa.

b) Um arquivo por comando. Não coloque 8 comandos num arquivo gigante. Um por arquivo (RenomearVistasCommand.cs, ExportarQuantitativoCommand.cs). Facilita entender o que cada coisa faz.

c) Backup com Git — sem drama. Instale GitHub Desktop (interface visual, zero terminal). Crie um repo privado. Sempre que algo funciona: "Commit → Push". Se amanhã quebrar algo, volta atrás com um botão. Custo: 20 minutos aprender. Valor: infinito.

d) Comentários curtos onde importam. Não comente o óbvio. Sim comente as regras de negócio esquisitas: // Vigas metálicas <3m não contam por norma interna. Seu eu do futuro agradece.

e) Teste em modelo pequeno primeiro. Antes de rodar em modelo real, duplique e teste. Sempre.

Sinais de que já toca ajuda especialista:

• Seu plugin é usado por 10+ pessoas e você não consegue manter o ritmo de bugs e pedidos.
• Começa a ter erros que a IA não resolve depois de 3-4 iterações.
• Precisa de integração com sistemas externos (banco de dados corporativo, ERP, autenticação empresarial).
• Precisa de distribuição profissional com instalador assinado.
• Sente que seus scripts estão ficando impossíveis de manter.

O que esperar de uma mentoria séria:

• Revisão do seu código atual e refatoração para algo sustentável.
• Ensinar padrões para que futuros plugins sejam mais simples.
• Setup profissional: Git + CI + testes.
• Roadmap de crescimento — para não depender do mentor para sempre.

Uma boa mentoria é um investimento que te torna autônomo, não dependente.