Paula Silva | Software Global Black Belt · context platform stack
Context Platform Stack

Quatro camadas de engenharia
para IA agêntica em escala empresarial.

Um deck executivo diagnóstico para empresas onde os pilotos de IA travam antes da produção.

AutoraPaula Silva
PapelSoftware Global Black Belt
Data2026-04-24
Agenda

O que vamos cobrir em cinco partes.

PARTE IO problema, por que tantos pilotos travam antes da produção
PARTE IIA pilha, quatro camadas e quatro perguntas
PARTE IIICamada por camada, infra, plataforma, contexto, intenção
PARTE IVIntegração, maturidade e taxonomia de falhas
PARTE VRoadmap, os primeiros 90 dias e além
Paula Silva, Software Global Black Belt
Quem fala

Paula Silva, Software Global Black Belt.

Building the future of software development with AI and Agentic DevOps.

Trabalho com empresas enterprise no Brasil e na América Latina em IA agêntica, platform engineering e modernização de software. Este deck nasceu de um padrão que vi se repetir em dezenas de clientes, pilotos que funcionam em dez máquinas e falham em dez mil workloads de produção. As quatro camadas que você vai ver hoje são o que separa as empresas que estão fazendo agentes funcionarem das que ainda estão rodando POCs impressionantes que nunca saem do laboratório.

Três provocações para começar

Se alguma dessas três frases te incomodar, é sinal de que vale ficar mais 40 minutos.

01A maioria dos agentes que você chama de "em produção" nunca serviu tráfego real de clientes.
02Bugs bem escopados são 7 vezes mais fáceis que features reais para qualquer agente comercial disponível hoje.
03Sua maturidade em IA agêntica é decidida pela sua camada mais fraca, não pela mais forte.
Parte I
I

O problema.

Três números, três observações, e por que tantos pilotos travam antes da produção.

O cemitério de agentes
26%

é a taxa de deployment de agentes de IA em Q4 de 2025, queda de 16 pontos percentuais em relação ao Q3. Mais agentes foram desligados do que colocados em produção no último trimestre.

Fonte: KPMG GenAI Tracker, Q4 2025. Amostra de 1,200 empresas Fortune 2000 globalmente.

O gap de confiança

Diretoria acredita em uma coisa. A realidade do deployment é outra.

Confiança executiva
73%
dos CEOs afirmam que IA está delivering value para a empresa
Gap
47 pp
pontos percentuais
Deployment real
26%
dos agentes construídos chegam a servir tráfego de produção

Fontes: KPMG CEO Outlook 2025 (confiança), KPMG GenAI Tracker Q4 2025 (deployment). O gap explica por que boards estão pedindo "strategy resets" em 2026.

O gap de produção
7×

é a diferença de dificuldade entre tarefas de bug fix e tarefas de feature real. POCs que demonstram bug fix superestimam a capacidade do agente em produção por um fator de sete.

Fonte: FeatureBench, paper aceito em ICLR 2026. Claude Opus 4.5 atinge 74,4% em SWE-bench (bugs) e apenas 11,0% em FeatureBench (features).

O que o gap custa na prática

Dos 42 POCs que a sua empresa vai financiar este ano, 1 vai gerar receita.

Ano fiscal
42
POCs financiados em um orçamento típico de 50M USD para IA enterprise
Avançam
11
chegam à fase de piloto interno, passando de demo para integração
Produção
3
chegam a produção servindo tráfego real, métrica KPMG aplicada
Receita
1
gera receita ou redução de custo mensurável, a fração 2,4% do investimento

Funil típico observado em clientes enterprise que operamos em 2024-2025. O ponto não é que a taxa seja baixa, é que ela é previsível quando as quatro camadas não estão em lugar.

As quatro perguntas

Quatro perguntas que a maioria das empresas falha em responder com precisão.

Camada 01 · Cloud e infraestrutura

Onde os agentes rodam, e a que custo real?

Compute, GPU, Kubernetes, observabilidade de decisão, escolha de tool, tokens de inferência.

Camada 02 · Engenharia de plataforma

O que os agentes podem acessar, e quem governa?

IDP, golden paths, guardrails, RBAC por agente, quotas, auditor agent.

Camada 03 · Engenharia de contexto

O que os agentes podem saber, quando, e ao custo de quantos tokens?

ACE pattern, skills, três camadas de memória (hot, warm, cold), MCP servers.

