CONTEXT.md — A3 Vision OS

Atualizado em: 2026-05-09 · entregaveis/ no molde cliente + agentes IA (índice em ecossistema/)

Este repositório (a3-vision-os) é só contexto em Markdown: produtos, clientes, empresa, vendas, marketing, operações. Não é código de produto.

Regra zero: em toda sessão, leia este arquivo primeiro. Identidade, posicionamento e mapa de execução completos: adocs/a3-vision-identity.md. Se faltar decisão de negócio, pergunte — não invente.

Operadores humanos: MANUAL-OPERACAO-OS.md (raiz). Cursor / Claude Code: AGENTS.md, CLAUDE.md e .cursor/rules/a3-vision-os.mdc (raiz) — sempre com este CONTEXT.md como fonte principal.

1. O que é a A3 Vision (resumo)

Infraestrutura operacional de crescimento para PMEs brasileiras com tração que buscam multiplicar faturamento com método, com IA onde faz sentido. Construímos o sistema que conecta o que a empresa já tem (dados, equipe, processo informal) ao crescimento com previsibilidade — diagnóstico e implementação de infraestrutura de crescimento com IA, com acompanhamento até a operação funcionar sem depender de nós para o dia a dia.

Ao mercado (tom comercial vs peças avulsas): não comunicamos vendas sob o rótulo de “marketing só”, “tráfego só”, “gestão de mídia isolada”, “IA/automação/ferramenta” como promessa standalone; agregamos tudo sob a infraestrutura / motor vivo até o fundador recuperar protagonismo estratégico com operação menos dependente só de si. Linguagem aspiracional vs técnico: marketing/posicionamento.md.

Âncora de frame (prioridade sobre só negar rótulos): o problema não é “só falta marketing” quando não há sistema: sem sistema articulando dados, rituais e decisão, aumentar dispersão canal-a-canal só tende a amplificar ruído até o playbook existir onde importa para aquele cliente.

Três planos (onde escrever o quê para qual audiência): ecossistema/tres-planos-metodo.md. Unidade comercial sintética: vendas/unidade-de-venda.md.

2. Para quem resolvemos (sinais)

• Tem dados, mas não usa (não vira inteligência operacional).
• Tem volume, mas não cresce (teto estável).
• Tem funil engargalado (não sabe onde o processo quebra).
• Tem documentação, mas não clareza (não vira execução).
• Tem equipe, mas depende do fundador (operação trava sem ele).

Cliente-alvo principal: PMEs brasileiras com tração que querem multiplicar faturamento com previsibilidade — não só cortar custos nem reagir só em canal. Setores heterogêneos; costuma haver bom encaixe quando há motor comercial e/ou operações com pipeline diagnosticável. Não é foco: empresa começando do zero sem tração nem histórico mínimo.

3. Canais de autoridade

• LinkedIn — prioridade: autoridade, 3x/semana, conteúdo com dados de mercado (não opinião genérica); constrói referência em crescimento operacional para PMEs.
• YouTube — médio prazo: ativar quando houver casos documentados e linguagem validada; até lá, presença principal no LinkedIn.

Tráfego pago não é o motor principal; audiência proprietária sim.

4. Camadas internas (uma linha cada)

1. Core interno (software) — sistemas que sustentam a A3 Vision como empresa (gestão, automação, funis, conteúdo); não são linha de receita direta.
2. Produto central — diagnóstico + implementação da infraestrutura de crescimento com IA; receita principal e dataset proprietário.
3. Produtos complementares — entrada ou extensão de valor; só entram em execução depois de documentados neste OS.

Mapa detalhado: ecossistema/mapa-camadas.md.

5. Princípios (filtros de decisão)

1. Autopilot, não copilot — resultado com accountability, não só entrega de ferramenta.
2. Dados como ativo acumulável — nada descartar sem avaliar; cada caso melhora o próximo.
3. Narrativa antes de volume — consolidar território narrativo antes de escalar.
4. Estrutura antes de tática — sem ICP/processo, post e campanha são ruído.
5. Produto entra no OS antes do mercado — documentação aqui é pré-requisito de execução.

