# 🤖 Instruções para Agentes Gemini

Este arquivo contém diretrizes críticas para qualquer agente de IA que interaja com este repositório.

## 🚀 Workflow de Deploy (OBRIGATÓRIO)

**NUNCA faça commit direto na branch `producao` sem antes validar a configuração.** 

O repositório conta com um script de automação híbrido (`producao/scripts/deploy_pathfinder.py`) que deve ser usado para **todo e qualquer deploy**.

### Passo a Passo para Agentes:

1.  **Faça suas alterações** nos arquivos de configuração (`nginx/`).
2.  **Valide e Deploye** rodando o script abaixo no terminal do Windows:
    ```powershell
    python producao/scripts/deploy_pathfinder.py sync --all
    ```
3.  **Verifique a Saída**:
    - O script fará o upload, testará a configuração (`nginx -t`) no servidor e fará o reload.
    - Se houver erro, **corrija antes de prosseguir**. O script fará rollback automático no servidor, mas seu código local estará "quebrado".
4.  **Commit**: Somente após o sucesso do comando acima ("Deploy Remoto Concluído com Sucesso!"), faça o commit das alterações.

## 🛠️ Comandos Úteis

- **Sincronizar Tudo (Nginx + Fail2Ban + GeoIP)**: 
  `python producao/scripts/deploy_pathfinder.py sync --all`
- **Deploy de Novo Site**:
  `python producao/scripts/deploy_pathfinder.py site --deploy dominio.com`
- **Atualizar GeoIP Manualmente**:
  `python producao/scripts/deploy_pathfinder.py geoip --update`

## ⚠️ Pontos de Atenção

- **GeoIP**: O script baixa automaticamente os bancos GeoIP se faltarem. Não precisa baixar manualmente.
- **Paramiko**: O script usa `paramiko` para SSH. Se não estiver instalado, instale com `pip install paramiko`.
- **Credenciais**: As credenciais de acesso ao servidor estão embutidas no cabeçalho do script. Não as exponha em logs públicos.