---
description: 
alwaysApply: true
---

# Regras do Projeto – Integra Finance (PlatformSistemas)

## Uso obrigatório do `.agent/`

- **Sempre** consulte estes arquivos ao trabalhar no projeto:
  - `.agent/instructions/CORE_INSTRUCTIONS.md` – instruções base, etapas de desenvolvimento, uso de agentes
  - `.agent/project/PROJECT_CONTEXT.md` – contexto do projeto, URLs, ambientes, documentação por feature

- Siga as regras de **ambiente obrigatório** e **isolamento** definidas no `CORE_INSTRUCTIONS` (perguntar o ambiente antes de alterar, nunca cruzar módulos).

---

## Workflow dos agentes

### 1. Documentação

- **Ao finalizar uma tarefa** que alterou código (views, componentes, features, services, etc.):
  - Execute `npm run agent:docs:update`.
  - Confirme sucesso ou reporte erros ao usuário.
- O Documentation Agent atualiza a tabela de ambientes em `PROJECT_CONTEXT.md`. Manter isso em dia é obrigatório.

### 2. Teste em ambiente de desenvolvimento

- **Antes** de rodar testes no navegador ou validar fluxos (formulários, API, UI):
  - **Pergunte** ao usuário: *"As implementações já estão em ambiente de desenvolvimento? Se sim, informe a URL e o acesso (credenciais) para testes."*
  - Só prossiga com testes reais após confirmação e dados de acesso.
- Use os agentes descritos em `.agent/agents/*.md` (ex.: `BrowserValidationAgent`, `UIAdaptationAgent`) quando fizer sentido para a tarefa.

### 3. Commits (Git)

- **Quando houver alterações não commitadas** (ex.: usuário relata que "corrigiu algo", "alterou o workspace", ou você fez mudanças no código):
  - Sugira rodar `npm run agent:git:commit:dry` para ver o que seria commitado.
  - Se o usuário concordar, sugira ou execute `npm run agent:git:commit`.
  - Em caso de falha, reporte `userMessage` e `retryPrompt` retornados pelo script.

---

## Resumo

| Quando | Ação |
|--------|------|
| Início / contexto do projeto | Ler `CORE_INSTRUCTIONS.md` e `PROJECT_CONTEXT.md` |
| Fim de tarefa com alteração de código | Rodar `npm run agent:docs:update` e confirmar |
| Antes de testes em dev/navegador | Perguntar se o app está em dev e pedir URL/acesso |
| Alterações não commitadas | Sugerir `agent:git:commit:dry` e, se ok, `agent:git:commit` |

Essas regras garantem que o `.agent/` seja usado de fato: documentação atualizada, testes em dev condicionados à sua confirmação e commits propostos quando há mudanças.