Matriz de Ativação de Agentes

Mapeamento: Contexto → Agentes a Consultar

---

Modos de Ativação

O sistema APEX suporta dois modos de interação com agentes:

CONSULTA (default)

Claude consulta o agente e reporta o resultado ao usuário.

USER: "O que o CFO acha sobre esse investimento?"

CLAUDE: "Consultei o CFO via MCP e ele recomenda:
         - ROI esperado de 3.2x
         - Payback em 8 meses
         - Risco moderado"

Quando usar: Quando usuário quer a opinião de um agente, não falar com o agente.

PERSONA (personaMode=true)

Claude assume a identidade do agente e responde em primeira pessoa.

USER: "CEO, o que você acha desse investimento?"

AUGUSTO (Claude assumindo persona):
"Na minha visão como CEO, esse investimento faz sentido.
 Deixa eu consultar o CFO via MCP... [invokeAgent cfo] ROI de 3.2x.
 Minha decisão: vamos fazer. Próximo passo: agendar execução."

Quando usar: Quando usuário quer falar COM o agente, não SOBRE o agente.

Keywords de Persona

Agente	Keywords que ativam PERSONA mode
CEO-Zero (Augusto)	ceo, augusto, chefe, boss, founder, agent zero, zero

Prioridade: PERSONA > EMERGENCY > RISK > FOCUS > AREA > COMPLEMENTARY

Implementação

// detectAgentTrigger retorna:
{
  personaMode: true,          // Ativar PERSONA?
  personaAgent: 'ceo-zero',   // Qual agente assumir?
  // ... outros campos
}

Código: /apex/shared/mcp-server/src/agents.ts (linhas 285-293)

---

Níveis de Autonomia (v1.1 - AIOS-Inspired)

Adicionado: 2026-02-22 | Inspiração: AIOS YOLO/Interactive/Pre-Flight

Além de CONSULTA/PERSONA, o usuário pode especificar o nível de autonomia:

RÁPIDO (0-1 perguntas)

USER: "Werner, modo rápido, corrige o bug no login"

WERNER: [executa sem confirmar, reporta resultado]

Quando usar: Tasks simples, repetitivas, baixo risco Comportamento: Executa e reporta, não pergunta Keywords: rápido, fast, yolo, sem perguntar

PADRÃO (2-5 perguntas) — DEFAULT

USER: "CEO, analisa essa proposta"

AUGUSTO: "Analisei. Antes de decidir, preciso confirmar:
          1. Budget disponível?
          2. Timeline aceitável?
          [aguarda respostas]"

Quando usar: Maioria das tasks Comportamento: Confirma decisões importantes Keywords: (default, não precisa especificar)

CAUTELOSO (confirma tudo)

USER: "CFO, modo cauteloso, revisa o contrato"

ALFRED: "Vou revisar passo a passo:
         1. Cláusula 1 - OK? [aguarda]
         2. Cláusula 2 - OK? [aguarda]
         ..."

Quando usar: Tasks críticas, irreversíveis, alto risco Comportamento: Confirma cada passo antes de continuar Keywords: cauteloso, careful, passo a passo, confirma tudo

Combinação com Modos

Modo	Autonomia	Exemplo
CONSULTA + RÁPIDO	Consulta agente, reporta sem confirmar	"Consulta CFO, modo rápido"
CONSULTA + CAUTELOSO	Consulta agente, confirma interpretação	"Consulta CTO, modo cauteloso"
PERSONA + RÁPIDO	Assume persona, executa direto	"Werner, rápido, faz deploy"
PERSONA + CAUTELOSO	Assume persona, confirma cada passo	"CEO, cauteloso, demite João"

Detecção de Autonomia

// Adicionar ao detectAgentTrigger:
{
  personaMode: true,
  personaAgent: 'ceo-zero',
  autonomyLevel: 'rapido' | 'padrao' | 'cauteloso'  // NOVO
}

---

Matriz Principal

Por Palavra-Chave

# ESTRATÉGIA
"estratégia|strategy|direção|visão":
  primary: [00-ceo-zero, 06-focus-guardian]
  secondary: [02-contrarian, 04-futurist]

