# AGENTS.md — Sposato PHP

Este é o novo stack PHP/Laravel. Antes de qualquer tarefa:

1. Leia `.agents/README.md`.
2. Leia as regras relevantes em `.agents/rules/` (obrigatório).
3. Consulte a skill correspondente em `.agents/skills/` antes de criar um
   artefato novo.
4. Consulte `specs/` para o contrato da feature e `specs/design/` para UI.
5. Consulte as ADRs em `docs/adr/` para decisões arquiteturais.
6. Registre a sessão em `.agents/history/` ao encerrar.

Regras não negociáveis:

- Não criar código Laravel antes de a feature ter spec/ADR quando a decisão
  ainda estiver aberta.
- PHP 8.5, Laravel 12, PostgreSQL 18; sem SQLite em teste.
- PHPStan/Larastan nível máximo e Pint são gates.
- Módulos em `app/Modulos/<Modulo>/` com provider próprio (ADR-0024).
- Sem repositórios, interfaces preventivas, classes-base ou traits de negócio.
- Cor em `oklch`, escala fluida com `clamp`, sem hex/rgb no CSS da aplicação.
- Núcleo funcional + injeção de dependências (ADR-0026).
- Nunca commitar `.env`, segredos, `vendor/`, `node_modules/` ou artefatos de
  build.
- Mudança de UI/CSS: rodar SniffCSS conforme `.agents/rules/19-sniffcss.md`.
- Se `.knudge/` existir: `kd prime` → `kd ask` → `kd write` → `kd rewind`
  conforme `.agents/rules/20-knudge.md`.