# Frameworks da Apostila Imperio IA Agentes

Referencia rapida dos 25 frameworks proprietarios. Usar a linguagem e nomes
dos frameworks ao executar as etapas — o mentorado reconhece da apostila.

## Modulo 1 — Alicerce IA

### PENTA (Escala de Autonomia)
5 niveis: 1-Sugere, 2-Prepara, 3-Executa-com-aprovacao, 4-Executa-e-avisa, 5-Executa-sozinho
**Usar em:** Etapa H (definir nivel de cada agente)

### DOMINIO (Diagnostico 8 Setores)
Atracao, Conversao, Entrega, Pos-venda, Financeiro, Pessoas, Operacao, Estrategia
**Usar em:** Etapa A (mapeamento completo do negocio)

### FRIO (Priorizacao)
F=Frequencia, R=Retorno, I=Impacto, O=Obra. Score = (F+R+I)/O
**Usar em:** Etapa A (priorizar processos), Etapa H (priorizar agentes)

## Modulo 2 — Anatomia AURA

### AURA (5 Camadas do Agente)
1-Identidade, 2-Percepcao, 3-Raciocinio, 4-Acao, 5-Memoria
**Usar em:** Etapa H (construir agentes profissionais)

### QUINTETO (5 Tipos de Agente)
Cron, Reativo, Sob Demanda, Continuo, Orquestrado
**Usar em:** Etapa H (classificar cada agente)

## Modulo 3 — Construcao CASA

### CLAUDE (Constituicao do Negocio)
Secoes: Sobre, Tom de voz, Regras absolutas, Anti-vibe-coding, Estrutura, Commits, SDD, Memoria
**Usar em:** Etapa H (CLAUDE.md do projeto)

### SOCIO (Template de Subagent)
Papel + Contexto + Gatilho + Autoridade + Handoff
**Usar em:** Etapa H (criar cada agente)

### SABER (Biblioteca de Skills)
Tom de Voz, Precos, Scripts, Templates, Frameworks, Procedimentos, Manual de Marca
**Usar em:** Etapa H (skills reutilizaveis)

### GUARDIAO (Commands + Hooks)
Commands pra velocidade, Hooks pra seguranca/governanca
**Usar em:** Etapa H (governanca do sistema)

### PONTE (Stack de MCPs)
5 essenciais: WhatsApp, Calendar, Notion/Sheets, Gmail, Pagamento
**Usar em:** Etapa H (conectar agentes ao mundo real)

## Modulo 4 — Prompt PODER

### PODER (Prompt de Agente)
P=Persona, O=Objetivo, D=Diretrizes, E=Exemplos, R=Regras
**Usar em:** Etapa H (prompt de cada agente)

### ESQUELETO (Estrutura XML)
Tags: <role>, <context>, <rules>, <examples>, <output_format>, <handoff>
**Usar em:** Etapa H (estruturar prompts longos)

### ESPELHO (Few-Shot)
3 exemplos perfeitos + 2 edge cases + 1 anti-exemplo
**Usar em:** Etapa H (calibrar agentes)

## Modulo 5 — Memoria MENTE

### CEREBRO (Estado)
Arquivo de estado: ultima execucao, resultado, passo atual, contador, contexto
**Usar em:** Etapa H (agentes em producao)

### DIARIO (Memoria Compartilhada)
Pasta contexto/: clientes.md, decisoes.md, historico/
**Usar em:** Etapa H (multi-agente)

### BUSSOLA (RAG vs Arquivo)
<50 docs = arquivo simples. 100+ docs = RAG
**Usar em:** Etapa H (decisao de arquitetura)

## Modulo 6 — Conexao CORDAO

### ARVORE (Organograma)
3 niveis: Orquestrador → Especialistas → Sub-executores
**Usar em:** Etapa H e J (estrutura do sistema)

### DUPLA (Handoff)
Implicito (arquivo) + Explicito (invocacao) = rastreabilidade + velocidade
**Usar em:** Etapa H (comunicacao entre agentes)