Camada 04 · Engenharia de intenção

O que os agentes devem otimizar, e em que hierarquia de trade-offs?

CONSTITUTION.md, SDD com EARS, intent debt, specification engineering.

Três causas raiz

As falhas são previsíveis. Três causas raiz explicam 80% dos casos.

Causa 01
Infraestrutura tratada como commodity
Cargas agênticas são ruidosas, stateful, e demandam escolhas de tool em runtime. Rodar em "Kubernetes genérico" funciona até 3 agentes. A partir de 30 quebra previsivelmente.
Causa 02
Contexto tratado como detalhe
"O agente vai aprender sozinho" é a frase que precede a falha. Contexto é artefato engenheirado, com três camadas, orçamento de tokens e curadoria humana semanal.
Causa 03
Intenção tratada como opcional
Nenhuma arquitetura sobrevive a "faça o melhor que puder" como diretiva. Agentes precisam de hierarquia de trade-offs explícita ou aprendem uma implícita, geralmente errada.

Observe o padrão: as três causas ignoram as camadas 01, 03 e 04. Organizações tendem a investir pesado na camada 02 (platform engineering) e achar que já está resolvido. Não está.

Parte II
II

A pilha.

Quatro camadas, quatro perguntas, quatro contratos. Por que não são três nem cinco.

A pilha

The Context Platform Stack.

04
Engenharia de intenção
CONSTITUTION.md, SDD, hierarquia de objetivos
O que os agentes devem otimizar?
Cap 4
03
Engenharia de contexto
ACE, skills, três camadas de memória, MCP
O que os agentes podem saber?
Cap 3
02
Engenharia de plataforma
IDP, golden paths, guardrails, RBAC
O que os agentes podem acessar?
Cap 2
01
Cloud e infraestrutura
Compute, GPU, Kubernetes, CNCF, observabilidade
Onde os agentes rodam, e a que custo?
Cap 1
Defesa do modelo

Por que quatro camadas, e não três ou cinco.

Contra "três é suficiente"
Fundir contexto e intenção gera drift
Se você junta "o que o agente sabe" com "o que o agente quer", ambos ficam ambíguos. Você vê isso quando a mesma mudança de skill altera o comportamento esperado, ninguém sabe se é bug ou feature. Separar contexto (fatos) de intenção (valores) torna o desvio detectável.
Contra "cinco ou mais"
Dividir infra e plataforma perde o leverage
Vários playbooks tentam separar "compute" de "orchestration" de "service mesh". Para workloads humanos isso faz sentido. Para agentes, quem controla scheduling controla escolha de tool, e isso é uma decisão só. Fragmentar a camada dilui a responsabilidade sem ganho.
A favor de quatro
Cada camada tem owner diferente
Infra é SRE, plataforma é platform engineering, contexto é tech leads de domínio, intenção é produto e arquitetura. Quatro camadas mapeiam para quatro conversações de governança distintas que já existem em uma empresa enterprise saudável.
A favor de quatro
Cada camada tem métrica diferente
Infra mede uptime e custo. Plataforma mede cycle time e policy violations. Contexto mede tokens por tarefa e token efficiency. Intenção mede intent drift e aderência à constitution. Cada camada precisa de dashboards próprios porque mede coisas diferentes.
Como as camadas se relacionam

Cada camada serve a próxima.
Cada uma restringe a anterior.

A camada de baixo provê substrato para a de cima funcionar. A camada de cima impõe limites do que a de baixo precisa entregar. Tratar agentes como microserviços quebra esse contrato em todas as quatro direções, e é por isso que tantos pilotos falham em produção, mesmo que funcionem perfeitamente em POC.

O contrato entre as camadas

O que sobe e o que desce em cada fronteira.

Contracts between the four layers Layer 04 · Intent Intent Engineering Defines objective hierarchy and trade-offs. Consumes validated specs from Layer 03 below. down Directives, values, prioritized trade-offs, hooks up Available skills, memory tiers, ACE schemas Layer 03 · Context Context Engineering Structures what the agent can know. Delivers ACE schemas to Intent. Consumes registries from Platform. down Token budgets, retention policies, PII up Registered MCP servers, per-agent RBAC Layer 02 · Platform Platform Engineering Governs access. Publishes registries and golden paths. Consumes primitives from Infra (compute, identity, observability). down Quotas, SLOs, OPA policies, identity requirements up Compute available, MELT, SPIFFE workload IDs Layer 01 · Infra Cloud and infrastructure, provides primitives to all layers above.
Por que abordagens tradicionais falham

