O Padrão Ouro do Agentic Value Loop: Automatizando a Entrega de Valor

Introdução

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:

1. Idea: A concepção e o contexto.
2. Plan (SDD): O design técnico da solução (nunca codifique sem um plano).
3. Implement: A execução guiada pelo plano.
4. Test: Verificação local rigorosa.
5. Gate: A validação absoluta (CI/Lint/Typecheck).
6. Ship: O commit atômico e a PR.
7. 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.

Plugin: https://github.com/Andersonlimahw/lemon-ai-hub/tree/main/plugins/agentic-value-loops