// MAKING-OF · PET PLANNER · CASE TÉCNICO

Este app foi construído por
uma frota de agentes de IA.
E medimos cada token.

Pet Planner é um SaaS multiplataforma de verdade, em produção. Mas o que ele prova não está na tela do usuário — está em como foi feito: 10 personas de agentes de IA, um pipeline de 7 fases com aprovação humana entre cada uma, e um cost-log que registra token por token. Isto não é um app de pet. É a prova de que a fábrica de agentes entrega.

10 personas de IA 7 fases · aprovação humana 385 chamadas de LLM medidas IA + Pessoas
10
personas de agentes de IA
7
fases com gate de aprovação humana
385
chamadas de LLM num sprint de 8 histórias
71%
de cache hit — economia medida
// O produto (só o contexto)

O que a frota construiu

Para entender a telemetria, primeiro o objeto. Pet Planner é um SaaS multiplataforma de saúde e rotina de pets para tutores no Brasil, entregue como PWA na web e app nativo no celular, ambos sobre a mesma API. Cinco repositórios, um produto — e é sobre a construção deles que esta página fala.

🧩
API
.NET 10
🌐
Web
Nuxt · PWA
📱
Mobile
Flutter
☁️
Infra
Bicep
🤖
AgentWorkspace
a fábrica de IA
// Contract-first

Um contrato, três clientes

OpenAPI e eventos AsyncAPI são a fonte da verdade de ponta a ponta. Os mesmos contratos viram contract tests no CI de API, Web e Mobile — PWA e Flutter falam a mesma língua porque validam o mesmo contrato.

// Segurança & LGPD by design

Postura definida antes da primeira linha

PII criptografada (AES-256), rate limiting por IP, verificação de e-mail obrigatória e blocklist de senhas vazadas. Não é um patch posterior: os agentes seguem essa postura como parte do padrão da organização.

🔎

A honestidade que abre esta página

A IA do Pet Planner está na construção, não no runtime. A API do produto não embarca IA — nenhum LLM responde ao usuário final. É um app construído por agentes de IA, não um app com features de IA. Dizer isso em voz alta é parte da marca: onde há IA, apontamos; onde não há, avisamos.

// Como foi construído

Uma frota de 10 personas num pipeline de 7 fases

O AgentWorkspace é um ambiente multi-agente spec-driven. Cada persona tem um papel definido; nenhuma trabalha sozinha e nenhuma fase avança sem que uma pessoa aprove. É o método ZDZCloud na prática: copiloto primeiro, IA + Pessoas, decisão por evidência.

// A frota
🎯
Orquestrador
orchestrator
📋
Product Owner
product-owner
📐
Arquiteto
architect
🧩
Dev API
dev-api
🌐
Dev Web
dev-web
📱
Dev Mobile
dev-mobile
🔍
Revisor
reviewer
🧪
QA
qa
🛡️
Auditor de Segurança
security-auditor
⚙️
DevSecOps
devsecops
// O pipeline (SDD · spec-driven development)
1

Spec

O Product Owner e o Arquiteto transformam a história em especificação: contratos, critérios de aceite e ADRs. A fonte da verdade nasce aqui — não no código.

Aprovação humana antes de planejar
2

Plan

O Orquestrador desenha o plano de execução e sincroniza com o Azure Boards. O trabalho vira um mapa auditável antes de qualquer agente escrever código.

Aprovação humana antes de fatiar em tarefas
3

Tasks

O plano é decomposto em tarefas paralelizáveis, cada uma com contrato e escopo claros — prontas para serem roteadas aos devs certos.

Aprovação humana antes de desenvolver
4

Dev (paralelo)

Dev API, Dev Web e Dev Mobile trabalham em paralelo sobre o mesmo contrato. Código e testes saem juntos; os contract tests garantem que os três clientes continuem alinhados.

Aprovação humana antes de revisar
5

Review

Revisor, QA e Auditor de Segurança passam o pente-fino: qualidade, cobertura e postura de segurança/LGPD. É onde a máquina desafia a própria máquina — e a pessoa arbitra.

Aprovação humana antes de integrar
6

Merge

Com os gates verdes, a entrega é integrada à base. Contratos e ADRs seguem como registro do que foi decidido e por quê.

Aprovação humana antes de publicar
7

Deploy

O DevSecOps conduz a publicação. O ciclo fecha com a história em produção — e o cost-log de tokens dela já contabilizado.

// A telemetria

O número honesto de um sprint

Toda campanha fala de "economia de IA". Nós mostramos o log. Estes são os números reais de um sprint de 8 histórias do Pet Planner — economia medida, não estimada. É o mesmo instinto de auditabilidade que aplicamos ao código: se não dá para apontar o número, ele não entra.

cost-log · sprint = 8 histórias · Pet Planner AgentWorkspace
8
histórias no sprint
385
chamadas de LLM
3,28 mi
tokens de entrada
71%
cache hit
Aproveitamento de cache nos tokens de entrada71%
71% servidos do cache
Cache hit — 71% Tokens novos — 29%
Derivado: ≈ 8,5 mil tokens de entrada por chamada (média) ≈ 2,33 mi tokens servidos do cache ≈ 0,95 mi tokens novos
📌

Onde essa IA roda — e onde não roda

Estes 3,28 milhões de tokens foram gastos construindo o Pet Planner: escrevendo spec, código, testes e revisão. Nenhum deles roda no app que o usuário abre — a IA está na CONSTRUÇÃO, não no runtime do produto. Medir o custo de construir é o que nos deixa dizer isso com números na mão.

// Por que isso importa para você

A mesma fábrica constrói o seu software

O Pet Planner não é uma exceção montada para o portfólio: é a fábrica de agentes rodando como roda todo dia. O que você viu aqui — a frota, os gates, o cost-log — é o processo que passa a construir o seu produto.

Velocidade da frota

Dev API, Web e Mobile trabalham em paralelo sobre um único contrato. Vários fluxos avançam ao mesmo tempo sem sair do trilho, porque todos validam a mesma fonte da verdade.

🧭

Governança, não caixa-preta

Sete fases, aprovação humana entre cada uma, ADRs e contratos como registro. Você aprova, rejeita ou pede ajuste — a decisão de peso é sempre de uma pessoa. IA + Pessoas.

📊

Custo medido, não prometido

Cada história tem seu cost-log em tokens. Você não recebe uma fatura de "IA" opaca: recebe o número — chamadas, tokens, cache hit — para decidir com evidência.

// O que aprendemos

Três lições que ficaram do log

♻️

Cache não é detalhe — é a conta

71% dos tokens de entrada vieram do cache. Estruturar o trabalho para reaproveitar contexto é o que separa uma frota de agentes cara de uma frota viável. Cache é decisão de arquitetura, não sorte.

  • Contexto estável = tokens reaproveitados

Aprovação humana é o freio certo

Gate entre cada fase evita que um erro de spec vire retrabalho de deploy. A pessoa não desacelera a frota: ela impede que a frota corra na direção errada. Copiloto primeiro, autonomia testada depois.

  • Erro barato: pego cedo, na fase certa
🔬

Medir para decidir

Sem o cost-log, "IA economiza" é fé. Com ele, é planilha. Instrumentar tokens por história transforma a discussão de custo de IA em algo auditável — e honesto sobre onde a IA está e onde não está.

  • O número entra; a suposição, não
// Traga seu projeto para a fábrica

Seu próximo software, construído assim

Multiplataforma sobre um contrato, frota de agentes no desenvolvimento, aprovação humana entre as fases e cada token medido. Vamos conversar sobre o seu projeto — e mostrar o processo, não só o slide.