Agentic Value Loop o Padrão Ouro : Automatizando a Entrega de Valor
São 18h de uma sexta-feira. Você pede para seu agente de IA implementar uma nova funcionalidade de pagamento. Meia hora depois, ele gerou 800 linhas de código, alterou arquivos que não devia, e a suíte de testes está vermelha. O agente tenta consertar, mas entra em um loop infinito de erros.
Você já esteve lá. Todos nós já estivemos.
A promessa de engenheiros de IA autônomos esbarra na realidade da entropia de código: agentes que geram muito, mas entregam pouco valor testado e pronto para produção.
A diferença entre agentes de brinquedo e um time de IA nível produção não é o tamanho do LLM. É a metodologia de iteração.
Após observar dezenas de iterações do financial-architect (o agente de arquitetura do projeto VibingCash), ficou claro que o desenvolvimento agentic precisa de um Playbook Determinístico. Foi exatamente isso que foi consolidado na PR #68 do VibingCash.
Neste artigo, vou dissecar o "Agentic Value Loop", o padrão ouro de iteração agentic que garante um incremento verificado de valor por ciclo, sem loops de erro infinitos e sem código quebrado.
A Mudança de Paradigma: O Agentic Value Loop
A maioria das interações com IA hoje funciona em um modelo "Prompt -> Código -> Rezar". Você passa um requisito, a IA gera o código, e você espera que funcione.
O Agentic Value Loop é uma esteira de produção em 7 fases. O objetivo? Entregar exatamente um (1) incremento de valor aprovado pela única porta de qualidade (npm run version:validate).
Em vez de deixar o agente correr livre, nós o amarramos a um contrato estrito:
- Idea: A concepção e o contexto.
- Plan (SDD): O design técnico da solução (nunca codifique sem um plano).
- Implement: A execução guiada pelo plano.
- Test: Verificação local rigorosa.
- Gate: A validação absoluta (CI/Lint/Typecheck).
- Ship: O commit atômico e a PR.
- Reflect: A retrospectiva da máquina.
O Poder da Regra 8: "Automate the Second Time"
A maior sacada da PR #68 não são as 7 fases em si, mas a regra §8 do LOOP_TEMPLATE.md: Automatizar na segunda vez.
Toda iteração do loop não deve apenas gerar código de produto. Ela deve extrair um asset reutilizável: um script, uma skill do Claude, um subagente ou uma ferramenta MCP.
O workflow pré-Loop:
Você: "Mude esse componente para usar a nova API financeira."
Agente: Apanha com regras de RLS do Supabase, esquece de rodar o financial-qa, quebra build.
Você: "Lembre de usar RLS e rodar os testes..."
O workflow com Agentic Value Loop:
O Agente planeja a feature. Na fase de Implementação, ele usa a skill write-a-skill para criar uma automação específica se notar um padrão repetitivo. Na fase de Reflect, ele documenta o que aprendeu no ITERATION_LOG_TEMPLATE.md e alimenta a skill /error-fix-loop com a "Never-Repeat list".
Na próxima vez, o agente já possui as ferramentas perfeitas para o trabalho.
Anatomia Prática: Dissecando a PR #68
A Pull Request 68 do VibingCash é o manifesto prático desta metodologia. Vamos olhar o que foi adicionado:
1. LOOP_TEMPLATE.md
O contrato base de 7 fases. Ele define invariantes absolutas, como o checklist de guardrails (Repository Pattern, ActionResult<T>, RLS, after() logging) e o uso da única porta de qualidade.
2. PLAN_TEMPLATE.md
O esqueleto do Software Design Document (SDD). Antes de qualquer código ser escrito, um plano é salvo em docs/features/<feature_name>/PLAN.md. A parte mais importante? A seção "reusable assets to extract". O plano exige que o agente pense em ferramentas.
3. ITERATION_LOG_TEMPLATE.md
A memória de curto prazo da iteração. Onde o agente anota o que extraiu e o que nunca mais deve repetir.
4. Exemplos Reais (loops/examples/)
A PR não entregou apenas teoria. Ela incluiu loops resolvidos para desenvolvimento de features, manutenção de segurança, sincronização de documentação e até tunagem de IA.
As Ferramentas do Loop: Skills, Agents e MCPs
O Value Loop só funciona porque é alimentado por ferramentas afiadas. A documentação lista as ferramentas de criação de assets:
financial-new-agent: Para criar novos subagentes.write-a-skill: Para destilar prompts repetitivos em skills de linha de comando.mcp-builder: Para transformar scripts locais em ferramentas MCP universais.Agent Development: A skill mestre para orquestrar agentes complexos.financial-chat-runtime-integrator: Para conectar a IA com o core de negócios.
Esta é a mágica do ecossistema: a infraestrutura se auto-alimenta e o projeto fica mais inteligente a cada iteração. A cada bug resolvido, o sistema se vacina contra aquela classe de bugs no futuro.
Conclusão: Pare de Microgerenciar Sua IA
A mudança do uso ad-hoc de IA para o Agentic Value Loop é o equivalente ao salto do "codar na master" para o Git Flow e CI/CD.
A PR #68 do VibingCash nos mostra que a documentação da metodologia é tão importante quanto o código. O playbook é descritivo, guiando tanto humanos quanto agentes em como iterar com segurança e extrair valor contínuo sem quebrar o ecossistema financeiro.
Na próxima vez que você pedir algo para seu agente, pergunte-se: "Onde está o plano? Qual é a porta de qualidade? O que vamos extrair disso para automatizar na segunda vez?"
Se você tem as respostas, você está operando no Padrão Ouro.
PS: Eu deixei estas e outras skills neste repositório https://github.com/Andersonlimahw/lemon-ai-hub dedicado a tools de AI que tenho criado para auxiliar no desenvolvimento do dia a dia.
Blog post:
https://lemon.dev.br/pt/blog/agentic-value-loop
Meu novo marketplace de skills e plugins para desenvolvimento com AI
https://github.com/Andersonlimahw/lemon-ai-hub
Plugin:
https://github.com/Andersonlimahw/lemon-ai-hub/tree/main/plugins/agentic-value-loops