# {{PROJECT_NAME}} - PHP Clean Architecture

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

## O Que (Stack & Estrutura)

**Stack**: {{TECH_STACK}}
**Framework**: {{PHP_FRAMEWORK}} + PHP {{PHP_VERSION}}
**Arquitetura**: Clean Architecture com CQRS

### Estrutura do projeto
```
src/
├── Domain/           # Logica de negocio (SEM deps externas)
│   ├── Entity/       # Entidades de negocio
│   ├── ValueObject/  # Tipos imutaveis
│   └── Repository/   # Interfaces (contratos)
├── Application/      # Use cases & orquestracao
│   └── UseCase/
│       ├── Command/  # Operacoes de escrita
│       └── Query/    # Operacoes de leitura
├── Infrastructure/   # Concerns externos
│   └── Persistence/  # Doctrine/Eloquent
└── Presentation/     # Controllers, API
```

## Por Que (Proposito & Organizacao)

### Arquitetura: Clean Architecture + CQRS
- **Domain**: Logica de negocio pura, sem dependencias
- **Application**: Orquestracao via Commands/Queries
- **Infrastructure**: Implementacoes externas
- Dependencias fluem para dentro (DIP)

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

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| strict_types | `declare(strict_types=1)` em todos arquivos |
| Analise | OBRIGATORIA antes de qualquer codigo |
| PHPStan | Level 9, zero erros |
| Testes | 80% cobertura, Domain 90%+ |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
composer install                     # Instalar
{{CACHE_CLEAR_COMMAND}}              # Limpar cache
{{MIGRATION_RUN_COMMAND}}            # Executar migrations
```

### Pipeline de qualidade
```bash
vendor/bin/phpstan analyse           # Analise estatica
vendor/bin/php-cs-fixer fix          # Corrigir estilo
vendor/bin/phpunit --coverage-html coverage/ # Cobertura
composer quality                     # Verificacao completa
```

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - Teste primeiro, depois codigo
3. **Qualidade** - `composer quality`
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 -->