6. Onde cada coisa entra (árvore mínima)

7. Protocolo: novo cliente

1. Slug kebab-case (ex.: empresa-exemplo-ltda).
2. Copiar clientes/_template/ → clientes/[slug]/.
3. clientes/[slug]/raw-inputs/ com .gitkeep se precisar; não versionar dados brutos sensíveis.
4. Preencher a partir dos dados do humano: começar por 00-briefing-inicial.md.
5. Atualizar clientes/README.md (slug, status, próxima ação).
6. Rascunhos: texto gerado por IA antes de validação → prefixo draft-*.md na pasta do cliente e/ou em clientes/[slug]/rascunhos/ (cópia do _template).
7. Após chamadas relevantes (comercial / descoberta): preencher vendas/template-retro-pos-reuniao.md e atualizar vendas/pipeline-atual.md; opcional arquivo datado em vendas/retros/.
8. Fluxo: operacoes/processos/onboarding-cliente.md + prompt-chains conforme a etapa; marcos típicos em motor-crescimento/metodologia-45-dias.md.
9. Commit sugerido: docs(clientes): [slug] — [ação curta].
10. Fase de execução pré‑demo: com blueprint e combinado válidos produzidos no slug, criar/popular clientes/[slug]/entregaveis/ seguindo a árvore de _template/entregaveis/ (LP/specs em Markdown, criativos, estratégia táctica cliente, fichas de automação, estruturas de deck, guia compacto em identidade-visual/ — binários apenas segundo política de raw-inputs/ aqui mesmo no §7).
11. Clientes já existentes antes desta pasta: copiar apenas contexto/clientes/_template/entregaveis/ inteiro para o slug e só então mover conteúdo disperso já existente nos sítios canónicos (evitar duplicação indefinida com draft-* na raiz do slug quando o formato estiver aceite aqui).

8. Protocolo: novo produto ou área correlata

Nomes de arquivo em kebab-case. Sem dados sensíveis de terceiros nos commits.

9. Stack e decisões fixas (não reabrir sem alinhamento)

Repositórios: ecossistema/software-catalogo/repositorios/README.md · Por camada: ecossistema/software-catalogo/README.md.

10. O que o agente não faz

• Não inventar preço, contrato, promessa ao cliente ou decisão estratégica sem o humano.
• Não commitar raw inputs sensíveis — só .md estruturados acordados.
• Não apagar clientes/_template/ nem chains de referência salvo instrução explícita.

Reduzir alucinação em diagnóstico e escopo comercial

• Não inventar concorrentes, números de mercado nem “gargalo óbvio” que não apareça nos briefings/raw-inputs — declarar lacuna de dados onde faltar evidência (01-diagnostico.md já prevê isto).

• Não tratar lista de instrumentos (LP, ads, CRM, IA) como obrigatória antes do combinado cliente: usar heurísticas em arvore de escopo de instrumentos e diagnóstico validado — três planos de discurso em ecossistema/tres-planos-metodo.md para não misturar catálogo com método.

• Documentação do app Vision ou catálogo de repos que cite “imóveis/corretores” descreve produto/execução naquele codebase; ICP institucional e marketing ficam nos ficheiros de CONTEXT, marketing/ e vendas/icp-global.md — PME ampla sem vertical obrigatória. Preferir sempre estes antes de extrapolar só a partir de descrições técnicas de um repo.

• PRD histórico ([adocs/PRD-a3-vision-os.md](./adocs/PRD-a3-vision-os.md)): pode ter trechos mais antigos; **nunca prevalecer** sobre este CONTEXT.md, identityeposicionamento` atualizados.

11. Glossário rápido

Dúvida de onde gravar: ecossistema/ para produto e software; clientes/ para conta; vendas/ / marketing/ / financeiro/ / operacoes/ para funções da empresa; adocs/a3-vision-identity.md para identidade e mapa de execução. Como trabalhar como operador humano: MANUAL-OPERACAO-OS.md (raiz do repo).