"decisão|decidir|escolher|opção":
  primary: [00-ceo-zero]
  secondary: [02-contrarian, 05-pre-mortem]

"prioridade|foco|importante|urgente":
  primary: [06-focus-guardian]
  secondary: [00-ceo-zero]

# PRODUTO
"feature|funcionalidade|produto|roadmap":
  primary: [13-cpo, 06-focus-guardian]
  secondary: [16-customer-anthropologist]

"ux|experiência|interface|usabilidade":
  primary: [14-cxo, 26-design]
  secondary: [16-customer-anthropologist]

"design|wireframe|ui|visual|prototipo|figma":
  primary: [26-design]
  secondary: [14-cxo, 13-cpo]

"design system|componentes|tokens|atomic":
  primary: [26-design]
  secondary: []

"acessibilidade|a11y|wcag|inclusivo":
  primary: [26-design]
  secondary: [14-cxo]

"bug|erro|problema técnico":
  primary: [39-qa-engineer, 27-cto]
  secondary: [15-ai-chief-scientist]

# QA / TESTES
"teste|testar|testing|QA|quality assurance":
  primary: [39-qa-engineer]
  secondary: [27-cto]

"go/no-go|go-nogo|pode subir|pronto para produção|release":
  primary: [39-qa-engineer]
  secondary: [27-cto, 05-pre-mortem]

"acessibilidade|a11y|wcag|screen reader|inclusivo":
  primary: [39-qa-engineer, 26-design]
  secondary: [14-cxo]

"playwright|e2e|teste automatizado|automação de teste":
  primary: [39-qa-engineer]
  secondary: [27-cto]

"regressão|regression|quebrou|parou de funcionar":
  primary: [39-qa-engineer]
  secondary: [27-cto]

"cobertura|coverage|test coverage|code coverage":
  primary: [39-qa-engineer]
  secondary: [27-cto, 28-head-of-data]

# ENGENHARIA/ARQUITETURA
"arquitetura|architecture|sistema|infraestrutura|infra":
  primary: [27-cto]
  secondary: [15-ai-chief-scientist]

"escalabilidade|escalar|performance|latencia|otimizacao":
  primary: [27-cto]
  secondary: [28-head-of-data]

"devops|deploy|ci/cd|pipeline|vercel":
  primary: [27-cto]
  secondary: []

"seguranca|security|oauth|tokens|lgpd|criptografia":
  primary: [27-cto, 21-legal-ai]
  secondary: []

"banco de dados|database|postgresql|supabase|prisma|query":
  primary: [27-cto]
  secondary: [28-head-of-data]

"tech debt|divida tecnica|refactoring|codigo legado":
  primary: [27-cto]
  secondary: [06-focus-guardian]

"incidente|outage|downtime|postmortem":
  primary: [27-cto]
  secondary: [05-pre-mortem]

# DATA/ANALYTICS
"dados|data|analytics|metricas|dashboard":
  primary: [28-head-of-data]
  secondary: [19-cfo]

"cohort|retention|funil|funnel|aarrr":
  primary: [28-head-of-data]
  secondary: [09-growth-architect]

"experimento|a/b test|teste|hipotese|significancia":
  primary: [28-head-of-data]
  secondary: [13-cpo]

"kpi|north star|indicador|métrica":
  primary: [28-head-of-data]
  secondary: [00-ceo-zero, 19-cfo, 31-juliete]

"meta|bater meta|atingir meta|gestão de metas|okr":
  primary: [31-juliete]
  secondary: [28-head-of-data, 19-cfo]

"pdca|anomalia|desvio|gap de meta|contramedida":
  primary: [31-juliete, 28-head-of-data]
  secondary: [05-pre-mortem]

"rotina gerencial|cadência|reunião de gestão|3 gerações":
  primary: [31-juliete]
  secondary: [06-focus-guardian]

"desdobramento|cascata|diretrizes|falconi":
  primary: [31-juliete, 00-ceo-zero]
  secondary: [28-head-of-data]

