# Contribuindo com o ServiceGPT

## Antes de começar

Leia `AGENTS.md`, a documentação do diretório `docs` e confirme a fase atual em `docs/ROADMAP.md`. Não antecipe fases nem amplie o escopo sem solicitação explícita.

## Branches

Nunca trabalhe diretamente em `main`. Use o padrão:

```text
feature/fase-N-descricao
```

## Commits

Prefira commits pequenos e objetivos com um destes prefixos:

- `feat:` nova funcionalidade;
- `fix:` correção;
- `docs:` documentação;
- `refactor:` refatoração sem mudança funcional;
- `test:` testes;
- `chore:` manutenção e infraestrutura.

Não inclua segredos, credenciais ou arquivos gerados no commit.

## Pull Requests

- Abra Pull Requests sempre para `main`.
- Mantenha o PR como draft durante o desenvolvimento, preferencialmente.
- Não faça merge automático.
- Inclua resumo, testes executados, riscos ou limitações e os principais arquivos alterados.
- Confirme que o escopo pertence à fase atual e que os testes relevantes passaram.

## Qualidade e segurança

- Preserve a arquitetura documentada.
- Mantenha controllers enxutos e regras de negócio em Services ou classes apropriadas.
- Evite abstrações e dependências sem necessidade concreta.
- Nunca execute comandos destrutivos em bancos com dados existentes.
- Nunca registre ou versione tokens e segredos.
