ECP AI Multi-Agent Squad — Documentação
v3.3 10 Agentes • 38 Subagentes • 138 Skills • 4 Fases • 12 HITLs ← Ecossistema

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).

Multiagentes de IA 10 Agentes 12 HITL Gates 4 Fases 38 Subagentes 138 Skills Claude Code
10
Agentes
38
Subagentes
138
Skills
4
Fases
12
HITL Gates
3
Inputs Obrigatórios

Squad Multiagentes de IA — O Conceito

Filosofia
Squad Multiagentes de IA com Human in the Loop

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

Delegação, não substituição

O orquestrador coordena e delega. Cada agente executa sua especialidade. O humano decide.

Rastreabilidade total

Todo output é registrado em JSON. Toda decisão humana é documentada. Todo feedback é transportado.

Skills atômicas e idempotentes

Cada skill executa uma tarefa única e pode ser re-executada sem efeitos colaterais.

Como Funciona

3 Specs
briefing + tech + design
Pre-Flight Check
validate-inputs.mjs
Orquestrador
coordena fases
Fase 01
Estratégia
HITL #1
Fase 02
Discovery
HITL #2-6
Fase 03
Delivery
HITL #7-10
Fase 04
Operação
HITL #11-12
Produto completo + docs/ + dashboard

Fluxo do Orquestrador

Passo 0
Pre-Flight Check
Validação programática (validate-inputs.mjs) + validação comportamental dos 3 specs. Se falhar, para e informa.
Passo 1
Ler context.json
Identificar fase e agente atual, carregar outputs anteriores.
Passo 2
Acionar Agente
Preparar input com contexto completo + path do repositório destino. Chamar agente via Task.
Passo 3
Salvar Output
Gravar output do agente em {REPO_DESTINO}/{fase}/.
Passo 4
Apresentar HITL
Apresentar output ao humano no checkpoint. Aguardar decisão.
Passo 5
Avançar ou Retornar
Se aprovado, avançar para próximo agente. Se rejeitado, transportar feedback e retornar ao agente.

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.

Input 1
product_briefing_spec.md

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
Fases 01 e 02
Input 2
tech_spec.md

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
Fases 03 e 04
Input 3
design_spec.md

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
Fases 02 e 03
Input 4
Repositório Destino

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

Camada 1 — Programática
validate-inputs.mjs

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}
Camada 2 — Comportamental
Validação pelo Orquestrador

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

Fase 01
Contexto Estratégico
Definir o Objetivo, os Key Results e as Oportunidades Macro (Dores, Necessidades e Desejos) que compõem o topo da Opportunity Solution Tree (OST) de Teresa Torres.
HITL #1 Product Manager

O que esta fase produz

O que NÃO deve aparecer

HITL #1 — Perguntas ao Humano

  1. O Objetivo é inspirador e orienta decisões de produto?
  2. Os KRs são mensuráveis e alcançáveis no prazo definido?
  3. As Oportunidades Macro estão ligadas aos KRs corretos?
  4. São oportunidades reais (dores/necessidades/desejos) ou soluções disfarçadas?
  5. O escopo está adequado para um ciclo de discovery?

Input: product_briefing_spec.md  •  Output: {REPO}/01-strategic-context/

Fase 02 — Product Discovery

Fase 02
Product Discovery
Priorizar oportunidades, gerar hipóteses de solução, validar com protótipos navegáveis, estruturar o backlog em SAFe e avaliar os 4 riscos de Cagan antes de comprometer engenharia.
HITL #2 HITL #3 HITL #4 HITL #5 HITL #6 PO + Designer

Sequência de 6 Etapas

EtapaAgenteAçãoHITL
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

Valor para o Cliente

Os usuários querem isso?

PM
Valor para o Negócio

Move os KRs?

PM
Usabilidade

Os usuários conseguem usar?

Designer
Viabilidade Técnica

Conseguimos construir?

Architect

Inputs: product_briefing_spec.md + design_spec.md  •  Output: {REPO}/02-product-discovery/

Fase 03 — Product Delivery

Fase 03
Product Delivery
Arquitetar, construir e testar a solução definida no Discovery, garantindo que a implementação reflete fielmente o que foi aprovado nos protótipos e no backlog.
HITL #7 HITL #8 HITL #9 HITL #10 Architect + Back + AI Engineer + Front + QA

Sequência de 5 Etapas

EtapaAgenteAçãoHITL
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

Fase 04
Operação de Produto
Operar a aplicação com CI/CD, GMUD, deploy, observabilidade, SLOs, DORA metrics, dashboard operacional, A/B testing e retroalimentação do ciclo com aprendizados reais.
HITL #11 HITL #12 Operations + PM

