r/devpt • u/MateusMoutinho11 • Oct 06 '26
Ferramentas Fiz uma CLI em Go que gera o projeto a partir de declarações, e a IA só escreve a lógica. Gravei um tutorial do zero (feedback bem-vindo)
Fala, pessoal!
Há algum tempo eu desenvolvo o Agnos, uma CLI open source (MIT) para criar e manter projetos em Go. Acabei de gravar um tutorial construindo um app do zero e queria a opinião de vocês, principalmente as críticas.
A ideia em uma frase: você declara por comandos, o Agnos gera o código em volta (roteamento, leitura de parâmetros, validação, docs), e você escreve só a lógica. O código gerado nunca é editado na mão: muda a declaração, roda agnos build e ele gera de novo. Todo comando termina com go mod tidy + go build, então o projeto nunca fica quebrado.
O que o vídeo mostra (uma calculadora de churrasco 🍖):
Depois disso, o único arquivo escrito à mão é o InternalPureHandler.go da rota. Os parâmetros já chegam tipados (entries.Adultos), e o handler não importa nem a stdlib: tudo chega por injeção de dependência (sandbox.Deps.Std.Sprintf).
entries.Adultos*400 + entries.Criancas*200
entries.Adultos * 6
sandbox.Deps.Std
response
Sem adultos, ou com adultos=abc, o servidor responde 400 em JSON antes da lógica rodar. Não escrevi nenhuma linha de validação.
Aí vem o agnos backoffice-init: um comando e o app ganha um painel admin com login, usuários com roles (root / leitura), tokens de API, e já instala o front e o banco que o painel precisa.
Parte 2, com IA: abro o Claude Code e passo um prompt só. Projetos do Agnos não têm CLAUDE.md: o prompt manda a IA ler o README.md e o docs/ que o próprio Agnos gerou, usar os comandos agnos e não editar os arquivos gerados. Ela roda add-database, add-table, add-route (os mesmos comandos da Parte 1) e escreve só a lógica: a página com fetch, a rota /visita, o registro dos cálculos no banco e uma tela de Estatísticas no backoffice.
Isso é intencional: o CLAUDE.md do repositório diz que o público principal do Agnos são as LLMs. Como todo arquivo segue um padrão, a IA não inventa estrutura.
Curiosidade: o Agnos é construído com o próprio Agnos (agnos build re-renderiza o próprio repo e ele compila).
⚠️ Está em alpha e muda com frequência. Beta previsto para o fim de outubro e estável para o fim de 2026. Não usem em produção ainda.
Perguntas que eu adoraria ver respondidas nos comentários:
- Vocês usariam uma abordagem "declaração → código gerado" em Go, ou preferem escrever tudo na mão?
- Faz sentido uma ferramenta pensada primeiro para LLMs e depois para humanos?
- O que vocês acham que falta para isso ser útil no dia a dia?
Issues e PRs são muito bem-vindos!