← Portfólio

Processo / Construção com IA

Como eu construo com IA

Ferramentas que eu uso

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

FERRAMENTAS DE IARENATO VAULT · OBSIDIAN08 - EVAClaude Codee outros agentesCodexmesma ponteMemória localsó cacheSkill Evaponte globalno usuárioAGENTS.mdgovernança e hierarquiaSkill eva-memorysearch, context,capture e auditÁreas 00 a 07identidade, estratégia,execução, portfólio,aprendizado, revisões,diárioRegistros e entidadespessoas, projetos, sistemasMemória vivauma nota por memóriaFontes importadasimutáveis, com hashÍndice e auditoriaindice-memorias.jsonl;audit confere pastase frontmattercarregabusca

Passe o mouse ou toque numa peça do desenho para ver o que ela faz.

Como a Eva busca

  1. IntençãoIdentifica o que foi pedido e as pessoas, projetos ou sistemas citados.
  2. Nota operacionalAbre a nota operacional atual do assunto.
  3. RegistroAbre o registro semântico correspondente.
  4. DossiêAbre o dossiê da entidade quando a evolução importa.
  5. BuscaRoda search ou context na vault.
  6. FontesAbre de três a oito fontes originais.
  7. RespostaDado exato vem da fonte original; o que falta é declarado.

Como a Eva grava

  1. AvisoMostra "Eva está salvando uma memória..." antes de gravar.
  2. PreservaNunca apaga uma fonte anterior; a substituição fica registrada.
  3. CapturaGrava a mudança durável com origem auditável.
  4. ConsolidaAtualiza a nota operacional, o registro semântico e os derivados.
  5. AuditaRoda o audit na vault.
  6. ConfirmaSó depois da verificação mostra "Memória salva na Renato Vault".

Quem vale mais quando há conflito

  1. A correção ou decisão atual do Renato
  2. A nota operacional atual, datada e explícita
  3. A memória viva mais recente
  4. A fonte histórica importada
  5. 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.

Vídeo em produção
  1. PlanoCada frente nasce como um plano com perguntas para mim.
  2. DecisãoEu respondo e decido; só então a frente é construída.
  3. Claude CodeConstrói seguindo a skill do projeto e as receitas testadas.
  4. TestesTestes automatizados a cada mudança.
  5. DocumentaçãoSpecs, decisões e diário de sessões atualizados; um verificador aponta o que ficou velho.
  6. Próxima sessãoComeça lendo o estado e onde a anterior parou.

Demonstração

Vídeo em produçã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).