DEV Community: Matheus de Paula Ribeiro

Há 4 meses eu usava uma IA pra tudo. Hoje converso com uma só e ela coordena o resto

Matheus de Paula Ribeiro — Fri, 30 Oct 2026 17:42:51 +0000

Uma IA pra tudo

Até uns 4 meses atrás eu fazia tudo num terminal só. A ideia, as pesquisas, o código e os testes, tudo na mesma sessão com a IA.

No começo funcionava. Com o tempo ia piorando. A sessão carregava o contexto da ideia, das pesquisas, dos testes e do desenvolvimento ao mesmo tempo, e com o contexto inflado a qualidade caía. Também demorava, porque era uma IA pra fazer tudo. E o gasto de token ia lá em cima.

O que eu queria era automatizar as tarefas principais de um desenvolvimento. Ter um meta prompt me ajudando a estruturar a ideia e, depois disso, agentes com foco: um pra desenvolver, um pra testar e um pra investigar e pesquisar.

Foi assim que nasceu o Forge.

Vários terminais conversando por tmux

A primeira versão, em julho, rodava no kiro-cli. Na época ele ainda não tinha subagentes integrados, então adaptei pra funcionar via tmux. Cada agente era um terminal, e eles conversavam assim: um mandava texto pro outro com send-keys, esperava com sleep e lia a resposta com capture-pane.

Tinha uma série de bugs e problemas. Mas funcionou.

No dia 5 de agosto eu migrei o núcleo pro Claude Code e fui 100% de subagentes. Saiu o tmux e entrou um orquestrador único, que chama os agentes e recebe deles um retorno estruturado. Em setembro o Forge virou plugin, e no fim de outubro abri o código com licença MIT.

Como funciona

Você digita /forge e escolhe um caminho: criar um projeto do zero, corrigir ou implementar algo num projeto que já existe, ou investigar um problema sem escrever código.

No caminho de criar, o meta prompt faz algumas rodadas curtas de perguntas. O que ele decidir sozinho fica marcado como suposição, pra eu revisar. Daí sai a spec, um prompt.md com critérios de aceite, e eu aprovo antes de qualquer linha de código.

Depois o orquestrador quebra a spec em tarefas pequenas e distribui:

Quem	O que faz
Orquestrador	conversa comigo, escreve a spec, divide e distribui. Não escreve código
dev	escreve todo o código e roda build e teste unitário
tester	valida a entrega no navegador de verdade ou por contrato (API, CLI, MCP) e dá o veredito: PASSOU, FALHOU ou BLOQUEADO
scout	lê, varre e pesquisa em volume, e volta só com o resumo

Quando as tarefas não dependem uma da outra, vários devs rodam ao mesmo tempo. Se o tester reprova, a tarefa volta pro dev com o defeito descrito. O progresso fica anotado numa pasta .forge/, então dá pra parar hoje e continuar amanhã.

Cada agente trabalha no próprio contexto. O orquestrador não vê a varredura do scout nem o código que o dev leu pra escrever. Ele recebe o resultado e decide o próximo passo. Era exatamente o que faltava no terminal único.

O orquestrador que esquecia

A regra número um do orquestrador é não escrever código. E ele esquecia.

Em conversa longa, a instrução ficava lá pra trás no contexto, e uma hora ele abria um arquivo e começava a programar.

Pedir de novo em texto não resolveu. Então virou hook.

Hook é um script que o Claude Code roda antes e depois de cada ação. O do Forge olha o caminho do arquivo: se o orquestrador tenta escrever código de produto, a ação é negada e ele precisa delegar pro dev. Ele já veio junto na migração pro Claude Code, no dia 5 de agosto, e depois ganhou uma versão que pega a mesma tentativa feita pelo terminal.

Desde então, regra importante no Forge vira hook. Hoje são oito, entre eles:

o orquestrador não escreve código;
quando o dev entrega algo verificável, a validação fica pendente até o tester rodar;
cada papel tem um teto de turnos;
commit só sai com a identidade git configurada no próprio repositório.

O custo de token

Num loop de agentes, o que mais pesa é o contexto reenviado. A cada turno a conversa inteira volta pro modelo, então uma invocação longa fica cada vez mais cara.

Fui atacando isso por partes. Em agosto cortei o custo do próprio loop de orquestração. Em setembro entraram o scout, que faz a varredura no contexto dele e devolve só o resumo, e o teto de turnos por papel. O RTK, que comprime a saída dos comandos de terminal, entra como opcional. E se o orquestrador começa a abrir arquivo atrás de arquivo, um hook lembra ele de passar a tarefa pro scout.

Vou ser sincero: não tenho um número de antes e depois pra mostrar. A diferença ficou nítida no uso, mas eu não medi. Por isso deixei no repositório o forge-tokens, que lê os transcritos das sessões e mede o seu consumo. Quem quiser comparar, dá pra fazer na própria máquina.