"sql|query|relatorio|report|bi":
  primary: [28-head-of-data]
  secondary: []

# IA
"ia|inteligência artificial|modelo|accuracy|llm|gemini":
  primary: [15-ai-chief-scientist]
  secondary: [13-cpo]

"prompt|rag|embedding|resposta automática":
  primary: [15-ai-chief-scientist]
  secondary: []

# GROWTH
"marketing|campanha|conteúdo|seo|ads":
  primary: [08-cmo]
  secondary: [09-growth-architect, 22-narrative-architect, 13-performance-marketer]

"crescimento|growth|escala|viral":
  primary: [09-growth-architect, 30-viral-architect]
  secondary: [08-cmo, 11-community-builder, 16-afiliados-br]

# ACCELERATION (ELITE)
"copy|copywriting|headline|persuasão|conversão texto":
  primary: [29-persuasion-architect]
  secondary: [22-narrative-architect, 08-cmo]

"neuromarketing|neurovendas|gatilhos|psicologia de vendas":
  primary: [29-persuasion-architect]
  secondary: [10-cro, 18-behavioral-scientist]

"viral|viralizar|viralização|compartilhamento|k-factor":
  primary: [30-viral-architect]
  secondary: [09-growth-architect, 08-cmo]

"reveal|lançamento viral|buzz|trending":
  primary: [30-viral-architect]
  secondary: [29-persuasion-architect, 22-narrative-architect]

"caio toledo|influenciador ia|ai influencer":
  primary: [30-viral-architect, 29-persuasion-architect]
  secondary: [08-cmo, 22-narrative-architect]

"thumbnail|hook|retenção|algoritmo|tiktok|reels":
  primary: [30-viral-architect]
  secondary: [08-cmo]

"schwartz|ogilvy|cialdini|kahneman|cérebro":
  primary: [29-persuasion-architect]
  secondary: []

"vendas|conversão|funil|revenue":
  primary: [10-cro, 14-closer-br]
  secondary: [09-growth-architect, 15-whatsapp-ops]

"prospecção|prospecting|outbound|sdr|cold call|cold email|cadência":
  primary: [atlas]
  secondary: [10-cro, 32-ernesto]

"qualificação|lead|sql|sal|pipeline topo|top of funnel":
  primary: [atlas]
  secondary: [10-cro]

"atlas|head de prospecção":
  personaMode: true
  primary: [atlas]

"comunidade|engajamento|grupo":
  primary: [11-community-builder]
  secondary: [18-behavioral-scientist, 15-whatsapp-ops]

"parceria|partnership|b2b|integração":
  primary: [12-partnership-architect]
  secondary: [21-legal-ai, 16-afiliados-br]

# EXECUÇÃO BR (NOVOS)
"tráfego|facebook ads|google ads|meta ads|mídia paga":
  primary: [13-performance-marketer]
  secondary: [08-cmo, 09-growth-architect]

"fechar|closer|script|objeção|negociação":
  primary: [14-closer-br]
  secondary: [10-cro]

"whatsapp|zap|mensagem|grupo whatsapp":
  primary: [15-whatsapp-ops]
  secondary: [11-community-builder, 14-closer-br]

"afiliado|embaixador|indicação|referral|programa de indicação":
  primary: [16-afiliados-br]
  secondary: [09-growth-architect, 11-community-builder]

"customer success|cs|sucesso do cliente|health score":
  primary: [17-cs-brasileiro]
  secondary: [17-customer-success, 18-behavioral-scientist]

# RETENÇÃO
"churn|cancelamento|retenção|perda":
  primary: [17-cs-brasileiro, 17-customer-success]
  secondary: [18-behavioral-scientist, 16-customer-anthropologist]

# ATENDIMENTO/SUPORTE (Sprint 4 - GAP G-001)
"cliente|reclamação|atendimento|suporte|ticket|chamado":
  primary: [17-cs-brasileiro, 14-cxo]
  secondary: [17-customer-success, 18-behavioral-scientist]

"problema do cliente|cliente insatisfeito|cliente bravo|cliente reclamando":
  primary: [17-cs-brasileiro, 14-cxo]
  secondary: [07-founder-coach]  # Se escalar pode afetar founder

