Manual de operação — A3 Vision OS

O que é este repo: apenas contexto em Markdown sobre a A3 Vision (não é código do produto Vision). O manual canónico dos agentes é contexto/CONTEXT.md; a identidade completa está em contexto/adocs/a3-vision-identity.md. Caminhos neste manual partem sempre da raiz a3-vision-os/ (pastas relativas como ./contexto/).

1. Mapa mental em 30 segundos

Nunca confundir: cliente/ (raiz) = pacote Next de experiência · contexto/clientes/ = dados de contas.

2. Camada visual — cliente/visao-next

Objetivo: ler contexto/ com sidebar, filtros e tema — útil para reuniões e onboarding de pessoas menos técnicas.

1. Terminal na raiz do repo (ou já dentro de cliente/visao-next/):

   cd cliente/visao-next
   npm install
   npm run dev
   

2. Abrir http://localhost:3000.

3. Este manual no leitor interno: /doc/MANUAL-OPERACAO-OS.md (ficheiro na raiz do Git). Documentos em contexto/: /doc/contexto/… — exemplo /doc/contexto/CONTEXT.md.

Boas práticas:

• Em calls com cliente, abrir apenas ficheiros validados (evitar mostrar pastas raw-inputs ou draft-* sem revisão).
• Preferir navegar pela sidebar em vez de abrir .md “soltos” no explorador — links internos resolvem melhor na app.

3. Operação interna — Cursor

Objetivo: editar Markdown, criar draft-*, correr chains com modelo no IDE.

Arranque de sessão:

1. Abrir a raiz do repositório a3-vision-os como pasta do projeto.
2. O Cursor aplica automaticamente .cursor/rules/a3-vision-os.mdc (alwaysApply); texto completo alinhado com AGENTS.md.
3. Para uma tarefa concreta, mencionar ficheiros (@CONTEXT.md, @agentes-ia-internos.md, pasta do cliente) para reforço.

Fluxos típicos:

Rascunhos: ficheiros com prefixo draft- na pasta do slug (ex.: draft-lp-manutencao.md) até revisão humana; ver também clientes/[slug]/rascunhos/.

Para o mapa expandido de perfis → contexto/ecossistema/agentes-ia-internos.md.

4. Operação interna — Claude Code

Objetivo: igual ao Cursor — trabalhar sobre Git com contexto estável.

1. Na raiz do repo existe CLAUDE.md — o Claude Code carrega este ficheiro como contexto do projeto; espelha AGENTS.md.
2. Começar sessão garantindo ingestão de contexto/CONTEXT.md e contexto/adocs/a3-vision-identity.md (o CLAUDE.md já manda ler estes paths).
3. Para mudanças em ficheiros: indicar paths exatos sob contexto/.
4. Nunca autorizar commit de dados sensíveis brutos (raw-inputs com dados pessoais fora do acordado) — mesmo critério do CONTEXT.md §10.

5. Ritmo comercial (operador humano)

6. Motor Comercial — ordem fixa

1. 00-briefing-inicial.md + inputs
2. Chain 01 → 01-diagnostico.md (revisão + validação com cliente)
3. Chain 02 → 02-icp.md, 03-playbook.md, 04-scripts-vendas.md
4. Implementação CRM / rituais (fora deste manual, nos sistemas catalogados)
5. Retainer: chain 03 + pasta revisoes/

Cronograma sugerido por marcos: contexto/produtos/produtos-comerciais/backend-ltv/motor-crescimento/metodologia-45-dias.md.

7. O que operadores não devem fazer

• Inventar preço, promessa legal ou garantia não alinhada com financeiro/precificacao.md e decisão humana.
• Versionar raw sensível sem política clara.
• Gerar campanha ou LP “final” sem passar pelo checklist de proposta / identidade quando o destino for cliente externo.

8. Ligações úteis

Dúvida “onde gravo isto?” → contexto/CONTEXT.md §6 e §8.