Mais do que fábrica de projeto

Quando o scout entrou, em setembro, o Forge deixou de ser só fábrica de projeto. O caminho de investigar serve pra olhar um incidente, um banco de dados, um custo ou uma infraestrutura e terminar num relatório, sem nenhuma linha de código.

Tudo que eu fiz nesses meses passou por ele. São mais de 50 projetos e experimentos na minha pasta. A maioria não seguiu em frente e não é pública. Entre os que seguiram estão o Vertex, minha ferramenta de modelagem 3D por código, que vai ganhar um artigo só dele. E as experiências de realidade aumentada que fiz pra Dati, incluindo o portal que abre numa carta. Naquele artigo eu falei das skills de orquestração de agentes e de economia de token que uso em todos os meus projetos. Eram o Forge.

Na Dati eu uso uma versão própria, com ênfase em AWS.

E não fiquei só no meu teste. O Leonardo Prado Suzin também usou o Forge e aprovou.

Pra testar

Dentro do Claude Code:

/plugin marketplace add MatheusRibeir098/forge-claude
/plugin install forge@forge-claude

Depois, na raiz do repositório onde você vai trabalhar:

/forge:setup
/forge:doctor
/forge

O /forge:setup grava as permissões e as regras no CLAUDE.md e mostra o diff antes. O /forge:doctor só confere se está tudo certo. Se você trabalha com interface, tem também o forge-frontend, com skills de React, Tailwind, dark mode e afins.

MatheusRibeir098 / forge-claude

🔥 Fábrica de software para Claude Code: você descreve, um orquestrador decompõe em tarefas e delega para subagentes dev e tester — em paralelo — até entregar validado com prints.

O que é · Como funciona · Como começar · Perguntas · Instalação

O que é

O Forge é um plugin para o Claude Code que transforma uma conversa em uma pequena equipe de software.

Você fala com um único agente, o orquestrador. Ele entende o pedido, divide o trabalho em tarefas e chama o especialista certo para cada uma. A mesma pessoa não faz tudo: quem escreve o código nunca é quem confere se ficou certo.

Em uma frase: é como um mestre de obras que não pega no martelo. Ele planeja e distribui o trabalho, e só considera a obra entregue depois que o fiscal aprova.

Como funciona

Quem	O que faz	Pense nele como
Orquestrador	Conversa com você, escreve a spec, divide em tarefas e distribui. Não escreve código.	o mestre de obras
`dev`	Escreve todo o código e roda build e testes unitários.	o construtor

…

View on GitHub

Se testar, me conta o que achou. Feedback, issue e estrela no repo ajudam muito.

Há 4 meses era uma IA pra tudo, num terminal só. Hoje eu converso com uma só, e ela coordena o resto.

Em 2024 vi o corpo humano em 3D num manequim. Em setembro fiz um portal abrir numa carta

Matheus de Paula Ribeiro — Tue, 13 Oct 2026 12:15:19 +0000

O manequim

Tudo começou de uma lembrança. Em 2024 eu fui no Interação FURB, que é um evento da universidade aqui da minha cidade onde você pode ir nas oficinas e ver um pouco de cada curso. Na oficina de Ciência da Computação o professor apontou o celular pra um código que estava na camisa de um manequim, e na tela apareceu o corpo humano em 3D, por dentro, preso na camisa. Aquilo ficou na minha cabeça.

Dois anos depois resolvi fazer igual.

Um dia pro APK

Dia 23 de setembro eu sentei e fiz um grill-me da ideia, que é basicamente deixar a IA me sabatinar até eu saber o que eu queria de verdade. Não tinha prazo, não tinha cliente, era pra aprender AR nativa mesmo: ler um marcador impresso, ancorar um modelo 3D nele e entender como isso funciona por dentro. Fechei em Unity com AR Foundation e ARCore, só Android.

No dia 24 o APK estava pronto e funcionando. Um marcador impresso, um modelo de anatomia humana em cima, no celular. Era a cena do manequim.

A noite que o CEO passou na minha mesa

Nessa mesma noite o CEO passou por perto e eu chamei ele pra ver. Ele viu e gostou muito! Aí ele me lançou um desafio: fazer isso na web, pra qualquer pessoa conseguir abrir no celular sem ter o trabalho de instalar um app. O quanto antes. Se eu conseguisse, ele ia colocar no camarote da empresa no desfile da Oktoberfest.

Agarrei a oportunidade.

O problema é que eu não conhecia nenhuma ferramenta de AR pra navegador. Nenhuma. Então na mesma noite comecei a pesquisar com a ajuda da IA e cheguei em seis opções. Quatro caíram rápido: uma precisava de flag no Chrome, duas eram plataforma hospedada sem self-host, e WebXR nativo não roda no Safari do iPhone. Sobraram o MindAR e o 8th Wall open source. Fiquei com o 8th Wall porque é MIT, roda em Safari e Chrome, e eu podia hospedar na minha própria conta da AWS.