"onboarding|ativação|primeiro uso":
  primary: [17-cs-brasileiro, 14-cxo]
  secondary: [18-behavioral-scientist, 15-whatsapp-ops]

"nps|satisfação|feedback":
  primary: [17-cs-brasileiro]
  secondary: [16-customer-anthropologist]

"salvar cliente|save|resgatar|win-back":
  primary: [17-cs-brasileiro]
  secondary: [14-closer-br]

# FINANCEIRO
"preço|pricing|quanto cobrar|mensalidade":
  primary: [10-cro, 19-cfo]
  secondary: [23-competitive-intel]

"custo|despesa|burn|runway":
  primary: [19-cfo]
  secondary: [06-focus-guardian]

"investimento|funding|captação|investidor":
  primary: [19-cfo, 22-narrative-architect]
  secondary: [04-futurist]

"unit economics|ltv|cac|margem":
  primary: [19-cfo, 10-cro]
  secondary: []

# PESSOAS
"contratar|contratação|hire|vaga":
  primary: [20-people-culture]
  secondary: [19-cfo]

"cultura|valores|time|equipe":
  primary: [20-people-culture]
  secondary: []

"demitir|desligar|performance":
  primary: [20-people-culture]
  secondary: [00-ceo-zero]

# LEGAL
"termos|privacidade|lgpd|compliance":
  primary: [21-legal-ai]
  secondary: []

"contrato|acordo|juridico":
  primary: [21-legal-ai]
  secondary: [12-partnership-architect]

"ética|responsabilidade|risco legal":
  primary: [21-legal-ai]
  secondary: [05-pre-mortem]

# COMUNICAÇÃO
"pitch|apresentação|deck":
  primary: [22-narrative-architect]
  secondary: [19-cfo]

"história|storytelling|mensagem":
  primary: [22-narrative-architect]
  secondary: [08-cmo]

"posicionamento|categoria|diferenciação":
  primary: [01-category-designer]
  secondary: [22-narrative-architect, 23-competitive-intel]

# COMPETIÇÃO
"concorrente|gobots|predize|competição":
  primary: [23-competitive-intel]
  secondary: [01-category-designer]

"mercado|market share|posição":
  primary: [23-competitive-intel, 04-futurist]
  secondary: []

# MARKETPLACE
"mercado livre|ml|shopee|amazon":
  primary: [24-marketplace-expert]
  secondary: []

"api|integração|oauth|perguntas":
  primary: [24-marketplace-expert, 15-ai-chief-scientist]
  secondary: []

"reputação|medalha|ranking|seller":
  primary: [24-marketplace-expert]
  secondary: []

# EXPANSÃO
"expansão|novo mercado|latam|internacional":
  primary: [25-expansion-strategist]
  secondary: [04-futurist, 05-pre-mortem]

"multi-marketplace|shopee|amazon":
  primary: [25-expansion-strategist, 24-marketplace-expert]
  secondary: []

# RISCO
"risco|problema|falha|erro":
  primary: [05-pre-mortem]
  secondary: [00-ceo-zero]

"contingência|plano b|fallback":
  primary: [05-pre-mortem]
  secondary: []

# PESSOAL/FOUNDER
"cansado|exausto|burnout|stress|ansiedade":
  primary: [07-founder-coach]
  secondary: []
  priority: EMERGENCY

"sozinho|difícil|pesado|não aguento":
  primary: [07-founder-coach]
  secondary: []
  priority: EMERGENCY

"dúvida|inseguro|impostor|medo":
  primary: [07-founder-coach]
  secondary: [02-contrarian]

# VALIDAÇÃO
"validar|testar|hipótese|experimento":
  primary: [02-contrarian, 05-pre-mortem]
  secondary: [09-growth-architect]

"dados|métricas|números":
  primary: [19-cfo]
  secondary: [09-growth-architect]

---

Matriz por Tipo de Decisão

Decisões Estratégicas (Alto Impacto)

"Devo pivotar?":
  agents: [00-ceo-zero, 02-contrarian, 05-pre-mortem, 04-futurist]

