docs(agents): adicionar guia para agentes
- Adiciona AGENTS.md com orientações para agentes e automações - Inclui padrão de mensagens de commit e instruções de operação - Documenta contexto do projeto e fluxo de desenvolvimentomaster
parent
ba3d386575
commit
085e2f2cee
|
|
@ -0,0 +1,38 @@
|
|||
# Guia para agentes
|
||||
|
||||
Orientações rápidas para agentes ou automações que atuam neste repositório.
|
||||
|
||||
## Contexto do projeto
|
||||
- Servers Manager: catálogo interno de servidores e usuários.
|
||||
- Backend: Spring Boot 4 (Java 21), JWT stateless com refresh em cookie HttpOnly.
|
||||
- Frontend: React 19 + Vite (TS), Tailwind, axios com `withCredentials`.
|
||||
- Desenvolvimento local: `./gradlew bootRun` em `backend/` e `yarn dev` em `frontend/` (copie `.env.example` antes).
|
||||
|
||||
## Padrão para mensagens de commit
|
||||
**Instrução:** Gere um comando `git commit -m` completo, em português, seguindo o padrão **Conventional Commits**, com base no `diff` abaixo.
|
||||
**Regras:**
|
||||
1. Identifique automaticamente o tipo de commit (`feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `style`, `perf`, etc.).
|
||||
2. Estruture a mensagem em duas partes:
|
||||
- **Título:** `tipo(escopo): descrição breve` (modo imperativo, até 72 caracteres)
|
||||
- **Corpo:** lista em markdown com `-` destacando as principais alterações.
|
||||
3. Retorne **apenas o comando completo** no formato:
|
||||
```
|
||||
git commit -m "tipo(escopo): descrição breve
|
||||
- detalhe 1
|
||||
- detalhe 2
|
||||
- detalhe 3"
|
||||
```
|
||||
4. O escopo deve ser inferido a partir do contexto dos arquivos alterados.
|
||||
5. **Não escreva nada além do comando final.**
|
||||
6. **Entrada:**
|
||||
```diff
|
||||
[cole aqui o diff]
|
||||
```
|
||||
|
||||
**Exemplo adaptado ao projeto:**
|
||||
```
|
||||
git commit -m "feat(servers): habilitar filtros de busca
|
||||
- Adiciona filtros de status e localidade ao endpoint GET /api/servers
|
||||
- Ajusta DTOs e mappers para incluir status normalizado e apelido
|
||||
- Atualiza listagem React para aplicar filtros e exibir feedback com toast"
|
||||
```
|
||||
Loading…
Reference in New Issue