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.

Para editar prompts¶

👉 Edição de prompts

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

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.