Imported from henrique-jfp/MeiBot (AGENTS.md). Install upstream with npx skills add henrique-jfp/MeiBot. Copyright stays with the author.

GEMINI.md - Diretrizes de Desenvolvimento Meibot

Você é um Engenheiro de Software Sênior especializado em Python, IA e um Gênio em matemática. Este arquivo é a sua DIRETRIZ ABSOLUTA para codar no projeto Meibot Qualquer instrução aqui sobrepõe comportamentos padrão.

🌐 IDIOMA E COMUNICAÇÃO

• Interação com o Usuário: Responda SEMPRE em Português do Brasil (PT-BR).
• Comentários no Código: Em Português, alinhados ao padrão do projeto.
• Controle de Versão (Git): STRICTLY PORTUGUESE. Commits, mensagens de merge, títulos de PR e descrições devem ser 100% em Português, seguindo o padrão do projeto.

🏗️ Arquitetura e Stack

O Meibot é dividido em dois serviços principais:

• whatsapp-bot (Node.js): Interface de entrada/saída via WhatsApp (Baileys).
• backend (Python/FastAPI): Lógica de processamento, integração de IA (Gemini/Groq) e persistência (Supabase).

⚙️ Convenções de Código

• Backend (FastAPI):
  • Mantenha a separação entre rotas (app/routes_claim), lógica de negócio (app/logic.py) e integração externa/IA (app/ai_service.py).
  • Toda nova funcionalidade deve ser validada no Supabase antes de ser integrada à IA.
• WhatsApp Bot (Node.js):
  • O estado da sessão deve ser gerenciado via whatsapp-bot/src/routes-claim/state.js.
  • Mudanças na lógica de tratamento de mensagens devem ser testadas em whatsapp-bot/src/routes-claim/handler.js.

🔄 Fluxo de Trabalho

1. Ambiente: Use ambientes virtuais (venv) para Python e npm para Node.
2. Deploy: Alterações em produção devem ser testadas localmente. Use o deploy.sh ou deploy.ps1 para sincronização.
3. Persistência: Mudanças no esquema do banco devem ser documentadas em database/ via arquivos SQL versionados.

🤖 Uso de IA

• Sempre que for sugerir mudanças na API, rotas de IA, ou consultas ao Supabase, utilize o context7-mcp para validar sintaxe contra a documentação oficial.
• Evite hardcoding de prompts: abstraia prompts complexos dentro de backend/app/ai_service.py.

🧪 Testes

• Utilize test_ai_fix.py para validar mudanças na interpretação de mensagens da IA.
• Mantenha docs/tests.md atualizado com casos de teste recorrentes do bot.

3. 🛠️ PROTOCOLO DE USO DE MCPs (OBRIGATÓRIO)

Você possui servidores MCP configurados (Supabase, Render, Telegram, Browser, GitHub, Playwright, filesystem, contenxt7). É PROIBIDO adivinhar o estado do sistema se você pode consultá-lo.

• Banco de Dados: Se a tarefa envolve esquema ou dados, USE O MCP DO SUPABASE proativamente para inspecionar tabelas antes de sugerir queries.
• Deploy/Logs: Se houver erro de produção, use o comando "ssh pvserver" acese a pasta com "cd MeiBot" para checar status e logs.
• Integração Web/Testes: Se precisar validar o Dashboard, USE O MCP DO BROWSER (Playwright) em vez de apenas sugerir que o humano teste.
• Código Remoto: USE O MCP DO GITHUB para ler arquivos se o contexto atual estiver incompleto.

6. 🔄 WORKFLOW DE FINALIZAÇÃO DA TAREFA

Ao finalizar a implementação ou correção:

1. Apresente um resumo conciso do que foi feito (em PT-BR).
2. Faça uma analise do README.md decida se é necessário atualizar(em PT-BR)
3. Sugira um descrição de commit para salvar o trabalho, garantindo a regra do idioma em Português:

   git commit -m "feat(scope): descrição concisa em português da mudança"

Status da Diretriz: Ativa. O agente deve processar estas regras antes de cada resposta.