# {{PROJECT_NAME}} - PHP Clean Architecture

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

## Que (Stack y Estructura)

**Stack**: {{TECH_STACK}}
**Framework**: {{PHP_FRAMEWORK}} + PHP {{PHP_VERSION}}

### Estructura del proyecto
```
src/
├── Domain/           # Logica de negocio (sin dependencias externas)
│   ├── Entity/       # Entidades con comportamiento
│   ├── ValueObject/  # Tipos de valor inmutables
│   ├── Event/        # Domain events
│   └── Repository/   # Interfaces de repositorios
├── Application/      # Casos de uso (CQRS)
│   └── UseCase/
│       └── [Feature]/
│           ├── Command/  # Operaciones de escritura
│           └── Query/    # Operaciones de lectura
├── Infrastructure/   # Concerns externos
│   ├── Persistence/  # Database (Doctrine, Eloquent)
│   └── Service/      # Implementaciones servicios
└── Presentation/     # Capa UI (Controllers, API)
```

## Por que (Proposito y Organizacion)

### Arquitectura: Clean Architecture + CQRS
- **Domain**: Logica de negocio sin dependencias externas
- **Application**: Casos de uso separados en Commands/Queries
- **Infrastructure**: Implementaciones tecnicas

Ver `rules/02-architecture.md` para patrones detallados.

### Reglas criticas

| Regla | Descripcion |
|-------|-------------|
| Analisis primero | OBLIGATORIO antes de cualquier codigo |
| `declare(strict_types=1)` | En todos los archivos |
| PHPStan nivel 9 | 0 errores |
| Cobertura | Minimo 80%, Domain 90%+ |

## Como (Comandos y Flujos de trabajo)

### Comandos de desarrollo
```bash
composer install              # Instalacion
{{CACHE_CLEAR_COMMAND}}       # Limpiar cache
{{MIGRATION_RUN_COMMAND}}     # Ejecutar migraciones
```

### Pipeline de calidad
```bash
vendor/bin/phpstan analyse           # Analisis estatico
vendor/bin/php-cs-fixer fix --dry-run# Verificar estilo
vendor/bin/phpunit                   # Tests
composer quality                     # Todas las verificaciones
```

### Flujo de desarrollo
1. **Analizar** - `rules/01-workflow-analysis.md`
2. **TDD** - Escribir test ANTES de implementar
3. **Calidad** - `composer quality` despues de cada cambio
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Archivo |
|----------|---------|
| Antes de modificar | `rules/01-workflow-analysis.md` |
| Arquitectura | `rules/02-architecture.md` |
| Estandares codigo | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Tests | `rules/07-testing.md` |
| Seguridad | `rules/11-security.md` |

<!-- PROJECT-SPECIFIC-START -->
## Especificidades del proyecto

<!-- Agregar configuracion especifica del proyecto aqui -->

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