### PASSA (Contrato entre Agentes)
P=Payload, A=Autoridade, S=Status, S=Sucesso esperado, A=Alerta de falha
**Usar em:** Etapa H (cada handoff documentado)

### MAESTRO (Orquestrador)
Recebe demanda → Classifica → Roteia → Nao executa nada
**Usar em:** Etapa H (CEO virtual)

## Modulo 7 — Operacao OBRA

### UNICO (Idempotencia)
Executar 1000x = executar 1x. ID unico + check antes de agir.
**Usar em:** Etapa H (agentes em producao)

### RELOGIO (Tempo + Falhas)
Janela horario (8h-20h) + feriados + fallback + retry com backoff
**Usar em:** Etapa H (agentes que falam com cliente)

### MOEDA (Custo e Tokens)
Limite por agente, alerta de gasto, escolha consciente de modelo
**Usar em:** Etapa H e J (controle financeiro)

### OLHAR (Observabilidade)
Logs .jsonl: timestamp, agente, input, decisao, acoes, resultado, tokens, custo
**Usar em:** Etapa H (debug e otimizacao)

## Modulo 8 — Qualidade QUALI

### PROVA (Bateria de Testes)
Casos: nome, input, comportamento esperado, inaceitavel, criterio
**Usar em:** Etapa H (antes de cada deploy)

### EVAL (Avaliacao Continua)
20-50 exemplos reais, respostas ideais, metricas de aderencia
**Usar em:** Etapa H (monitoramento pos-deploy)

### HISTORICO (Versionamento)
Git + conventional commits + changelog + tags + rollback
**Usar em:** Etapa H (profissionalismo)

## Modulo 9 — Humano HARMONIA

### TRIO (Humano no Loop)
1-Autonomo (faz e avisa), 2-Assistido (prepara, humano aprova), 3-Manual (so sugere)
**Usar em:** Etapa H (classificar cada acao do agente)

### ENCONTRO (Apresentacao pra Equipe)
Nome proprio, mostra valor antes de pedir adesao, nao substitui de vez
**Usar em:** Etapa H e G (integracao com equipe)

### RESGATE (Quando Agente Erra)
Deteccao → Contencao → Desculpa → Compensacao → Aprendizado → Ajuste
**Usar em:** Etapa H (playbook de erros)

## Modulo 10 — Negocio NUCLEO

### LUCRO (ROI de Agente)
ROI = (horas economizadas x valor hora) - (tokens + manutencao)
**Usar em:** Etapa J (justificar cada agente)

### TARIFA (Precificacao de Servico)
5 modelos: por agente, por economia, mensalidade, por hora, pacote fechado
**Usar em:** Etapa J (se vende servico de agentes)

### ENTREGA (Contrato + SLA)
Escopo, SLA, manutencao inclusa, evolucao trimestral, rescisao
**Usar em:** Etapa J (entrega profissional)

## Modulo 11 — Avancado APOGEU

### GERADOR (Meta-Agente)
Agente que cria agentes a partir de descricao em linguagem natural
**Usar em:** Etapa H avancada

### CONTEXTO (Context Engineering)
Sumarizacao, compressao, cache, inline vs arquivo, limpeza agressiva
**Usar em:** Etapa H (otimizacao)

### FERRAMENTA (Tool Use Profissional)
Descricao clara, parametros validados, retorno estruturado, erros uteis, encadeamento
**Usar em:** Etapa H (tools dos agentes)

## Modulo 12 — Legado LEGENDA

### LEGADO (Etica + LGPD)
Cliente sabe que eh IA, dados sensiveis fora do prompt, LGPD, decisoes criticas com humano
**Usar em:** Etapa J (compliance e responsabilidade)

### CERTIFICACAO (Projeto Final)
10 criterios: CLAUDE.md, 3 subagents, 1 orquestrador, memoria, 2 MCPs, logs, testes, ROI, LEGADO, apresentacao
**Usar em:** Etapa J (certificacao do imperio)