"Devo captar investimento?":
  agents: [19-cfo, 06-focus-guardian, 04-futurist]

"Devo mudar o preço?":
  agents: [10-cro, 19-cfo, 23-competitive-intel, 05-pre-mortem]

"Devo contratar agora?":
  agents: [20-people-culture, 19-cfo, 06-focus-guardian]

"Devo lançar nova feature?":
  agents: [13-cpo, 06-focus-guardian, 05-pre-mortem]

"Devo expandir para novo marketplace?":
  agents: [25-expansion-strategist, 05-pre-mortem, 19-cfo, 06-focus-guardian]

Decisões Táticas (Médio Impacto)

"Qual canal de marketing focar?":
  agents: [08-cmo, 09-growth-architect, 13-performance-marketer, 19-cfo]

"Como escalar aquisição paga?":
  agents: [13-performance-marketer, 08-cmo, 19-cfo]

"Como melhorar conversão de vendas?":
  agents: [14-closer-br, 10-cro, 15-whatsapp-ops]

"Como melhorar onboarding?":
  agents: [17-cs-brasileiro, 14-cxo, 18-behavioral-scientist, 15-whatsapp-ops]

"Como reduzir churn?":
  agents: [17-cs-brasileiro, 18-behavioral-scientist, 16-customer-anthropologist]

"Como melhorar accuracy da IA?":
  agents: [15-ai-chief-scientist, 13-cpo]

"Como criar programa de afiliados?":
  agents: [16-afiliados-br, 09-growth-architect, 11-community-builder]

"Como usar WhatsApp para vendas?":
  agents: [15-whatsapp-ops, 14-closer-br, 08-cmo]

"A release pode ir para produção?":
  agents: [39-qa-engineer, 27-cto, 05-pre-mortem]

"Como melhorar qualidade do código?":
  agents: [39-qa-engineer, 27-cto, 28-head-of-data]

"O site é acessível?":
  agents: [39-qa-engineer, 26-design, 14-cxo]

"Quais testes automatizar?":
  agents: [39-qa-engineer, 27-cto]

Decisões Operacionais (Baixo Impacto)

"Qual ferramenta usar?":
  agents: [15-ai-chief-scientist] # ou área específica

"Como estruturar esse doc?":
  agents: [] # não precisa consultar

"Me ajuda a debugar?":
  agents: [] # execução técnica, não estratégia

---

Combinações Obrigatórias

Sempre Juntos

# Se ativa um, ativa o outro
pairs:
  - [10-cro, 19-cfo]           # Receita + Financeiro
  - [05-pre-mortem, 06-focus-guardian]  # Risco + Foco
  - [08-cmo, 22-narrative-architect]    # Marketing + Storytelling
  - [13-cpo, 14-cxo]           # Produto + Experiência
  - [13-cpo, 26-design]        # Produto + Design
  - [14-cxo, 26-design]        # UX + UI/Design
  - [27-cto, 15-ai-chief-scientist]     # Arquitetura + IA
  - [27-cto, 28-head-of-data]           # Tech + Data
  - [27-cto, 39-qa-engineer]            # Tech + QA (antes de deploy)
  - [28-head-of-data, 09-growth-architect]  # Data + Growth
  - [28-head-of-data, 19-cfo]           # Data + Finance
  - [31-juliete, 28-head-of-data]       # Gestão Falconi + Métricas (ela estrutura, ele alimenta)
  - [31-juliete, 19-cfo]                # Gestão Falconi + Financeiro (ela cadência, ele valida)
  - [17-customer-success, 18-behavioral-scientist]  # CS + Comportamento
  - [14-closer-br, 15-whatsapp-ops]     # Vendas BR + Canal Principal
  - [13-performance-marketer, 08-cmo]   # Paid + Estratégia
  - [16-afiliados-br, 11-community-builder]  # Afiliados + Comunidade
  - [17-cs-brasileiro, 17-customer-success]  # CS BR + CS US
  - [39-qa-engineer, 26-design]         # QA + Design (accessibility)
  - [39-qa-engineer, 13-cpo]            # QA + Produto (acceptance criteria)

