diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..a63d48b
--- /dev/null
+++ b/AGENTS.md
@@ -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"
+```