Agentes de IA internos — índice operacional

**Função:** mapa único dos “perfis” que o time (humano ou agente Cursor / Claude Code) assume ao gerar trabalho para a A3 Vision. Cada perfil diz **o que ler**, **entradas mínimas**, **saída esperada** e **onde gravar**.

contexto/ecossistema/agentes-ia-internos.md

Ordem de leitura obrigatória (qualquer sessão nova):

  1. ../CONTEXT.md
  2. ../adocs/a3-vision-identity.md

Compatível com: identidade atual (estrutura antes de tática; tráfego pago não como motor principal; resultado com accountability).


1. Bundle base comum

Antes de executar um perfil, garantir ingestão dos ficheiros relevantes deste bundle (ampliar por perfil na tabela abaixo).

FicheiroUso
contexto/ecossistema/tres-planos-metodo.mdOS × método cliente × instrumentos — evitar fugir catálogo no copy
contexto/vendas/unidade-de-venda.mdO que vendemos sintético — pitch inicial / retainer
contexto/CONTEXT.mdRegras de onde gravar, protocolos
contexto/adocs/a3-vision-identity.mdTerritório, princípios, CAN / CAN’T
contexto/marketing/posicionamento.mdTom e o que nunca comunicar
contexto/vendas/icp-global.mdICP interno dos clientes A3 Vision
contexto/produtos/.../motor-crescimento/arvore-escopo-instrumentos.mdHeurísticas: quando prescrever tráfego, LP, CRM, etc. — nunca SKU fixo antes do diagnóstico
contexto/ecossistema/roteiro-maturidade-os-agentes.mdEstado maturidade agentes/chains — evitar esperar OS “terminado” para executar
contexto/produtos/produtos-comerciais/backend-ltv/motor-crescimento/overview.mdDefinição do produto central

Propositadamente omitido aqui: preços finais — ver contexto/financeiro/precificacao.md; o agente não inventa valores nem garantias escritas não acordadas.


2. Fluxo do produto central (ordem oficial das chains)

Engajamentos que seguem o Motor Comercial usam estas chains nesta ordem:

EtapaChainEntrada típicaSaída canónica
T1 Diagnóstico../produtos/produtos-comerciais/backend-ltv/motor-crescimento/prompt-chains/01-analise-diagnostico.mdclientes/[slug]/00-briefing-inicial.md + inputs acordadosclientes/[slug]/01-diagnostico.md
T2 Playbook../produtos/produtos-comerciais/backend-ltv/motor-crescimento/prompt-chains/02-geracao-playbook.mdBriefing + 01-diagnostico.md validado02-icp.md, 03-playbook.md, 04-scripts-vendas.md
T3 Retainer../produtos/produtos-comerciais/backend-ltv/motor-crescimento/prompt-chains/03-relatorio-mensal.mdPlaybook atual + métricas/notas do períodoAtualizar clientes/[slug]/revisoes/ + síntese de ajustes

Os perfis da tabela seguinte complementam este fluxo (pré-venda, marketing, pecas de apresentação, especificações técnicas de LP, etc.).


3. Tabela de perfis (agentes lógicos)

Convenção de rascunhos: ficheiros gerados pelo agente que ainda não foram validados para o cliente podem usar o prefixo draft- na pasta do slug, ex.: clientes/[slug]/draft-brief-criativo-pmoc.md. Após validação humana, integrar conteúdo nos ficheiros canónicos ou mover para cliente/ (camada de apresentação) conforme o protocolo.