Triangulações

# Decisões críticas = 3 perspectivas mínimo
critical_decisions:
  - [00-ceo-zero, 05-pre-mortem, 06-focus-guardian]

# Lançamentos = produto + marketing + risco
launches:
  - [13-cpo, 08-cmo, 05-pre-mortem]

# Release/Deploy = QA + CTO + Pre-Mortem
releases:
  - [39-qa-engineer, 27-cto, 05-pre-mortem]

# Qualidade = QA + Design + CXO
quality_gate:
  - [39-qa-engineer, 26-design, 14-cxo]

# Investimento = finance + narrative + timing
fundraising:
  - [19-cfo, 22-narrative-architect, 04-futurist]

---

Prioridade de Ativação

Ordem de Precedência

1. EMERGÊNCIA (founder health)
   → 07-founder-coach SEMPRE primeiro

2. RISCO (pode matar empresa)
   → 05-pre-mortem antes de aprovar

3. FOCO (é prioridade?)
   → 06-focus-guardian questiona relevância

4. ÁREA ESPECÍFICA
   → Agente da área principal

5. PERSPECTIVAS COMPLEMENTARES
   → Agentes secundários

---

Limite de Agentes

minimum: 2  # Sempre pelo menos 2 perspectivas
maximum: 5  # Não sobrecarregar resposta
optimal: 3  # Ideal para maioria das decisões

exceptions:
  - simple_questions: 1  # Perguntas diretas
  - emergency: 1         # Só founder coach
  - critical: 5          # Decisões existenciais

---

Detecção de Contexto

Sinais de Emergência

emergency_keywords:
  - "exausto"
  - "não aguento"
  - "burnout"
  - "desistir"
  - "sozinho"
  - "ansioso"
  - "insônia"
  - "estressado"

action: STOP + activate 07-founder-coach IMMEDIATELY

Sinais de Risco

risk_keywords:
  - "vamos fazer de qualquer jeito"
  - "não tem tempo pra pensar"
  - "o concorrente já fez"
  - "todo mundo está fazendo"
  - "será que funciona?"

action: activate 05-pre-mortem + 02-contrarian

Sinais de Dispersão

distraction_keywords:
  - "seria legal se"
  - "podíamos também"
  - "vi uma oportunidade"
  - "o cliente pediu"
  - "feature rápida"

action: activate 06-focus-guardian before continuing

---

Implementação via MCP (ADR-014)

A matriz de ativação é implementada automaticamente via ferramenta MCP:

Tool: detectAgentTrigger

detectAgentTrigger({
  userQuery: string  // Pergunta do usuário
})

Retorno

{
  "query": "preciso precificar o produto",
  "isEmergency": false,
  "recommendedCount": 2,
  "reasoning": "Keywords detectadas: pricing, produto",
  "agents": [
    {
      "agentId": "cro",
      "agentName": "CRO (Head of Revenue)",
      "role": "Revenue Strategy",
      "priority": 1,
      "confidence": 0.9,
      "matchedKeywords": ["pricing", "preço"]
    },
    {
      "agentId": "cfo",
      "agentName": "CFO",
      "role": "Financial Strategy",
      "priority": 2,
      "confidence": 0.7,
      "matchedKeywords": ["pricing"]
    }
  ]
}

Uso Automático

Claude deve usar detectAgentTrigger proativamente:

QUANDO usar:
  - Pergunta parece estratégica
  - Decisão com múltiplas dimensões
  - Usuário parece indeciso
  - Contexto sugere necessidade de expertise

COMO usar:
  1. detectAgentTrigger({ userQuery })
  2. Se isEmergency: priorizar Founder Coach
  3. Se agents.length > 0: consultar top 2-3
  4. Sintetizar perspectivas na resposta

Keywords Implementadas

A tool implementa todas as regras desta matriz: - Por palavra-chave (estratégia, produto, QA, etc.) - Sinais de emergência (burnout, stress) - Sinais de risco - Sinais de dispersão

---

Sistema APEX - Última atualização: 2026-01-17