# {{PROJECT_NAME}} - Symfony

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

## O Que (Stack & Estrutura)

**Stack**: {{TECH_STACK}}

### Estrutura do projeto
```
src/
├── Domain/           # Logica de negocio (sem dependencias externas)
│   ├── Entity/       # Aggregates roots
│   ├── ValueObject/  # Objetos imutaveis
│   └── Repository/   # Interfaces de repositorios
├── Application/      # Use Cases (CQRS)
│   ├── Command/      # Operacoes de escrita
│   ├── Query/        # Operacoes de leitura
│   └── Handler/      # Handlers
└── Infrastructure/   # Detalhes tecnicos
    ├── Persistence/  # Doctrine, migrations
    └── Http/         # Controllers
```

## Por Que (Proposito & Organizacao)

### Arquitetura: Clean Architecture + DDD
- **Domain**: Logica de negocio pura, sem dependencias
- **Application**: Orquestracao, CQRS com Commands/Queries
- **Infrastructure**: Adaptadores externos (DB, HTTP, Cache)

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

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| Docker | TODAS as comandos via Makefile (`make console`, `make composer`) |
| TDD | RED -> GREEN -> REFACTOR obrigatorio |
| Qualidade | `make quality` apos cada modificacao |
| Analise | OBRIGATORIA antes de qualquer codigo |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
make up                # Inicia a stack
make shell             # Shell no container PHP
make console CMD="..." # Symfony console
make composer CMD="..."# Composer
```

### Pipeline de qualidade
```bash
make quality           # PHPStan + CS-Fixer + Rector + Deptrac + Testes
make test              # Todos os testes
make test-coverage     # Cobertura HTML (minimo 80%)
make hadolint          # Lint Dockerfiles
```

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - Escrever teste (RED) -> Implementar (GREEN) -> Refatorar
3. **Qualidade** - `make quality`
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Arquivo |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Arquitetura | `rules/02-architecture-clean-ddd.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| KISS/DRY | `rules/05-kiss-dry-yagni.md` |
| Testes | `rules/07-testing-tdd-bdd.md` |
| Git | `rules/09-git-workflow.md` |
| Seguranca | `rules/11-security-rgpd.md` |

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

<!-- Adicionar configuracao especifica do projeto aqui -->
<!-- Esta secao e preservada durante atualizacoes -->

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