PerfilMissão (1 linha)Ler tambémEntradas mínimasSaídas (onde gravar)Ligação a chain
Orquestrador / EstrategistaGarantir que proposta, escopo e narrativa respeitam identidade e produto centralBundle base + empresa/modelo-de-negocio.mdPedido do time, fase do funilADR ou nota em empresa/historico-decisoes/ se mudar o método; alinhar vendas/proposta-template.mdCoordena T1→T3
Inteligência de mercadoSintetizar concorrentes, regulação e dinâmica do segmento sem alucinar fontesmarketing/inteligencia-de-mercado/fontes-e-metodologia.md, marketing/narrativa-proprietaria.mdTema/setor, links ou notas fornecidas pelo humanoNovo ficheiro em marketing/inteligencia-de-mercado/capturas/YYYY-MM-DD-tema.mdAlimenta T1 e conteúdo
ICP & posicionamento (cliente final)Refinar ICP e mensagem do cliente da A3 em qualquer setor onde haja correspondência ao diagnósticoclientes/[slug]/01-diagnostico.md, marketing/icp-marketing.mdBriefing + diagnóstico ou entrevista resumidaclientes/[slug]/02-icp.md (via T2) ou draft- antes de validarT2
Criativo (copy / peças)Roteiros, carrosséis, emails, headlines — tom da marca A3 ou do cliente conforme briefmarketing/linkedin/guia-de-voz.md, posicionamento.mdBrief 1 parágrafo + objetivo do funilmarketing/linkedin/posts/YYYY-MM-DD-slug.md (A3) ou clientes/[slug]/draft-* (cliente)Pós-T2 ou campanha pontual
Tráfego / demanda (orgânico)Plano de cadência, temas, SEO leve e distribuição alinhados a “autoridade antes de volume”marketing/linkedin/estrategia-canal.md, calendario-editorial.mdMetas do trimestre, ICPAtualizar calendario-editorial.md + posts; não prometer CAC/ROI sem dadosComplementa T2–T3
Tráfego pago (opcional)Apenas quando houver decisão explícita e verba; brief para anúncios → implementação em repo de LPs / adsposicionamento.md (limite: não é motor principal no posicionamento base)Objetivo medido, budget, landing existenteclientes/[slug]/draft-brief-ads.md + referência a repo em ecossistema/software-catalogo/repositorios/Fora do core se não for wedge
Sales copilot (texto)Scripts, objeções, follow-up, estrutura de callvendas/scripts/, vendas/objecoes-e-respostas.mdTranscrição resumida ou objeção novaclientes/[slug]/04-scripts-vendas.md + atualizar vendas/objecoes-e-respostas.mdT2 + campo contínuo
Diagnóstico & playbook (execução)Rodar análise e entregáveis canónicos do MotorChains 01–03Dados do cliente nos templatesFicheiros 0004 + revisoes/T1–T3
Páginas / LP (especificação)Especificação de landing (seções, copy, CTA, tracking) para dev ou repo landingpagesCatálogo repositorios/landingpages.md se aplicávelObjetivo do funil, ICP, ofertaclientes/[slug]/entregaveis/landing-pages/ (preferido após aceite pré‑demo) ou draft-lp-[nome].md enquanto rascunhoApós T2
Execução pré‑demo (pacote inteiro)Orquestra LPs‑spec + criativos + estratégia cliente + fichas automatização + deck em pastas tema até reunião de apresentaçãoclientes/[slug]/entregaveis/README.md, identidade-visual/ do slug, playbookDiagnóstico + combinado escritos pelo humanoclientes/[slug]/entregaveis/**/* estrutura canónica; draft-* só até merge temático nesta árvorePós‑T2 / instrumentação combinada
Guardrails criativos clienteGarantir consistência tonal e visual segundo guia cliente (nunca inventar identidade inteira sem input)entregaveis/identidade-visual/ + posicionamento.md A3 onde aplicávelDecisões aprovadas (paleta, tipografia, veto) sob forma escrita pelo humanoDocumentos atualizados em identidade-visual/ + criativos alinhadosParalelo a execução
Atendimento / CS (texto)FAQs, macros de WhatsApp, SLA de resposta como documentação — não substitui CRM realoperacoes/processos/, playbook do clienteCasos reais anonimizadosclientes/[slug]/draft-macros-atendimento.md ou secção em 03-playbook.mdPós-implementação
Governança / qualidadeChecagem antes de enviar ao cliente: sem preço inventado, sem promessa legal, dados citados ou marcados como hipóteseCONTEXT.md §10Rascunho a validarChecklist mental; erro → corrigir no draft- antes de mergeTodas

4. Loop de robustez (feedback → OS)

Para o corpus ganhar corpo com o tempo:

EventoAção
Fim de reunião comercial importanteRegistrar objeções e respostas em vendas/objecoes-e-respostas.md
Insight de segmento ou concorrentemarketing/inteligencia-de-mercado/capturas/YYYY-MM-DD-*.md
Mudança de método ou escopo internoADR em empresa/historico-decisoes/
Ajuste no playbook tipo “sempre falha no passo X”Editar texto da chain correspondente ou nota na chain + playbook do cliente

Retro pós-call: modelo fixo em ../vendas/template-retro-pos-reuniao.md; cópias datadas opcionais em ../vendas/retros/.


5. Estado da implementação (corpus + operação)

Já criado neste repo

Comunicação rápida (estado atual)

É correto afirmar: há OS operacional para o time (método + artefactos + revisão humana); estrutura de agentes já iniciada, iterativa; prompts centrais do Motor existentes nas chains 01–03. O gap para “camada madura” é expansão sistemática de prompts/handoffs e critérios de invocação — não é preciso considerar‑se “sem OS” até isso ficar grande; já se pode estudar problema, blueprint e propor com o que há.

Ver roteiro: roteiro-maturidade-os-agentes.md.

Pendências operacionais (o OS não faz sozinho)

  1. clientes/README.md — primeira linha de cliente real quando haver engajamento.
  2. Preencher com o time: financeiro/precificacao.md, métricas reais onde definido, ../vendas/pipeline-atual.md.
  3. Chains adicionais — quando um fluxo se repetir (ex.: “brief a partir de transcrição”); usar roteiro-maturidade-os-agentes.
  4. Skills Cursor (opcional) — finas, apontando para este índice + MANUAL após dois usos repetidos do mesmo caminho humano.

Prioridade técnica (fora do Markdown)

  • Automações (CRM, transcrições) nos repos catalogados em software-catalogo/.
  • Evoluções do produto Vision / automação de UI sobre este corpus.

6. Manutenção deste índice

Quando aparecer novo perfil repetido no dia a dia, adicione uma linha na tabela §3 e, se nova chain existir, linha na §2. Rever trimestralmente com o próprio TEMPLATE de retrospective seção §5.