Aí tudo começou a andar de novo. Deixei o APK de lado e no dia 25 comecei a desenvolver tudo do zero.

Um dia pro site

Dia 25 de setembro foram 84 commits. Scaffolding em TypeScript, three.js e Vite, o portal com a logo da empresa saindo dele, o rastreamento da carta, a infra em S3 e CloudFront, o site publicado e testado num Galaxy S23 FE de verdade. Tudo entre nove da manhã e quatro da tarde.

Quando você aponta o celular pra carta, um portal se abre em cima dela, as peças da logo da empresa sobem lá de dentro, a logo brilha e uma órbita de ícones de serviços da AWS gira em volta, com um selo de parceiro. Tudo no navegador, sem instalar nada. A anatomia ficou pra trás: eu quis fazer algo pensado pra empresa, que fizesse ela se interessar, e por isso o que sai do portal é a logo dela.

O site está restrito por enquanto, então não deixo aqui o link nem a carta pra imprimir. O pedido do CEO era justamente que qualquer pessoa abrisse sem instalar nada, e é assim que ele funciona, só que fechado por ora.

Vale falar de como isso foi feito. O projeto inteiro, tanto o APK quanto o site, foi desenvolvido com o Claude Code. É 100% feito por IA. O que é meu são as skills de orquestração de agentes e de economia de token que eu uso em todos os meus projetos, e o briefing de cada tarefa. Meu trabalho foi decidir, testar no celular e devolver o que estava errado.

Dois números que saíram desse dia e que eu não teria se não tivesse medido:

O portal tremia 1,10° em relação à carta parada, e a meta era 0,5°. Pra resolver usei um filtro One Euro, que suaviza forte quando o celular está parado e solta quando ele se mexe rápido, pra não dar atraso. Numa simulação o tremor caiu pra 0,33°, com um atraso de 0,88° num giro rápido. Esse número veio da simulação, não do celular.
A primeira visita do site pesa 6,48 MB, e quase 5 MB são o motor do 8th Wall. O orçamento era 10 MB, pensando no 4G de um camarote lotado.

Sobre o 8th Wall: o pacote que eu uso é MIT e não inclui SLAM. O SLAM existe só num binário com licença própria, e eu deixei o rastreamento de mundo desligado.

A carta é a parte difícil

Eu achava que o difícil ia ser o 3D. Era a carta.

A primeira carta com QR foi cancelada uma hora depois de gerada. O QR ficou pequeno demais e dentro da área que o 8th Wall rastreia. O Claude me explicou que o QR tem muito padrão repetitivo, e isso atrapalha a ancoragem. O guia de imagens rastreadas do Google também desaconselha QR e código de barras. Eu não medi isso sozinho, foi o que o Claude me explicou e o que o guia diz. A solução foi tirar o QR do recorte rastreado e colocar numa faixa própria, embaixo.

Imprimi pelo menos umas quinze cartas diferentes pra testar ancoragem.

Coisas que só aparecem na mão de alguém

O primeiro protótipo tinha bastante som. Um deles era um zumbido em loop enquanto o portal ficava aberto. Eu achei que parecia helicóptero. Todo mundo pra quem eu mostrei achou que parecia helicóptero. Era ridículo. Foi removido.

Nada disso aparece pro agente. Aparece quando você aponta o celular.

Depois disso veio o Oktobercloud, outro projeto no mesmo repo: uma caneca de chopp que enche e brinda em cima de um porta-copo. O desafio virou outro, achar um modelo 3D gratuito decente e animar. A caneca eu fui atrás na mão, no Sketchfab, e os agentes fizeram uma pesquisa pesada de como manipular no Blender. A caneca saiu de 6,47 MB pra 252 kB. No fim ele não foi usado, mas ficou uma animação bem legal.

O que ficou

O desfile da Oktoberfest tem datas até 24 de outubro e ainda não tivemos retorno sobre o camarote em si.

O que ficou é o repo: 107 PRs, esteira de CI/CD com deploy automático e um Lab com receita e lição de cada efeito. É a coisa mais completa que eu já construí.

Aprendi bastante. Algumas horas de estudo e pesquisa com o Claude me ensinaram AR e, principalmente, modelagem 3D. Descobri ferramentas novas. Vi que, com as skills certas e ordens bem dadas, dá pra fazer o Claude gerar modelos 3D e 2D muito bons. E vi que existem ferramentas open source de AR muito boas, que funcionaram de verdade nesse projeto.

O APK ficou parado por enquanto. Quero voltar nele pra fazer coisas mais robustas.

Em 2024 eu era o cara olhando pro manequim. Em setembro fui eu que fiz o portal abrir.

Crédito: o modelo da caneca é o "Beer", do chiwei, no Sketchfab, licença CC BY 4.0, adaptado.