Sequência

EtapaAgenteAçãoHITL
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

ResultadoAçã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

Agente Central
Orquestrador do Squad

O orquestrador nunca executa tarefas diretamente. Sua função é coordenar, delegar, gerenciar HITLs e garantir o fluxo entre as 4 fases.

Responsabilidades

  1. Receber a demanda e identificar em qual fase o trabalho está
  2. Acionar o agente correto com contexto completo
  3. Apresentar outputs ao humano nos checkpoints HITL
  4. Transportar feedback humano para o agente correto
  5. Gerenciar retroalimentação quando A/B indica necessidade
  6. Manter /shared/memory/context.json atualizado

Regras do Orquestrador

Proibido
  • Executar uma skill diretamente
  • Avançar sem aprovação HITL
  • Assumir — sempre transportar contexto completo
  • Iniciar sem os 4 inputs validados
Obrigatório
  • 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}
agents/orchestrator/CLAUDE.md

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.

🎯
Orchestrator
Coordenação, HITL gates, transporte de contexto e gerenciamento de fases
Todas as Fases
Sem subagentes — coordena os 9 agentes operacionais
🧑‍💼
Product Manager
Estratégia, OKRs, OST, métricas e A/B
Fase 01 + Fase 04
Market Research
Product Vision
Product Strategy
Metrics
🎨
Product Designer
Research, ideação, low-fi e high-fi
Fase 02
Customer Research
UX
UI
📋
Product Owner
Priorização, épicos, features e histórias
Fase 02
Epic
Feature
Story
🏛
Software Architect
DDD, contratos, ADRs e repo scaffolding
Fase 03
Domain Design
System Design
Evaluation
Enablement
🔧
Back End Developer
API, services, persistência e testes
Fase 03
API
Persistence
Quality
Living Docs
🤖
AI Engineer
Chatbots, agentes autônomos, RAG e guardrails de IA
Fase 03 (paralelo com Front End)
Chatbot Builder
Agent Builder
RAG Pipeline
AI Guardrails
💻
Front End Developer
Componentes, páginas, integração e performance
Fase 03
Implementation
Quality
Performance
Living Docs
🧪
QA
Shift-left, exploratório, automação e métricas
Fase 03
Shift-Left
Exploratory
Automation
Quality Intelligence
Operations
CI/CD, GMUD, infra, SRE, dashboard e A/B
Fase 04
Flow
Infrastructure
Reliability
DevSecOps
Dashboard
Change Manager

Subagentes e Skills

Cada agente possui subagentes especializados que executam skills atômicas. Abaixo o catálogo completo.

Product Manager — Subagentes e Skills

Market Research
competitor-analysis
customer-segmentation
market-sizing
trend-scanning
Product Vision
north-star-definer
opportunity-brief-writer
product-principles
vision-writer
Product Strategy
assumption-mapper
four-risks-assessor
okr-facilitator
outcome-roadmap
Metrics
ab-test-analyzer
experiment-designer
leading-lagging-indicators
report-generator

Product Designer — Subagentes e Skills

Customer Research
assumption-tester
continuous-interview-partner
ethnographic-researcher
insight-synthesizer
UX
ideation-facilitator
low-fi-prototyper
high-fi-prototyper
solution-sketcher
information-architecture
interaction-design
usability-evaluator
accessibility-checker
UI
component-spec
design-tokens
responsive-guidelines
visual-consistency-checker

Product Owner — Subagentes e Skills

Epic
opportunity-prioritizer
epic-writer
enabler-epic-writer
opportunity-brief-writer
Feature
feature-writer
enabler-feature-writer
Story
user-story-writer
acceptance-criteria-writer
story-splitter
functional-documentation-writer

Software Architect — Subagentes e Skills

Domain Design
bounded-context-mapper
context-map-writer
aggregate-designer
class-model-designer
ubiquitous-language-builder
class-diagram-generator
System Design
adr-writer
api-contract-designer
data-modeling
evolutionary-architecture
repo-scaffolder
Evaluation
build-vs-buy
risk-assessment
technical-debt-tracker
tech-radar
Enablement
architecture-pairing
dependency-audit
pattern-advisor
scalability-analysis

Back End Developer — Subagentes e Skills

API
api-builder
auth-implementer
contract-enforcer
error-handler
Persistence
schema-builder
migration-manager
repository-implementer
query-optimizer
Quality
unit-test-writer
integration-test-writer
api-test-writer
mock-builder
Living Docs
adr-logger
api-documenter
code-commenter
schema-documenter

