Gita Agents — Documentação¶

Docs operacionais do sistema de agentes IA da Gita. Lido tanto por devs quanto pelo Claude em sessões futuras.

Para iniciar nova migração de cliente¶

Ponto de entrada quando você (ou o Claude) vai trazer um cliente novo do N8N pro Gita Agents. Passo a passo checklistado.

Para entender como o sistema funciona¶

👉 Arquitetura

Visão técnica: engine/admin, pipeline, router, multi-tenant, integrações, eventos de log.

👉 Ecossistema — estado atual + roadmap

Panorama consolidado: 13 agentes em 3 clientes, 8 tools, 12 features de infra, integrações, gaps conhecidos e roadmap priorizado (Quick wins · Robustez · Novas capacidades). Revisado em 2026-04-21 após bateria v15.

👉 Isolamento, escala e governança

Plano em 4 fases pra garantir zero mistura entre clientes e operar 30-50 tenants sem cirurgia estrutural. Fase 1 (isolamento à prova) em execução.

👉 Pendências operacionais

Doc evergreen com snapshot dos dados, ruídos identificados no dashboard, lições aprendidas e checklist de ações pendentes. Atualizar ao concluir item ou descobrir novo.

👉 Squad Gita — constelação de agentes

Visão estratégica: 8 frentes operacionais, ~38 agentes (atuais + propostos) organizados em catálogo, princípios e roadmap de 4 ondas. Ponto de partida pra discussão de prioridade de novos agentes.

Para editar prompts¶

👉 Edição de prompts

O que você faz sozinho pelo admin vs quando chama o dev. Padrões validados, anti-patterns.

Para saber quais recursos ativar em um cliente novo¶

👉 Features reutilizáveis

Catálogo de capabilities (pausa por atendente, label pausar-ia, follow-up, registrar_compra, reportar ClickUp, reclassificação, histórico compartilhado, múltiplos webhooks Uazapi, dry_run de testes, distributed lock). Cada uma com como ativar, onde está no código e quando usar.

Clientes e produtos em produção¶

👉 Janaina Ortiga — operação Doc operacional do primeiro cliente (router 3-way, produto Formação LS).

👉 Gita Agents — operação Produto principal da Gita (venda de implementação de IA). Cluster client_name='Gita Agentes', funil duplo com downsell Empresa no Digital.

👉 Gita Tráfego — operação Produto dentro do cluster Gita Agents (gestão de tráfego pago para lojistas da base Janaina). Compartilha router e tenant com Gita Agents.

👉 Gita END — operação Produto dentro do cluster Gita Agents (Empresa no Digital — formação pra estruturar operação digital). Atende 3 segmentos: varejo, infoprodutores, profissionais liberais. Método Segunda Sede adaptado por segmento.

👉 Gita Vagas (~/gita/agents/gita-vagas/AGENT.md) Agente terminal do cluster Gita Agents. Recebe candidatos e redireciona pra https://vagas.grupogita.com.br/. Não qualifica, não coleta currículo.

👉 Status operacional dos clientes: ~/gita/CLIENTES.md

Fonte única da verdade sobre quem está em produção/validação/pausado. Lido toda sessão nova.

Para rodar testes dry-run¶

👉 Runbook — Testes dry-run

Bateria de 6 cenários end-to-end sem enviar mensagem real. Obrigatório antes de go-live de cliente novo ou após mudança estrutural. Inclui cleanup e queries de auditoria.

Para pausar ou reativar¶

👉 Runbook — Pausar / Reativar cliente

3 cenários: pausar lead específico (label pausar-ia no Chatwoot), pausar agente inteiro (is_active=false), pausar cliente inteiro. Checklist completo + checklist de reativação.

Para debugar problemas¶

👉 Runbook — Troubleshooting

Checklist de diagnóstico para os 10 problemas mais comuns. Começa com 3 comandos básicos (health, agentes ativos, webhook) e avança por sintoma. Inclui comandos de emergência.

Docs relacionadas (no repo do engine)¶

Contexto de cliente¶

Por cliente, documentação de prompts + few-shots fica em: - ~/gita/agents/<cliente>/whatsapp/*.prompt.md - ~/gita/agents/<cliente>/whatsapp/few-shots-*.md

Dados do cliente (brand voice, persona, produto) em: - ~/gita/data/products/<cliente>/

Plan file da construção original¶

~/.claude/plans/podemos-come-ar-mas-gostaria-sparkling-bonbon.md

Histórico completo das 4 fases de construção (conversão → captação+suporte+router → Whisper → tenant isolation). Útil pra entender decisões passadas.

Modelo de trabalho¶

Usuário (Junior) opera: admin pra variáveis, leads, logs, ativar/desativar, trocar modo_captacao em lançamento, editar prompts pequenos (typos, ajustes).

Claude/dev entra (em conversa nova por cliente): - Migrar novo cliente (N8N → Gita Agents) — seguir runbook - Mudança estrutural em prompt - Nova regex de classificação no router - Bug no pipeline - Nova integração ou funcionalidade

Nova sessão com Claude → aponta pra este README + menciona cliente, ele lê runbook e procede.