53 lines
2.4 KiB
Plaintext
53 lines
2.4 KiB
Plaintext
---
|
||
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.
|