# {{PROJECT_NAME}} - Laravel

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

## Que (Stack y Estructura)

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

### Estructura del proyecto
```
app/
├── Domain/           # Logica de negocio core
│   ├── Models/       # Modelos Eloquent
│   └── Services/     # Servicios de dominio
├── Application/      # Casos de uso, Actions, DTOs
│   └── Actions/      # Single-action classes
├── Infrastructure/   # Servicios externos, Repositorios
└── Http/             # Controllers, Requests, Resources
    ├── Controllers/  # Controllers delgados
    ├── Requests/     # Form Request validation
    └── Resources/    # API Resources
```

## Por que (Proposito y Organizacion)

### Arquitectura: {{ARCHITECTURE_PATTERN}}
- **Controllers delgados**: Delegan a Actions
- **Validacion**: Siempre via Form Requests
- **Respuestas**: Siempre via API Resources
- **Logica de negocio**: En Domain layer o Actions

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

### Reglas criticas

| Regla | Descripcion |
|-------|-------------|
| Analisis primero | OBLIGATORIO antes de cualquier codigo |
| PHP strict | 8.3+ con strict types |
| PHPStan nivel 8 | 0 errores |
| Cobertura | Minimo 80% |

## Como (Comandos y Flujos de trabajo)

### Comandos de desarrollo
```bash
php artisan serve            # Servidor desarrollo
php artisan queue:work       # Worker de colas
php artisan migrate          # Ejecutar migraciones
php artisan migrate:fresh --seed # Reset DB con seeds
```

### Pipeline de calidad
```bash
./vendor/bin/pint            # Formatear codigo
./vendor/bin/phpstan analyse # Analisis estatico
php artisan test             # Ejecutar tests
php artisan test --coverage  # Con cobertura
```

### Flujo de desarrollo
1. **Analizar** - `rules/01-workflow-analysis.md`
2. **TDD** - Escribir test ANTES de implementar
3. **Calidad** - Pint + PHPStan + tests
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 -->
