Processo / Construção com IA
Como eu construo com IA
Ferramentas que eu uso
- Claude Code
Meu ambiente principal de construção: plano, código, testes e revisão, no app desktop. A plataforma da Shopper foi construída com ele.
- Superpowers
Plugin de skills de processo para o Claude Code: brainstorming antes de criar, plano escrito, TDD, depuração sistemática, revisão de código e verificação antes de dizer que terminou.
- MCP
Ligo os agentes aos sistemas por servidores MCP só de leitura, como o da plataforma da Shopper.
- OpenBot
Onde roda o time de agentes do Marta (Mari, Robocop, Da Vinci, Decartes e Íris), cada um com rotina, papel e limite.
Eva e Renato Vault
A Eva é a minha agente pessoal, e a Renato Vault é o cérebro dela: uma vault no Obsidian com a minha memória canônica. Qualquer ferramenta de IA que eu uso chega à mesma memória pela skill da Eva, então o contexto sobre quem eu sou, o que decidi e em que estou trabalhando não se perde entre uma ferramenta e outra.
Arquitetura
Passe o mouse ou toque numa peça do desenho para ver o que ela faz.
Como a Eva busca
- IntençãoIdentifica o que foi pedido e as pessoas, projetos ou sistemas citados.
- Nota operacionalAbre a nota operacional atual do assunto.
- RegistroAbre o registro semântico correspondente.
- DossiêAbre o dossiê da entidade quando a evolução importa.
- BuscaRoda search ou context na vault.
- FontesAbre de três a oito fontes originais.
- RespostaDado exato vem da fonte original; o que falta é declarado.
Como a Eva grava
- AvisoMostra "Eva está salvando uma memória..." antes de gravar.
- PreservaNunca apaga uma fonte anterior; a substituição fica registrada.
- CapturaGrava a mudança durável com origem auditável.
- ConsolidaAtualiza a nota operacional, o registro semântico e os derivados.
- AuditaRoda o audit na vault.
- ConfirmaSó depois da verificação mostra "Memória salva na Renato Vault".
Quem vale mais quando há conflito
- A correção ou decisão atual do Renato
- A nota operacional atual, datada e explícita
- A memória viva mais recente
- A fonte histórica importada
- A inferência, sempre identificada como tal
O que ela não guarda
Conversa casual, conteúdo temporário, hipótese não confirmada, segredos, tokens, senhas e chaves. Dado muito sensível ou de outra pessoa só entra com confirmação.
Na prática, no MARTA
O processo documentado começa com contexto persistente. AGENTS.md orienta o trabalho; a vault em docs/memoria guarda estado atual, decisões técnicas e histórico de sessões. Specs registram problema, limites e critérios; planos dividem a implementação e os testes. O exemplo verificável é o agente de Alavancas, com spec e plano próprios. Isso permite retomar o trabalho com contexto explícito e revisar escolhas. Não significa que toda feature teve a mesma disciplina ou que testes presentes estejam passando hoje.
Renato define o problema e as decisões de produto; a IA produz alternativas e implementações, que precisam de revisão e validação. A afirmação de construção individual vem do plano e deve ser confirmada pelo Renato.
Na prática, na Shopper
Claude Code como time de engenharia (Agente de IA)
Na Shopper, a plataforma de logística foi construída com o Claude Code, num processo que desenhei para a IA trabalhar com contexto e não perder o fio entre uma sessão e outra.
Uma skill própria do projeto diz o que ler antes de começar (o estado de cada módulo, onde a última sessão parou, o plano da frente e a especificação do módulo), traz receitas testadas para módulo novo, migração de banco e publicação, e define o fechamento obrigatório de cada tarefa.
Nenhuma frente começa sem plano: ela nasce com perguntas para mim, e só depois que eu decido é construída. No fim de cada sessão, um verificador aponta qual documento ficou desatualizado em relação ao código.
- PlanoCada frente nasce como um plano com perguntas para mim.
- DecisãoEu respondo e decido; só então a frente é construída.
- Claude CodeConstrói seguindo a skill do projeto e as receitas testadas.
- TestesTestes automatizados a cada mudança.
- DocumentaçãoSpecs, decisões e diário de sessões atualizados; um verificador aponta o que ficou velho.
- Próxima sessãoComeça lendo o estado e onde a anterior parou.
Como as peças se ligam
O Claude Code trabalha dentro do repositório, guiado pela skill do projeto. Eu entro no plano e nas decisões; o verificador fecha cada sessão.
Passe o mouse ou toque num passo para destacar as peças envolvidas no desenho.
O que ele lê antes de começar
Tudo está no repositório e é indicado pela skill do projeto.
| Fonte | Para quê |
|---|---|
| Skill do projeto | O que ler, receitas testadas e o fechamento obrigatório de cada tarefa |
| Estado dos módulos | Saber o que já existe antes de mexer |
| Diário de sessões | Onde a última sessão parou e o que ficou pendente |
| Plano da frente | As perguntas que eu já respondi |
| Especificação do módulo | O sistema como ele está hoje |
O que ele entrega
Cada tarefa fecha com código e memória atualizados.
- Código com testes
- Testes automatizados a cada mudança.
- Specs atualizadas
- Cada especificação declara quais arquivos de código ela cobre.
- Registro de decisões
- O que foi decidido, por quê, quais alternativas e quem decidiu.
- Diário de sessões
- O pedido, o que foi feito e o que ficou pendente.
O que o processo impede
O que fez a diferença não foi o prompt de cada tarefa, foi o sistema em volta.
Cada frente nasce como um plano com perguntas, e quem decide sou eu.
Cada spec declara os arquivos que cobre; o verificador aponta a que ficou desatualizada.
Um gancho do Claude Code roda o verificador no fim de cada sessão.
Toda sessão começa lendo o estado dos módulos e onde a anterior parou.
Testes automatizados a cada mudança.
O registro guarda o que foi decidido, por quê, as alternativas e quem decidiu.
Demonstração
Demo a gravar mostrando uma sessão de trabalho com os agentes: contexto, plano, testes e revisão.
Fonte editorial: seção "Como eu construo com IA" do case MARTA (conteudo/marta/case.md).