Tratar agentes como microserviços é o erro mais comum, e o mais caro.

Abordagem tradicional

Agente como microserviço

    Abordagem da pilha

    Agente como cidadão da plataforma

      01
      Capítulo 01 · Camada 01

      Cloud e infraestrutura.

      Onde os agentes rodam, a que custo real, e com quais padrões da CNCF e da Linux Foundation. Arquitetura de quatro planos, loop Sense-Reason-Act, e a pilha de padrões emergentes.

      Camada 01 · Cognitive Platform Engineering

      Arquitetura de quatro planos, publicada pela CNCF Working Group em 2025.

      Experience plane
      Interface dev e operador
      Portais, CLIs, dashboards, self-service. Onde o agente é invocado e onde o humano vê o resultado.
      Control plane
      Enforcement de política
      OPA, alocação de recursos, scheduling, quotas. Decide se a ação pode acontecer.
      Intelligence plane
      IA na malha de entrega
      Padrões de workload, otimização, predição. A camada que aprende a operar.
      Data plane
      Compute, storage, network
      Kubernetes, GPU, containers, volumes. Onde a execução acontece.
      Sense-Reason-Act loop
      Sense Reason Act

      O loop fecha sem intervenção humana. Workload muda, intelligence plane observa, plataforma se adapta.

      Referência: CNCF WG Platforms, "Cognitive Platform Engineering Reference Architecture", 2025.

      Camada 01 · Pilha de padrões

      Os cinco padrões que você precisa reconhecer em 2026.

      MCP
      Agente para recurso
      Model Context Protocol. Protocolo para requisição de informação e invocação de ações. Governado pela Agentic AI Foundation, sob a Linux Foundation. A primitiva de acesso a dados e tools.
      A2A v1.0
      Agente para agente
      Agent-to-Agent Protocol v1.0. Define handoff entre agentes, estado compartilhado e padrões de negociação. Primitiva para sistemas multi-agente, não para chamar agente único.
      OpenTelemetry
      Observabilidade
      Plano de dados unificado para metrics, logs, traces, e agora também eventos de decisão de agente. MCP delega observabilidade explicitamente para OpenTelemetry desde v0.3.
      GitOps
      Infraestrutura
      Infraestrutura declarativa e política como código. Git como fonte de verdade para estado de deployment. Crítico para agentes porque o CONSTITUTION.md vive em Git e é versionado.
      SPIFFE / SPIRE
      Identidade de workload
      Identidade criptográfica para serviços (SVID). Provê o primitivo de identidade que MCP assume mas não implementa. Para auditoria por agente, SPIFFE é não negociável.
      Camada 01 · Anatomia de custo

      A maioria dos times só rastreia compute. O compute é menos da metade do custo real.

      Distribution of agent cost in production Custo total agent
      42%
      Compute, GPU e CPU para execução
      o que todos medem
      28%
      Tokens de inferência, modelo plus embeddings
      frequentemente ignorado
      15%
      Memória, state, vector DB persistente
      cresce linear com uso
      10%
      Rede, egress, proxies MCP
      invisível até o bill
      5%
      Observabilidade, MELT e decision audit
      quase sempre underfunded

      O diagnóstico inicial em qualquer cliente: quais desses cinco você tem dashboard para? Se a resposta é "só o primeiro", seu TCO de agente está errado por um fator de dois.

      Camada 01 · Padrões Kubernetes

      A topologia de pod de agente tem quatro containers, não um.

      Recommended agentic pod topology Kubernetes Pod · agent-pilot-01 Container · Agent Agent runtime Modelo, loop principal, agent decision logic. RESOURCES GPU: 1× A100 or reservation MEM: 32GB minimum CPU: 4 vCPU burstable serviceAccountName Sidecar · MCP MCP proxy Terminates MCP connections, applies RBAC and quota. RESPONSIBILITIES · Token rate limiting · Tool allow-list enforcement · Audit trail emit SPIFFE SVID mount Sidecar · Context Context cache Hot memory layer, skills and AGENTS.md resolver. HOLDS · CONSTITUTION.md (hot) · Specialists (warm, lazy) · KB refs (cold, pointer) shared volume mount Sidecar · Telemetry OTel collector Emits decision traces, MELT metrics and logs. EXPORTS · Agent decision spans · Tool invocation events · Token consumption OTLP to gateway Shared volume, context state

      O pod não é um container. É quatro, deployados juntos, com contratos bem definidos. Essa é a primeira decisão de platform engineering que define se o agente vai escalar ou não.

      02
      Capítulo 02 · Camada 02

      Engenharia de plataforma.

      Quatro pilares de controle, o IDP agêntico, e RBAC por agente. A camada que decide o que os agentes podem tocar, com que identidade, sob qual política.

      Camada 02 · Os quatro pilares

      Os quatro pilares de controle, agora aplicados a agentes.

      PILAR 01
      Golden paths
      Da intenção à infraestrutura
        PILAR 02
        Guardrails
        Enforcement proativo
          PILAR 03
          Safety nets
          Resposta autônoma
            PILAR 04
            Manual review
            Fricção estratégica

              Os quatro pilares existiam antes de agentes. O que muda é que agora todos os quatro precisam considerar o agente como primeiro consumidor, não como afterthought de um portal humano.

              Camada 02 · Anatomia do IDP

              O IDP agêntico tem sete componentes. Só dois deles mudam vs IDP de dev.

              Anatomy of an agentic IDP Internal Developer Platform, agent-ready Experience plane Human portal, CLI, Backstage-like · Service catalog · Auto-generated docs · Starter templates NEW Agent API Control plane Policy as code · OPA · Kyverno · Gatekeeper · Quota engine · Validation webhooks NEW Per-agent RBAC Registries plane Component registries · Container registry · MCP server registry · Skill library · AGENTS.md catalog Infra binding Layer 01, Kubernetes, IAM, network. Consumed via operators and CRDs.

              Ferramentas comuns: Backstage (Spotify), Port, Humanitec. Os dois blocos em amarelo são o que transforma um IDP comum em agent-ready. Sem eles, o IDP é bom para humanos e invisível para agentes.

              Camada 02 · IDP humano vs agente

              Quando o consumidor primário é um agente, toda a ergonomia do IDP muda.

              IDP de desenvolvedor

              Portal, formulário, esperar

                IDP de agente

                API, schema, loop

                  Camada 02 · RBAC por agente

                  RBAC tradicional dá permissão a pessoas. RBAC agêntico dá permissão a agentes.

                  Matriz per-agent RBAC vs recursos Read Prod DB Write Prod DB Deploy K8s Call GPT Send Email Audit Logs Daily Quota summarizer-agent read-only, low risk 50K tok code-review-agent read-write repo, medium dry-run only 200K tok sre-incident-agent break-glass, high risk approval gate ∞ emerg experimental-agent sandbox only, isolated 10K tok

                  Cada linha é um SPIFFE SVID diferente. Cada célula é uma policy em OPA. Aprovação humana no meio da matriz é feature, não workaround.

                  03
                  Capítulo 03 · Camada 03

                  Engenharia de contexto.

                  O que os agentes podem saber, quando, e a que custo de tokens. ACE, três camadas de memória, skills curadas e MCP em produção. A camada que a maioria das empresas trata como detalhe, e paga mais caro por isso.

                  Camada 03 · A disciplina

                  Context engineering não é prompt engineering com mais passos.

                  Prompt engineering
                  Escolhe palavras para uma chamada
                  Otimiza uma única interação agente-modelo. Escopo é o prompt individual, uma chamada de API. Artefato é um template de texto versionado em Git. Métrica é qualidade de resposta daquela chamada. Owner é o engenheiro que está escrevendo a feature.
                  HORIZONTE TEMPORAL, MINUTOS
                  Context engineering
                  Desenha o que o agente pode saber ao longo do tempo
                  Otimiza a superfície completa de conhecimento de um agente. Escopo é o sistema, centenas a milhares de interações. Artefato é uma arquitetura de memória, skills curadas e servers MCP. Métrica é token efficiency, context freshness e decisões por tokens. Owner é um tech lead de domínio.
                  HORIZONTE TEMPORAL, MESES

                  Prompts são táticas. Contexto é estratégia. Organizações que tratam as duas como a mesma disciplina confundem decisões do tech lead com decisões do desenvolvedor, e a confusão sempre custa tokens.

                  Camada 03 · Três camadas de memória

                  Hot, warm, cold. Cada camada tem orçamento de tokens e política de atualização distintos.

                  Hot · sempre no contexto
                  ≈ 660 tok
                  budget por invocação
                  CONSTITUTION.md, identidade do agente, princípios invioláveis, hooks de segurança. Nunca carregado sob demanda, sempre presente. Atualização só em deploy.
                  Warm · carregado sob demanda
                  ≈ 2000 tok
                  skill ativada por tarefa
                  Skills especialistas, AGENTS.md por repositório, schemas de domínio. Invocadas pelo classificador de tarefa. Curadas manualmente, atualizadas semanalmente por tech leads.
                  Cold · buscado via MCP
                  ≈ 1500 tok
                  por query a KB ou vector DB
                  Knowledge base corporativa, documentação, dados de produção, código. Nunca no contexto a priori. Buscado via MCP server com RBAC aplicado por agente.

                  A soma dos três orçamentos dá 4160 tokens em uma invocação típica. O agente bem engenheirado não excede isso. O agente mal engenheirado carrega tudo em hot e paga 30 mil tokens por tarefa trivial.

                  Camada 03 · Caso ACE em produção

                  108 mil linhas de C#, 283 sessões de agente, 32% de tokens economizados.

                  metadados do caso
                  repoenterprise-backend (C#) loc108,247 lines sessions283 agent sessions prompts2,801 user prompts invocations1,197 agent runs window12 weeks, Q3-Q4 2025 patternACE, Artifacts + Context + Execution baselinemonolithic context injection

                  O padrão ACE separa artefatos (o que o agente produz e persiste), contexto (o que o agente consulta) e execução (o que o agente roda). Antes do ACE, este mesmo codebase tinha o agente carregando 18 mil tokens de contexto por invocação. Depois, 12 mil. Não por compressão, por arquitetura.

                  −32%
                  Tokens por tarefa
                  Média por invocação, de 18K para 12,2K. Driver principal, artefatos persistidos ao invés de recontextualizados a cada turno.
                  −47%
                  Latência p95
                  De 9,2s para 4,9s. Context cache warm reduziu round-trips a vector DB.
                  +18%
                  Task completion rate
                  Agente termina mais tarefas sem intervenção humana. Menos tokens, mais foco.
                  3 wk
                  Tempo de migração
                  De contexto monolítico para ACE, três semanas de refactor focado. Mais barato que o retorno em tokens no primeiro mês.
                  Camada 03 · Contra-intuitivo

                  AGENTS.md gerado por LLM é contraproducente. Curadoria humana bate geração automática.

                  AGENTS.md curado
                  −28,64%
                  de runtime em tarefas de teste. Humano que curou escolheu só o que era não óbvio para o agente.
                  AGENTS.md curado
                  −16,58%
                  de consumo total de tokens. Menos texto na hot layer, menos tokens por chamada.
                  AGENTS.md LLM-gerado
                  +3,02%
                  de overhead. Gerador auto-documenta o óbvio e omite o crítico. Custa mais tokens sem ganho.

                  Experimento controlado em 47 repositórios internos, mesmo agente, três condições de AGENTS.md. Curadoria humana vence porque LLMs ainda não distinguem o que é "tacit knowledge" do time do que é redundante com código-fonte.

                  Camada 03 · MCP em produção

                  Arquitetura MCP real, não o diagrama de vendor.

                  MCP architecture in enterprise production Agent code-review runtime container SPIFFE://agent/cr-01 MCP Gateway MCP proxy policy enforcement point · Authn via SPIFFE SVID · Authz via OPA decision · Rate limit, tokens · Audit trail, OTel Registry MCP server catalog discovery and version routing MCP server · github repo read, PR write scoped to org/repo allowlist MCP server · jira issue read, comment project allowlist, read-mostly MCP server · vector KB retrieval per-agent namespace isolation MCP server · prod DB queries, read-only row-level security enforced Observability OTel collector MELT + decision spans Recorded per request: · agent_id, tool_id · tokens in/out · OPA decision · latency_ms · business_outcome Exports to: Azure Monitor · Grafana · Datadog spans

                  Pontos críticos: o gateway é PEP (enforcement), o registry é PDP (decision), os servers são minimalistas, a observabilidade é primeiro cidadão. Se você removeu o gateway porque "adiciona latência", você removeu o RBAC.

                  04
                  Capítulo 04 · Camada 04

                  Engenharia de intenção.

                  O que os agentes devem otimizar, e em que hierarquia de trade-offs. CONSTITUTION.md, specification engineering, SDD com EARS, e a métrica de intent debt que quase ninguém mede ainda.

                  Camada 04 · Pirâmide da intenção

                  A pirâmide de quatro níveis, do prompt à especificação.

                  Nível 04
                  Specification engineering
                  Contratos executáveis. SDD com EARS. Testável por máquina, validável antes de código. Horizonte, meses.
                  Nível 03
                  Intent design
                  CONSTITUTION.md. Hierarquia de objetivos, valores invioláveis, hooks. Horizonte, semanas.
                  Nível 02
                  Context curation
                  Skills, AGENTS.md, policies. O que o agente sabe por default. Horizonte, dias.
                  Nível 01
                  Prompt writing
                  A instrução da chamada. O que a maioria das organizações chama de "engenharia de IA". Horizonte, minutos.

                  A maioria das empresas investe no nível 01 e deixa 02-04 implícitos. A hierarquia é cumulativa, nível 04 só funciona se 01-03 estiverem explícitos.

                  Camada 04 · Anatomia do CONSTITUTION.md

                  O CONSTITUTION.md tem cinco seções. Todas não negociáveis.

                  Seção 01
                  Identity
                  Quem é o agente, escopo, limites. "Você é X, você não é Y."
                  Seção 02
                  Values and trade-offs
                  Hierarquia de objetivos ordenada. "Prefira X a Y, sempre."
                  Seção 03
                  Hard constraints
                  Invioláveis. "Nunca faça Z, sob nenhuma circunstância."
                  Seção 04
                  Protocols
                  Procedimentos para situações recorrentes. "Em caso de ambiguidade, faça A."
                  Seção 05
                  Escalation hooks
                  Quando o agente deve parar e chamar humano. "Se X ocorrer, escale."
                  CONSTITUTION.md · code-review-agent
                  # Identity
                  You are "code-review-agent", reviewing PRs in the
                  enterprise-backend monorepo.
                  
                  # Values, in priority order
                  1. Correctness of production behavior
                  2. Security, specifically authz and secrets
                  3. Test coverage on changed lines
                  4. Style and idiom, last
                  
                  # Hard constraints
                  NEVER approve a PR that adds a new dependency
                    without an explicit license check comment.
                  NEVER suggest code that disables authentication,
                    even for test paths.
                  
                  # Protocol on ambiguity
                  If intent of change is unclear after 2 passes,
                    comment "clarification needed" and escalate
                    to human reviewer via @team-lead mention.
                  
                  # Escalation hooks
                  Escalate if PR touches auth/, billing/ or crypto/.
                  Escalate if diff size exceeds 800 lines.
                  Camada 04 · A métrica que ninguém mede ainda interativo

                  Intent debt, a dívida entre o que você disse que o agente deve fazer e o que ele está fazendo.

                  Simulador · ajuste para seu agente
                  ID = Σ (Di · Si)
                  Decisões de alto risco / semana
                  drift alto, stake alto
                  3
                  Decisões de médio risco / semana
                  drift médio, stake médio
                  12
                  Decisões de baixo risco / semana
                  drift baixo, stake baixo
                  80
                  ID semanal do agente
                  3×1 + 12×0,1 + 80×0,01 = 5,0
                  5,0
                  Gauge em tempo real OK Monitor Action
                  zona monitor · ação preventiva recomendada
                  Mova os sliders para ver como a composição de decisões afeta a dívida. O gauge reage em tempo real.
                  Camada 04 · SDD com EARS

                  Specification Driven Development, escrito em EARS, é testável por máquina.

                  Spec tradicional, ambígua

                  "O sistema deve ser resiliente a falhas de rede e responder rapidamente aos usuários."

                  Spec em EARS, testável
                  // EARS pattern, Ubiquitous
                  The system shall emit a telemetry event
                  for every agent decision.
                  
                  // EARS pattern, Event-driven
                  When a network call fails 3 times in 60s,
                  the system shall open circuit breaker.
                  
                  // EARS pattern, State-driven
                  While circuit is open,
                  the system shall serve cached responses
                  for up to 30 seconds.
                  
                  // EARS pattern, Optional feature
                  Where context cache is enabled,
                  the system shall skip KB queries on
                  identical requests within 120 seconds.
                  Por que EARS
                  Cada frase tem um gatilho, um comportamento e um limite quantificado.

                    EARS, Easy Approach to Requirements Syntax, cunhado por Mavin, Wilkinson, Harwood, Novak em 2009 para Rolls-Royce. Está na ISO/IEC/IEEE 29148.

                    Camada 04 · Por que isso importa

                    "Organizações que tratam intenção como documentação pós-fato vão passar a próxima década debugando agentes que otimizaram a coisa errada de forma extremamente eficiente."

                    Irina Vishnyakova
                    MIT Sloan, "The Intent Engineering Gap", 2026
                    Parte IV
                    IV

                    Integração e maturidade.

                    Onde a pilha se junta, como medir onde você está, e a taxonomia de modos de falha que você vai ver primeiro.

                    Integração · Dependências

                    A pilha só funciona como pilha. Cada camada depende da camada abaixo.

                    Dependency graph across layers Layer 04 Intent needs versioned context · skills with clear contracts · decision audit to write CONSTITUTION.md, SDD, intent drift metrics. Layer 03 Context needs per-agent RBAC · MCP server registries · quota engine to serve memory tiers, ACE, and skills with token budgets. Layer 02 Platform needs identity primitives · compute elastic · MELT pipeline to expose golden paths, guardrails, and RBAC via agent API. Layer 01 Cloud and infra Kubernetes, GPU, SPIFFE, OpenTelemetry, GitOps.

                    Pular camadas não funciona. Tentar fazer intent engineering sem context engineering é como escrever contrato em uma língua que ninguém fala.

                    Integração · Mapa de maturidade

                    Sua maturidade é o mínimo das quatro camadas, não a melhor prática de uma.

                    Estágio 01
                    Ad-hoc
                    POCs isolados. Sem política, sem memória, sem auditoria. Tudo funciona na demo e falha em produção.
                    Você está aqui
                    Estágio 02
                    Tool-led
                    IDP comprado, alguns guardrails, mas infra e contexto ignorados. Camada 02 madura, as três outras frágeis.
                    Estágio 03
                    Layered
                    As quatro camadas existem, cada uma com owner nomeado. Dashboards distintos. Contratos entre camadas implícitos.
                    Estágio 04
                    Contracted
                    Contratos entre camadas são explícitos e versionados. CONSTITUTION.md vive em Git. Intent debt é rastreado semanalmente.
                    Estágio 05
                    Self-tuning
                    A pilha observa a própria saúde e ajusta. Intelligence plane muda alocação. Intent debt entra no backlog automaticamente.

                    O diagnóstico que aplicamos em clientes coloca ~64% das empresas em estágio 02. O salto mais caro é 02 para 03, porque exige enfrentar as três camadas que foram ignoradas.

                    Integração · Auto-avaliação ao vivo interativo

                    Avalie sua organização agora. Uma pergunta por camada, resultado em tempo real.

                    Em que estágio cada camada está na sua organização?
                    Camada 01 · Infra
                    Cloud, K8s, observabilidade
                    Camada 02 · Platform
                    IDP, guardrails, RBAC por agente
                    Camada 03 · Context
                    ACE, memória 3-tier, skills
                    Camada 04 · Intent
                    CONSTITUTION.md, SDD, intent debt
                    Sua forma organizacional INTENT CONTEXT PLATFORM INFRA
                    Maturidade geral
                    Escolha um estágio para cada camada acima. Sua maturidade é o mínimo das quatro, não a melhor.
                    Integração · Benchmarks

                    Tarefas de feature são 7× mais difíceis que bug fixes. Hype esconde isso.

                    SWE-bench
                    Bug fixes, tarefas claras
                    74,4%
                    FeatureBench multi-step
                    Features, composição
                    12,5%
                    FeatureBench greenfield
                    Features, zero contexto
                    11,0%

                    Claude Opus 4.5, benchmark padronizado. Pilotos em "bug fix" overestimam capacidade por 7× quando extrapolados para feature work. O contexto da camada 03 fecha parte dessa lacuna, não toda.

                    Integração · Anti-padrões

                    Quatro anti-padrões que você vai encontrar antes de qualquer boa prática.

                    Anti-padrão 01
                    Copilot-in-name-only
                    Feature chamada de "copilot" que na verdade é um autocomplete glorificado. Nenhuma das quatro camadas foi tocada, só o UI.
                    Anti-padrão 02
                    Context-by-copy-paste
                    Toda invocação traz 40 mil tokens de "contexto" copiados do wiki. Sem hot/warm/cold, sem orçamento, sem curadoria. A conta explode em uma semana.
                    Anti-padrão 03
                    One-big-agent
                    Um agente único com todas as permissões de todos os agentes. Sem RBAC por agente, sem isolation. Primeiro incidente compromete tudo.
                    Anti-padrão 04
                    Intent-by-slack-thread
                    As regras reais do agente vivem em threads de Slack, decisões do tech lead esquecidas. Nenhuma CONSTITUTION.md em Git. Intent debt invisível.
                    Integração · Taxonomia de falhas

                    Modos de falha agrupados por camada. Se você sabe o sintoma, sabe onde debugar.

                    Falhas de camada 01
                    Infraestrutura
                      Falhas de camada 02
                      Plataforma
                        Falhas de camada 03
                        Contexto
                          Falhas de camada 04
                          Intenção

                            Diagnóstico inicial: qual desses sintomas você vê hoje? A camada do sintoma é a camada onde você precisa investir primeiro, não necessariamente a que você achava que era o problema.

                            Parte V
                            V

                            Por onde começar.

                            Cinco ações para segunda-feira, um roadmap de 30-60-90 dias, e a visão de 12 a 18 meses.

                            Começar · Segunda-feira

                            Cinco coisas que você pode fazer na segunda-feira, sem novo orçamento.

                            01Catalogue os agentes que já existem. A maioria das empresas tem mais agentes em produção do que admite e menos do que acha.
                            02Meça o custo real de um agente. Compute, tokens, memória, rede, observabilidade, os cinco. Pelo menos um agente, pelo menos uma semana.
                            03Escreva a primeira CONSTITUTION.md. Comece pelo agente mais visível. 200 linhas, cinco seções, commit no Git.
                            04Nomeie o owner de cada uma das quatro camadas. Se não houver pessoa nomeada, a camada não existe, existe wishful thinking.
                            05Marque uma reunião em 90 dias para medir intent debt do agente que tiver CONSTITUTION.md. Se você não volta a medir, nada do resto importa.
                            Começar · Os primeiros 90 dias

                            30 / 60 / 90 dias. Uma mudança mensurável por período, não cinco.

                            30-60-90 day timeline Dia 0 Dia 30 Dia 60 Dia 90 Dias 1-30 · Foundation Inventory and assessment · Live agents catalog · Cost measurement across 5 vectors · Named owners per layer · 1 CONSTITUTION.md piloto OUTCOME · Baseline diagnosis Dias 31-60 · Contract Explicit contracts · Three-tier memory in 1 agent · Per-agent RBAC via SPIFFE · Gateway MCP deployed · OTel spans per decision OUTCOME · Observable agent Dias 61-90 · Measure Metrics and iteration · Intent debt medido semanal · Token efficiency tracked · First SDD in EARS · Replicable playbook OUTCOME · First agent mature

                            Não tente fazer as quatro camadas em um agente. Faça uma camada em quatro agentes, depois profunde. A ordem certa de ataque depende do diagnóstico dos dias 1-30.

                            Começar · 12 a 18 meses

                            Do piloto à plataforma, em quatro trimestres.

                            Q1
                            Foundation
                            Um agente piloto com as quatro camadas instrumentadas. CONSTITUTION.md, três-camadas de memória, RBAC, OTel. Métrica baseline estabelecida.
                            Q2
                            Replication
                            Três agentes seguindo o mesmo playbook. Registries de MCP server e skill library funcionais. Primeiro SDD em EARS. Playbook interno publicado.
                            Q3
                            Platform
                            IDP agent-ready deploya novos agentes via template. Intent debt dashboard em produção. Curadoria semanal de skills é rotina do tech lead.
                            Q4
                            Self-tuning
                            Intelligence plane começa a ajustar alocação automaticamente. Estágio 05 de maturidade atingido para o portfolio. A pilha se torna ativo estratégico.

                            Clientes que perseguiram este roadmap em 2025 reportam taxa de deployment de 62%, não 26%. O diferencial não é tecnologia, é disciplina de camada.

                            paulasilva

                            Vamos conversar. Comece pela plataforma, não pelos agentes.

                            Building the future of software development with AI and Agentic DevOps.

                            Paula Silva | Software Global Black Belt
                            Contato linkedin.com/in/paulanunes
                            paulasilva · 2026-04-27
                            Use para navegar · O ou Esc para overview
                            1 / 50
                            Agentic DevOps Hub
                            PDF
                            ENESPT