ECP AI Multi-Agent Squad
Squad de agentes de IA para desenvolvimento de produto completo — do contexto estratégico ao deploy em produção — operado com Human in the Loop (HITL).
Squad Multiagentes de IA — O Conceito
O ECP AI Multi-Agent Squad é um squad de produto completo operado por agentes de IA, onde cada papel tradicional de um time de produto (PM, Designer, PO, Architect, Devs, QA, Ops) é executado por um agente especializado.
O humano atua como decisor estratégico em 12 checkpoints (HITL gates) ao longo do ciclo, aprovando, rejeitando ou redirecionando o trabalho dos agentes. Nenhum agente avança sem aprovação humana.
O squad recebe 3 arquivos markdown + 1 repositório destino e gera todos os artefatos de produto: OKRs, backlog, protótipos, código, testes, CI/CD, dashboard e documentação.
Princípios
O orquestrador coordena e delega. Cada agente executa sua especialidade. O humano decide.
Todo output é registrado em JSON. Toda decisão humana é documentada. Todo feedback é transportado.
Cada skill executa uma tarefa única e pode ser re-executada sem efeitos colaterais.
Como Funciona
briefing + tech + design
validate-inputs.mjs
coordena fases
Estratégia
Discovery
Delivery
Operação
Fluxo do Orquestrador
validate-inputs.mjs) + validação comportamental dos 3 specs. Se falhar, para e informa.{REPO_DESTINO}/{fase}/.Inputs Obrigatórios
O squad não inicia sem os 4 inputs abaixo validados. Os 3 arquivos markdown devem existir na raiz do repositório destino.
O QUE construir — escopo funcional, regras de negócio, público-alvo e restrições.
Seções obrigatórias:
- Produto
- Problema
- Público-alvo
- Contexto de negócio
- Funcionalidades principais
- Regras de negócio
- Restrições
COMO construir — stack tecnológica, arquitetura, padrões e regras invioláveis.
Seções obrigatórias:
- Stack tecnológica
- Arquitetura
- Regras invioláveis de código
- Padrões de projeto
- Deploy e infraestrutura
- Testes
COM QUE CARA — paleta, tipografia, tokens, componentes e diretrizes de design.
Seções obrigatórias:
- Paleta de cores
- Tipografia
- Espaçamento e grid
- Componentes
- Tema / Modo
- Regra de ouro
ONDE gravar — caminho absoluto ou relativo da pasta onde todos os outputs do squad serão gravados.
{REPO_DESTINO}/
├── product_briefing_spec.md
├── tech_spec.md
└── design_spec.md
Validação de Dupla Camada
Script Node.js cross-platform que verifica existência dos arquivos e presença de seções obrigatórias.
node validate-inputs.mjs {REPO_DESTINO}
O orquestrador lê os 3 arquivos e verifica se possuem as seções obrigatórias definidas em shared/schemas/input-contracts.md.
Gera relatório JSON de validação.
Fase 01 — Contexto Estratégico
O que esta fase produz
- Objetivo claro e inspirador para o produto
- Key Results mensuráveis e alcançáveis ligados ao objetivo
- Oportunidades Macro por KR (Dores, Necessidades e Desejos dos clientes)
- Leading indicators para cada KR
- Princípios de produto
- North Star Metric
O que NÃO deve aparecer
- Features ou funcionalidades
- Soluções técnicas
- Wireframes ou referências visuais
- Histórias de usuário
HITL #1 — Perguntas ao Humano
- O Objetivo é inspirador e orienta decisões de produto?
- Os KRs são mensuráveis e alcançáveis no prazo definido?
- As Oportunidades Macro estão ligadas aos KRs corretos?
- São oportunidades reais (dores/necessidades/desejos) ou soluções disfarçadas?
- O escopo está adequado para um ciclo de discovery?
Input: product_briefing_spec.md • Output: {REPO}/01-strategic-context/
Fase 02 — Product Discovery
Sequência de 6 Etapas
| Etapa | Agente | Ação | HITL |
|---|---|---|---|
| 1. Priorização | Product Owner | Recebe a OST da Fase 01 e prioriza oportunidades por impacto nos KRs | #2 |
| 2. Ideação | Product Designer | Gera hipóteses de solução para as oportunidades priorizadas | #3 |
| 3. Protótipo Low-Fi | Product Designer | Wireframe HTML único — mitiga Risco de Valor para o Cliente | #4 |
| 4. Protótipo High-Fi | Product Designer | Protótipo completo com identidade visual — mitiga Risco de Usabilidade + Valor | #5 |
| 5. Estruturação | Product Owner | Transforma hipóteses aprovadas em Épicos, Features e Histórias (SAFe) | #6 |
| 6. Avaliação 4 Riscos | PM + Designer + PO | Avaliação coletiva: Valor (cliente), Valor (negócio), Usabilidade, Viabilidade |
4 Riscos de Cagan
Os usuários querem isso?
Move os KRs?
Os usuários conseguem usar?
Conseguimos construir?
Inputs: product_briefing_spec.md + design_spec.md • Output: {REPO}/02-product-discovery/
Fase 03 — Product Delivery
Sequência de 5 Etapas
| Etapa | Agente | Ação | HITL |
|---|---|---|---|
| 1. Arquitetura | Software Architect | Bounded contexts, contratos de API, DB schema, ADRs, repo scaffolding | #7 |
| 2. Back End | Back End Developer | Endpoints, persistência, services, autenticação, testes | #8 |
| 3. AI Engineer | AI Engineer ∥ Front End | Chatbots, agentes autônomos, RAG pipelines, guardrails de IA (Claude API) | #8.5 |
| 3. Front End | Front End Developer ∥ AI Engineer | Componentes, páginas, integração com API e IA, fidelidade ao design_spec | #9 |
| 4. QA | QA | Shift-left, exploratório, automação, cenários adversariais de IA, quality gates | #10 |
Inputs: tech_spec.md + design_spec.md + backlog aprovado • Output: {REPO}/03-product-delivery/
Fase 04 — Operação de Produto
Sequência
| Etapa | Agente | Ação | HITL |
|---|---|---|---|
| 1. Infraestrutura | Operations | CI/CD pipeline, GMUD, guia de instalação, SLOs, DORA targets | #11 |
| 2. Dashboard + Docs | Operations | Dashboard operacional (4 seções) + site de documentação (todas as fases) | #12 |
Retroalimentação — Decisões do HITL #12
| Resultado | Ação |
|---|---|
| Variação vence e move KRs | Rollout completo. PM atualiza baseline. Próximo ciclo. |
| Nenhuma variação move KRs | Retornar à Fase 02 — revisitar oportunidades e hipóteses. |
| KRs pioram | Retornar à Fase 01 — revisar OKRs e OST. |
| Bug técnico | Retornar à Fase 03 — corrigir e nova rodada de A/B. |
Input: tech_spec.md • Output: {REPO}/04-product-operation/ + {REPO}/docs/
Orquestrador
O orquestrador nunca executa tarefas diretamente. Sua função é coordenar, delegar, gerenciar HITLs e garantir o fluxo entre as 4 fases.
Responsabilidades
- Receber a demanda e identificar em qual fase o trabalho está
- Acionar o agente correto com contexto completo
- Apresentar outputs ao humano nos checkpoints HITL
- Transportar feedback humano para o agente correto
- Gerenciar retroalimentação quando A/B indica necessidade
- Manter
/shared/memory/context.jsonatualizado
Regras do Orquestrador
- Executar uma skill diretamente
- Avançar sem aprovação HITL
- Assumir — sempre transportar contexto completo
- Iniciar sem os 4 inputs validados
- Incluir outputs anteriores aprovados no contexto do próximo agente
- Documentar o feedback do humano antes de retornar ao agente
- Em caso de erro, tentar 1x com contexto adicional antes de escalar
- Informar ao agente o caminho do
{REPO_DESTINO}
Agentes do Squad
10 agentes especializados (1 orquestrador + 9 operacionais), cada um com subagentes e skills atômicas. Total: 38 grupos de subagentes e 138 skills.
Subagentes e Skills
Cada agente possui subagentes especializados que executam skills atômicas. Abaixo o catálogo completo.
Product Manager — Subagentes e Skills
Product Designer — Subagentes e Skills
Product Owner — Subagentes e Skills
Software Architect — Subagentes e Skills
Back End Developer — Subagentes e Skills
AI Engineer — Subagentes e Skills
Front End Developer — Subagentes e Skills
QA — Subagentes e Skills
Operations — Subagentes e Skills
HITL Gates — Human in the Loop
12 checkpoints onde o humano avalia, aprova, rejeita ou redireciona o trabalho dos agentes. Nenhum agente avança sem aprovação explícita.
| HITL | Fase | Pós-Agente | Pergunta Central |
|---|---|---|---|
| #1 | 01 | Product Manager | OKRs corretos? OST sem soluções? |
| #2 | 02 | PO Priorização | Oportunidades certas priorizadas? |
| #3 | 02 | Designer Ideação | Hipóteses aprovadas para prototipar? |
| #4 | 02 | Designer Low-Fi | Conceito validado? Risco de valor mitigado? |
| #5 | 02 | Designer High-Fi | Usabilidade validada? Identidade visual correta? |
| #6 | 02 | PO + PM + Designer | 4 riscos aprovados? Pronto para Delivery? |
| #7 | 03 | Software Architect | Arquitetura sólida? Contratos prontos? |
| #8 | 03 | Back End Developer | APIs corretas? Persistência validada? |
| #8.5 | 03 | AI Engineer | Soluções de IA integradas? Guardrails ativos contra prompt injection e vazamento? |
| #9 | 03 | Front End Developer | Front integrado com back e IA? Design fiel ao design_spec? |
| #10 | 03 | QA | Qualidade aprovada? Pronto para operar? |
| #11 | 04 | Operations | Ambiente pronto? Deploy autorizado? |
| #12 | 04 | A/B Testing | Variação vencedora? O que aprendemos? |
Decisões possíveis em cada HITL
Avança para o próximo agente ou fase.
Avança com restrições documentadas.
Retorna ao agente com feedback detalhado.
Contratos de Comunicação
Todos os agentes se comunicam via JSON padronizado. O orquestrador transporta contexto entre agentes.
{
"phase": "01-strategic-context",
"agent": "product-manager",
"mission": "descrição da missão",
"context": {},
"inputs_from_previous": {},
"hitl_feedback": "feedback (se retorno)"
}
{
"status": "success | error | partial",
"phase": "fase atual",
"agent": "nome-do-agente",
"subagents_used": [],
"skills_used": [],
"deliverables": {},
"open_questions": [],
"next_hitl": 1
}
{
"hitl": 1,
"decision": "approved | rejected",
"feedback": "comentários do humano",
"next_agent": "próximo agente"
}
{
"status": "error",
"agent": "nome-do-agente",
"error_code": "INVALID_INPUT",
"message": "descrição",
"retry_suggested": true
}
Como Executar
Pré-Requisitos
- Claude Code instalado e configurado
- Node.js 20+ (para o script de validação)
- Os 3 arquivos markdown criados no repositório destino
Passo a Passo
product_briefing_spec.md, tech_spec.md e design_spec.md na raiz do repositório destino seguindo o template em shared/schemas/input-contracts.md.
node validate-inputs.mjs /caminho/do/repo-destino
Se retornar exit code 1, corrigir os erros antes de prosseguir.
cd ecp-ai-multi-agent-squad
claude
Inicie a Fase 01 — Contexto Estratégico.
Repositório destino: /caminho/do/repo-destino
O orquestrador vai rodar o pre-flight check, apresentar o relatório de validação e, se aprovado, acionar o Product Manager Agent.
aprovado— avançar para o próximo agenteaprovado com ressalvas— avançar com restriçõesrejeitado+ feedback — retornar ao agente com instruções
docs/ e o dashboard operacional.
Estrutura de Pastas do Squad
ecp-ai-multi-agent-squad/
├── CLAUDE.md # Contrato de entrada + regras globais
├── validate-inputs.mjs # Pre-flight check cross-platform (Node.js)
├── README.md
├── agents/
│ ├── orchestrator/ # Coordenação e HITL
│ │ └── CLAUDE.md
│ ├── product-manager/ # Estratégia e métricas
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── market-research/ (4 skills) competitor-analysis, customer-segmentation, market-sizing, trend-scanning
│ │ ├── product-vision/ (4 skills) vision-writer, north-star-definer, product-principles, opportunity-brief-writer
│ │ ├── product-strategy/ (4 skills) okr-facilitator, four-risks-assessor, assumption-mapper, outcome-roadmap
│ │ └── metrics/ (4 skills) experiment-designer, leading-lagging-indicators, ab-test-analyzer, report-generator
│ ├── product-designer/ # Research, ideação e protótipos
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── customer-research/ (4 skills) continuous-interview-partner, ethnographic-researcher, assumption-tester, insight-synthesizer
│ │ ├── ux/ (8 skills) low-fi-prototyper, high-fi-prototyper, ideation-facilitator, solution-sketcher, information-architecture, interaction-design, accessibility-checker, usability-evaluator
│ │ └── ui/ (4 skills) component-spec, design-tokens, responsive-guidelines, visual-consistency-checker
│ ├── product-owner/ # Priorização e estruturação
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── epic/ (4 skills) epic-writer, enabler-epic-writer, opportunity-brief-writer, opportunity-prioritizer
│ │ ├── feature/ (2 skills) feature-writer, enabler-feature-writer
│ │ └── story/ (4 skills) user-story-writer, acceptance-criteria-writer, story-splitter, functional-documentation-writer
│ ├── software-architect/ # Domínio e arquitetura
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── domain-design/ (6 skills) bounded-context-mapper, aggregate-designer, class-model-designer, ubiquitous-language-builder, context-map-writer, class-diagram-generator
│ │ ├── system-design/ (5 skills) adr-writer, api-contract-designer, data-modeling, evolutionary-architecture, repo-scaffolder
│ │ ├── evaluation/ (4 skills) build-vs-buy, risk-assessment, technical-debt-tracker, tech-radar
│ │ └── enablement/ (4 skills) architecture-pairing, dependency-audit, pattern-advisor, scalability-analysis
│ ├── backend-developer/ # API e persistência
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── api/ (4 skills) api-builder, auth-implementer, contract-enforcer, error-handler
│ │ ├── persistence/ (4 skills) schema-builder, repository-implementer, migration-manager, query-optimizer
│ │ ├── quality/ (4 skills) unit-test-writer, api-test-writer, integration-test-writer, mock-builder
│ │ └── living-docs/ (4 skills) code-commenter, api-documenter, schema-documenter, adr-logger
│ ├── ai-engineer/ # Chatbots, agentes IA, RAG e guardrails
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── chatbot-builder/ (4 skills) conversation-designer, claude-api-integrator, context-manager, prompt-engineer
│ │ ├── agent-builder/ (4 skills) mcp-server-builder, tool-use-designer, agent-orchestrator, autonomous-workflow
│ │ ├── rag-pipeline/ (4 skills) document-processor, embedding-pipeline, retrieval-optimizer, grounded-response
│ │ └── ai-guardrails/ (4 skills) prompt-injection-shield, data-leakage-preventer, scope-enforcer, safety-tester
│ ├── frontend-developer/ # Interface e integração
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── implementation/ (5 skills) component-builder, design-to-code, responsive-implementer, state-management, mobile-identity
│ │ ├── quality/ (4 skills) unit-test-writer, integration-test-writer, e2e-script-writer, accessibility-implementer
│ │ ├── performance/ (4 skills) core-web-vitals-monitor, rendering-strategist, bundle-optimizer, caching-strategist
│ │ └── living-docs/ (4 skills) code-commenter, component-documenter, adr-logger, readme-writer
│ ├── qa/ # Qualidade e testes
│ │ ├── CLAUDE.md
│ │ └── subagents/
│ │ ├── shift-left/ (4 skills) story-quality-reviewer, testability-advisor, risk-identifier, three-amigos-facilitator
│ │ ├── exploratory/ (4 skills) charter-designer, session-based-tester, heuristic-tester, edge-case-finder
│ │ ├── automation/ (4 skills) api-test-writer, e2e-script-writer, test-data-builder, performance-tester
│ │ └── quality-intelligence/ (4 skills) bug-reporter, postmortem-writer, blameless-retrospective, quality-metrics
│ └── operations/ # CI/CD, infra e A/B
│ ├── CLAUDE.md
│ └── subagents/
│ ├── flow/ (7 skills) pipeline-builder, deployment-strategist, feature-flags-manager, dora-metrics-tracker, toil-reducer, docs-generator, installation-guide-writer
│ ├── infrastructure/ (4 skills) iac-writer, capacity-planner, environment-manager, finops-optimizer
│ ├── reliability/ (4 skills) monitoring-setup, slo-sla-designer, incident-commander, blameless-postmortem-writer
│ ├── devsecops/ (4 skills) vulnerability-scanner, compliance-as-code, secrets-manager, security-pipeline-integrator
│ ├── dashboard/ (3 skills) sre-metrics-designer, product-metrics-designer, dashboard-builder
│ └── change-manager/ (3 skills) gmud-writer, risk-assessor, change-approver
├── phases/
│ ├── 01-strategic-context/ PHASE.md + README.md
│ ├── 02-product-discovery/ PHASE.md + README.md
│ ├── 03-product-delivery/ PHASE.md + README.md
│ └── 04-product-operation/ PHASE.md + README.md
└── shared/
├── identity/ Template de design_spec.md
├── memory/ context.json (estado da sessão)
└── schemas/ Contratos de comunicação e input
Outputs Gerados no Repositório Destino
{REPO_DESTINO}/
├── product_briefing_spec.md [INPUT]
├── tech_spec.md [INPUT]
├── design_spec.md [INPUT]
│
├── 01-strategic-context/ OKRs, OST, visão, princípios
│ ├── phase-01-output.json
│ └── hitl-1.json
│
├── 02-product-discovery/ Oportunidades, backlog, protótipos
│ ├── prototype/
│ │ ├── low-fi.html Wireframe navegável
│ │ └── high-fi.html Protótipo completo com identidade
│ ├── epics/
│ ├── features/
│ ├── stories/
│ └── hitl-2..6.json
│
├── 03-product-delivery/ Arquitetura, ADRs, código, testes
│ └── hitl-7..10.json
│
├── 04-product-operation/ SLOs, A/B, DORA, CI/CD, GMUD
│ ├── ops-output.json
│ ├── dashboard-output.json
│ └── hitl-11..12.json
│
└── docs/ Site de documentação navegável
├── index.html
├── fase-01..04.html
├── assets/
├── gmud/
├── dashboard/
└── INSTALACAO.md
Referências Bibliográficas dos Agentes
- Teresa Torres — Opportunity Solution Tree, Continuous Discovery
- Marty Cagan — 4 Riscos de Produto, Empowered Teams
- Bernard Marr — OKRs e KPIs
- SAFe 6.0 — Hierarquia Épico > Feature > História
- IDEO — Design Thinking
- Don Norman — Usabilidade
- Eric Evans — Domain-Driven Design
- Martin Fowler — Evolutionary Architecture
- Sam Newman — Building APIs
- Kent Beck — TDD / BDD
- Gene Kim — DevOps Handbook
- Google — SRE Book
- Nicole Forsgren — Accelerate / DORA
- Anthropic — Claude API, Messages API, Tool Use, MCP
- OWASP — LLM Top 10 (prompt injection, data leakage)
- Lewis et al. — Retrieval-Augmented Generation (RAG)
- Yao et al. — ReAct (Reasoning + Acting agents)
- OpenAI / Anthropic — Best Practices for System Prompts
Changelog v3.3
Atualização de 25 de março de 2026 — novo agente AI Engineer com 4 subagentes e 16 skills para soluções de IA integradas ao produto.
| Item | v3.2 | v3.3 | O que mudou |
|---|---|---|---|
| Agentes | 9 | 10 | +AI Engineer (Fase 03, paralelo com Front End) |
| Grupos de subagentes | 34 | 38 | +chatbot-builder, +agent-builder, +rag-pipeline, +ai-guardrails |
| Skills | 122 | 138 | +16 skills de IA (4 por subagente) |
| HITL Gates | #1–#12 | #1–#12 + #8.5 | +HITL #8.5 pós-AI Engineer (guardrails e integração de IA) |
| Fase 03 | 4 etapas sequenciais | 5 etapas (AI Eng ∥ Front) | AI Engineer e Front End executam em paralelo após Back End |
| QA | Testes funcionais | +Cenários adversariais IA | QA agora inclui testes de prompt injection, vazamento e escopo |
AI Engineer — Detalhes
Projeta, implementa e protege soluções de IA integradas ao produto usando a Anthropic Claude API como backend principal.
Princípios de Segurança Obrigatórios:
- Input Sanitization — sanitizar toda entrada antes de enviar ao LLM
- System Prompt Protection — system prompts nunca expostos ao usuário final
- Output Validation — validar respostas do LLM antes de retornar
- Scope Enforcement — rejeitar perguntas fora do domínio
- PII Detection — bloquear vazamento de dados pessoais
- Rate Limiting — limitar requisições por usuário/IP
- Logging & Audit — registrar interações para auditoria (sem PII)
- Fallback Graceful — respostas seguras quando o LLM falha
Integração com outros agentes:
- Software Architect → contratos de API para endpoints de IA e ADRs
- Backend Developer → rotas HTTP que o AI Engineer consome/expõe
- Frontend Developer → componentes de chat/conversação com a API de IA
- QA → cenários adversariais de IA além dos testes funcionais
- Operations → custos de API, latência de LLM e SLOs específicos de IA
Changelog v3.2 (17/mar/2026)
| Item | v1.1 | v3.2 | O que mudou |
|---|---|---|---|
| Agentes | 8 | 9 | Orchestrator incluído como agente oficial |
| Grupos de subagentes | 30+ | 34 | Contagem exata de todos os grupos |
| Skills | 70+ | 122 | Inventário completo de todas as skills |
| PO / Story | 3 skills | 4 skills | +functional-documentation-writer |
| Architect / Domain Design | 4 skills | 6 skills | +class-model-designer, +class-diagram-generator |
| Frontend / Implementation | 4 skills | 5 skills | +mobile-identity |
| Árvore de pastas | Contagens de skills | Contagens + nomes | Cada grupo agora lista os nomes de todas as skills |