AI Engineer — Subagentes e Skills

Chatbot Builder
conversation-designer
claude-api-integrator
context-manager
prompt-engineer
Agent Builder
mcp-server-builder
tool-use-designer
agent-orchestrator
autonomous-workflow
RAG Pipeline
document-processor
embedding-pipeline
retrieval-optimizer
grounded-response
AI Guardrails
prompt-injection-shield
data-leakage-preventer
scope-enforcer
safety-tester

Front End Developer — Subagentes e Skills

Implementation
component-builder
design-to-code
responsive-implementer
state-management
mobile-identity
Quality
unit-test-writer
integration-test-writer
e2e-script-writer
accessibility-implementer
Performance
bundle-optimizer
caching-strategist
core-web-vitals-monitor
rendering-strategist
Living Docs
adr-logger
code-commenter
component-documenter
readme-writer

QA — Subagentes e Skills

Shift-Left
story-quality-reviewer
testability-advisor
three-amigos-facilitator
risk-identifier
Exploratory
charter-designer
session-based-tester
heuristic-tester
edge-case-finder
Automation
api-test-writer
e2e-script-writer
performance-tester
test-data-builder
Quality Intelligence
quality-metrics
bug-reporter
postmortem-writer
blameless-retrospective

Operations — Subagentes e Skills

Flow
pipeline-builder
deployment-strategist
dora-metrics-tracker
feature-flags-manager
toil-reducer
docs-generator
installation-guide-writer
Infrastructure
iac-writer
environment-manager
capacity-planner
finops-optimizer
Reliability
slo-sla-designer
monitoring-setup
incident-commander
blameless-postmortem-writer
DevSecOps
vulnerability-scanner
secrets-manager
security-pipeline-integrator
compliance-as-code
Dashboard
product-metrics-designer
sre-metrics-designer
dashboard-builder
Change Manager
gmud-writer
risk-assessor
change-approver

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.

HITLFasePós-AgentePergunta 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

Aprovado

Avança para o próximo agente ou fase.

Aprovado com ressalvas

Avança com restrições documentadas.

Rejeitado

Retorna ao agente com feedback detalhado.

Contratos de Comunicação

Todos os agentes se comunicam via JSON padronizado. O orquestrador transporta contexto entre agentes.

Orquestrador → Agente
{
  "phase": "01-strategic-context",
  "agent": "product-manager",
  "mission": "descrição da missão",
  "context": {},
  "inputs_from_previous": {},
  "hitl_feedback": "feedback (se retorno)"
}
Agente → Orquestrador
{
  "status": "success | error | partial",
  "phase": "fase atual",
  "agent": "nome-do-agente",
  "subagents_used": [],
  "skills_used": [],
  "deliverables": {},
  "open_questions": [],
  "next_hitl": 1
}
Aprovação HITL
{
  "hitl": 1,
  "decision": "approved | rejected",
  "feedback": "comentários do humano",
  "next_agent": "próximo agente"
}
Erro Padrão
{
  "status": "error",
  "agent": "nome-do-agente",
  "error_code": "INVALID_INPUT",
  "message": "descrição",
  "retry_suggested": true
}
shared/schemas/agent-contract.md shared/schemas/input-contracts.md

Como Executar

Pré-Requisitos

Passo a Passo

Passo 1
Preparar os 3 specs no repositório destino
Criar 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.
Passo 2
Validar inputs
node validate-inputs.mjs /caminho/do/repo-destino
Se retornar exit code 1, corrigir os erros antes de prosseguir.
Passo 3
Abrir o Claude Code no diretório do squad
cd ecp-ai-multi-agent-squad
claude
Passo 4
Iniciar a Fase 01
Digitar no Claude Code:
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.
Passo 5
Avaliar cada HITL
Em cada checkpoint, o orquestrador apresenta o output do agente. Você avalia e responde:
  • aprovado — avançar para o próximo agente
  • aprovado com ressalvas — avançar com restrições
  • rejeitado + feedback — retornar ao agente com instruções
Passo 6
Ciclo completo
Após o HITL #12, o ciclo está completo. O repositório destino conterá todos os artefatos das 4 fases, o site de documentação em 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

Produto e Estratégia
  • 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
Engenharia e Operações
  • 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
IA e LLMs
  • 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.

Itemv3.2v3.3O 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

Novo Agente v3.3
AI Engineer

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
agents/ai-engineer/CLAUDE.md

Changelog v3.2 (17/mar/2026)

Itemv1.1v3.2O 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