# {{PROJECT_NAME}} - Laravel

> Gerado: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## O Que (Stack & Estrutura)

**Stack**: Laravel {{LARAVEL_VERSION}} + PHP {{PHP_VERSION}}
**Arquitetura**: {{ARCHITECTURE_PATTERN}}
**Database**: {{DATABASE_TYPE}}

### Estrutura do projeto
```
app/
├── Domain/           # Logica de negocio central
│   ├── Models/       # Eloquent models
│   └── Services/     # Domain services
├── Application/      # Use cases, Actions, DTOs
├── Infrastructure/   # Servicos externos, Repositories
└── Http/             # Controllers, Requests, Resources
```

## Por Que (Proposito & Organizacao)

### Arquitetura: {{ARCHITECTURE_PATTERN}}
- **Controllers**: Finos, delegam para Actions
- **Validacao**: Sempre via Form Requests
- **Respostas**: Sempre via API Resources
- **Autorizacao**: Via Policies

Ver `rules/02-architecture.md` para padroes.

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| strict_types | Habilitado em todos arquivos |
| PHPStan | Level 8, zero erros |
| Pint | PSR-12 + Laravel style |
| Testes | 80% cobertura minima |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
php artisan serve         # Servidor de desenvolvimento
php artisan queue:work    # Worker de filas
php artisan migrate       # Executar migrations
php artisan migrate:fresh --seed # Reset com seeds
```

### Pipeline de qualidade
```bash
./vendor/bin/pint         # Formatar codigo
./vendor/bin/phpstan analyse # Analise estatica
php artisan test --coverage # Testes com cobertura
```

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - Pest PHP, testes primeiro
3. **Qualidade** - Pint + PHPStan + Testes
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Arquivo |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Arquitetura | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testes | `rules/07-testing.md` |
| Seguranca | `rules/11-security.md` |

<!-- PROJECT-SPECIFIC-START -->
## Especificidades do projeto

<!-- Adicionar configuracao especifica do projeto aqui -->

<!-- PROJECT-SPECIFIC-END -->
