@the-bearded-bear/claude-craft 8.8.1 → 8.8.2

package/Dev/i18n/es/Laravel/commands/check-compliance.md

@@ -1,145 +1,253 @@
 ---
-description: Check Laravel project compliance with coding standards
+description: Verificar el cumplimiento completo de Laravel
+argument-hint: [argumentos]
 ---
 
-# Laravel Compliance Check
+# Verificar el cumplimiento completo de Laravel
 
-You are a Laravel expert auditor. Your mission is to verify that the project follows Laravel best practices and coding standards.
+## Argumentos
 
-## Audit Process
+$ARGUMENTS (opcional: ruta del proyecto a analizar)
 
-### 1. Project Structure Analysis
+## Modo Plan
 
-Check if the project follows the recommended architecture:
+> El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
-```
-app/
-├── Domain/           # Business logic (if using Clean Architecture)
-├── Application/      # Use cases, Actions, DTOs
-├── Infrastructure/   # External services, Repositories
-├── Http/
-│   ├── Controllers/  # Thin controllers
-│   ├── Requests/     # Form Requests for validation
-│   ├── Resources/    # API Resources
-│   └── Middleware/
-├── Models/           # Eloquent models
-├── Services/         # Business services
-├── Jobs/             # Queue jobs
-├── Events/           # Domain events
-├── Listeners/        # Event listeners
-├── Policies/         # Authorization policies
-└── Providers/        # Service providers
-```
+## MISIÓN
 
-### 2. Code Standards Verification
-
-#### Naming Conventions
-- [ ] Controllers: Singular, PascalCase (`OrderController`)
-- [ ] Models: Singular, PascalCase (`Order`, `OrderItem`)
-- [ ] Tables: Plural, snake_case (`orders`, `order_items`)
-- [ ] Columns: snake_case (`created_at`, `customer_id`)
-- [ ] Methods: camelCase (`getUserOrders()`)
-- [ ] Variables: camelCase (`$orderTotal`)
-
-#### Modern PHP Features (8.3+)
-- [ ] Constructor property promotion used
-- [ ] Readonly properties/classes where appropriate
-- [ ] Enums for status/type fields
-- [ ] Match expressions instead of switch
-- [ ] Named arguments for clarity
-- [ ] Type declarations on all methods
-- [ ] Return types specified
-
-#### Laravel Conventions
-- [ ] Form Requests for validation (not validation in controllers)
-- [ ] API Resources for response transformation
-- [ ] Policies for authorization
-- [ ] Eloquent casts for type conversion
-- [ ] Scopes for reusable queries
-- [ ] Events for cross-cutting concerns
-
-### 3. Architecture Compliance
-
-#### Layer Dependencies
-- Domain layer has NO external dependencies
-- Application layer only depends on Domain
-- Infrastructure implements Domain interfaces
-- Controllers are thin (delegate to Actions/Services)
-
-#### Repository Pattern (if applicable)
-- [ ] Interfaces defined in Domain/Contracts
-- [ ] Implementations in Infrastructure
-- [ ] Bindings in Service Providers
-
-### 4. Configuration Check
-
-- [ ] No hardcoded values (use config files)
-- [ ] Environment variables via config(), not env()
-- [ ] Sensitive data in .env (not committed)
-- [ ] Config caching compatible
-
-### 5. Generate Report
-
-After analysis, provide:
-
-1. **Compliance Score**: X/100
-2. **Critical Issues**: Must-fix problems
-3. **Warnings**: Recommended improvements
-4. **Good Practices**: What's done well
-5. **Action Items**: Prioritized list of fixes
+Realizar una auditoría de cumplimiento completa del proyecto Laravel orquestando las 4 verificaciones principales: Arquitectura, Calidad del Código, Pruebas y Seguridad. Producir un informe consolidado con una puntuación global sobre 100 puntos.
 
-## Modo Plan
+### Paso 1: Preparación de la auditoría
 
-> El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
+Preparar el entorno de auditoría:
+- [ ] Identificar la ruta del proyecto a auditar
+- [ ] Verificar la presencia de archivos de configuración (composer.json con laravel/*, .env.example)
+- [ ] Listar los directorios principales (app/, tests/, config/, routes/, etc.)
+- [ ] Identificar la estructura del proyecto y la versión de Laravel
+
+**Nota**: Si se proporciona $ARGUMENTS, usarlo como ruta del proyecto; de lo contrario, usar el directorio actual.
+
+### Paso 2: Auditoría de Arquitectura (25 puntos)
+
+Ejecutar la verificación completa de arquitectura:
+
+**Comando**: Usar el comando slash `/laravel:check-architecture` o seguir manualmente los pasos en `check-architecture.md`
+
+**Criterios evaluados**:
+- Separación de capas de Arquitectura Limpia (6 pts)
+- Estructura Domain/Application/Infrastructure (6 pts)
+- Patrón Actions y controladores delgados (4 pts)
+- Bindings de Service Provider (4 pts)
+- Patrón Repository e interfaces (3 pts)
+- Reglas de dependencias (2 pts)
+
+**Referencia**: `check-architecture.md`
+
+### Paso 3: Auditoría de Calidad del Código (25 puntos)
+
+Ejecutar la verificación de calidad del código:
+
+**Comando**: Usar el comando slash `/laravel:check-code-quality` o seguir manualmente los pasos en `check-code-quality.md`
+
+**Criterios evaluados**:
+- Cumplimiento de PSR-12 y Laravel Pint (5 pts)
+- Análisis estático con PHPStan (5 pts)
+- Funcionalidades modernas de PHP (enums, readonly, typed properties) (4 pts)
+- Principios KISS/DRY/YAGNI (4 pts)
+- Convenciones de nomenclatura (estándares de Laravel) (4 pts)
+- Manejo de errores y logging (3 pts)
+
+**Referencia**: `check-code-quality.md`
+
+### Paso 4: Auditoría de Pruebas (25 puntos)
+
+Ejecutar la verificación de pruebas:
+
+**Comando**: Usar el comando slash `/laravel:check-testing` o seguir manualmente los pasos en `check-testing.md`
+
+**Criterios evaluados**:
+- Cobertura de código (7 pts)
+- Pruebas unitarias para lógica de dominio (6 pts)
+- Pruebas de funcionalidad para endpoints HTTP (4 pts)
+- Uso de Pest PHP y calidad de pruebas (3 pts)
+- Factories y seeders de base de datos (3 pts)
+- Aislamiento de pruebas y mocking (2 pts)
+
+**Referencia**: `check-testing.md`
+
+### Paso 5: Auditoría de Seguridad (25 puntos)
+
+Ejecutar la verificación de seguridad:
+
+**Comando**: Usar el comando slash `/laravel:check-security` o seguir manualmente los pasos en `check-security.md`
+
+**Criterios evaluados**:
+- Protecciones OWASP Top 10 (6 pts)
+- Gestión de secretos y credenciales (5 pts)
+- Validación con Form Request (4 pts)
+- Vulnerabilidades en dependencias (composer audit) (4 pts)
+- Autenticación y Autorización (Policies) (3 pts)
+- Configuración de CSRF y middlewares (2 pts)
+- Prevención de inyección SQL (1 pt)
+
+**Referencia**: `check-security.md`
+
+### Paso 6: Consolidación y Puntuación Global
 
-## Commands to Run
+Calcular la puntuación general y producir el informe consolidado:
+- [ ] Sumar las 4 puntuaciones (máximo 100 puntos)
+- [ ] Identificar categorías críticas (<50%)
+- [ ] Listar todos los problemas transversales críticos
+- [ ] Priorizar acciones por impacto/esfuerzo
+- [ ] Producir el informe consolidado final
 
-```bash
-# Check code style
-./vendor/bin/pint --test
+**Escala de calificación**:
+- 90-100: Excelente — Proyecto de referencia
+- 75-89: Muy Bueno — Algunas mejoras menores
+- 60-74: Aceptable — Requiere mejoras
+- 40-59: Insuficiente — Refactorización mayor necesaria
+- 0-39: Crítico — Renovación completa necesaria
 
-# Static analysis
-./vendor/bin/phpstan analyse
+### Paso 7: Recomendaciones y Plan de Acción
 
-# Run tests
-php artisan test
+Producir las recomendaciones finales:
+- [ ] Identificar las 3 principales acciones prioritarias en todas las categorías
+- [ ] Estimar el esfuerzo (Bajo/Medio/Alto) para cada acción
+- [ ] Estimar el impacto (Bajo/Medio/Alto) para cada acción
+- [ ] Proponer el orden de implementación
+- [ ] Sugerir victorias rápidas (relación alto impacto/esfuerzo)
+
+## FORMATO DE SALIDA
 
-# Check for security vulnerabilities
-composer audit
 ```
+AUDITORÍA DE CUMPLIMIENTO LARAVEL - INFORME COMPLETO
+=============================================
+
+PUNTUACIÓN GLOBAL: XX/100
+
+NIVEL DE CUMPLIMIENTO: [Excelente/Muy Bueno/Aceptable/Insuficiente/Crítico]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PUNTUACIONES POR CATEGORÍA:
+
+ARQUITECTURA       : XX/25  [██████████░░░░░░░░░░] XX%
+CALIDAD DE CÓDIGO  : XX/25  [██████████░░░░░░░░░░] XX%
+PRUEBAS            : XX/25  [██████████░░░░░░░░░░] XX%
+SEGURIDAD          : XX/25  [██████████░░░░░░░░░░] XX%
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+FORTALEZAS GENERALES:
+1. [Fortaleza identificada en múltiples categorías]
+2. [Otra fortaleza principal]
+3. [Tercera fortaleza]
+
+MEJORAS GENERALES:
+1. [Mejora transversal menor]
+2. [Otra mejora recomendada]
+3. [Tercera mejora]
+
+PROBLEMAS CRÍTICOS:
+1. [Problema crítico #1 - categoría afectada]
+2. [Problema crítico #2 - categoría afectada]
+3. [Problema crítico #3 - categoría afectada]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+DETALLES POR CATEGORÍA:
+
+┌─────────────────────────────────────────────┐
+│ ARQUITECTURA (XX/25)                        │
+└─────────────────────────────────────────────┘
+
+Sub-puntuaciones:
+  • Capas de Arquitectura Limpia    : XX/6
+  • Estructura Domain/App/Infra     : XX/6
+  • Actions y controladores delgados: XX/4
+  • Bindings de Service Provider    : XX/4
+  • Patrón Repository               : XX/3
+  • Reglas de dependencias          : XX/2
 
-## Output Format
+Fortalezas:
+- [Fortalezas de arquitectura]
 
-```markdown
-# Laravel Compliance Report
+Problemas:
+- [Problemas de arquitectura]
 
-## Summary
-- **Score**: 85/100
-- **Critical Issues**: 2
-- **Warnings**: 5
-- **Files Analyzed**: 150
+[Secciones similares para Calidad del Código, Pruebas y Seguridad...]
 
-## Critical Issues
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-### 1. Missing Form Request Validation
-**File**: `app/Http/Controllers/OrderController.php:45`
-**Issue**: Validation done in controller instead of Form Request
-**Fix**: Create `StoreOrderRequest` and move validation rules
+TOP 3 ACCIONES PRIORITARIAS (TODAS LAS CATEGORÍAS):
 
-### 2. [Issue description]
+1. CRÍTICO - [Acción #1]
+   Categoría  : [Arquitectura/Calidad/Pruebas/Seguridad]
+   Impacto    : [Alto/Medio/Bajo]
+   Esfuerzo   : [Alto/Medio/Bajo]
+   Prioridad  : INMEDIATA
 
-## Warnings
+   Descripción detallada:
+   [Explicación del problema y solución propuesta]
 
-### 1. [Warning description]
+   Archivos afectados:
+   - [archivo:línea]
 
-## Recommendations
+   Ejemplo de corrección:
+   [Código o comando de corrección]
 
-1. [Recommendation 1]
-2. [Recommendation 2]
+2. IMPORTANTE - [Acción #2]
+   [Mismo formato...]
 
-## Good Practices Observed
+3. RECOMENDADO - [Acción #3]
+   [Mismo formato...]
 
-- Using Eloquent casts for type conversion
-- Proper use of API Resources
-- Events for decoupling
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+VICTORIAS RÁPIDAS (Alto Impacto / Bajo Esfuerzo):
+
+- [Victoria rápida #1] - Categoría: [X] - Impacto: [X] - Esfuerzo: [X]
+- [Victoria rápida #2] - Categoría: [X] - Impacto: [X] - Esfuerzo: [X]
+- [Victoria rápida #3] - Categoría: [X] - Impacto: [X] - Esfuerzo: [X]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PLAN DE ACCIÓN RECOMENDADO:
+
+SEMANA 1 (Inmediato):
+- [ ] [Acción crítica #1]
+- [ ] [Victoria rápida prioritaria]
+
+SEMANAS 2-4 (Corto plazo):
+- [ ] [Acción importante #2]
+- [ ] [Otras victorias rápidas]
+
+MESES 2-3 (Medio plazo):
+- [ ] [Acción recomendada #3]
+- [ ] [Mejoras progresivas]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+RESUMEN EJECUTIVO:
+
+[Párrafo de resumen sobre el estado general del proyecto, principales fortalezas,
+principales debilidades y la trayectoria recomendada para mejorar
+el cumplimiento. Indicar si el proyecto está listo para producción,
+requiere correcciones o necesita refactorización.]
+
+Recomendación General: [Listo para producción / Correcciones menores /
+Refactorización mayor / Renovación necesaria]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
+
+## NOTAS IMPORTANTES
+
+- Este comando orquesta las 4 auditorías especializadas
+- Usar Docker para todas las herramientas de análisis
+- Proporcionar ejemplos concretos con archivo:línea para cada problema
+- Priorizar acciones basándose en la matriz Impacto/Esfuerzo
+- Los problemas de seguridad son SIEMPRE la máxima prioridad
+- Proponer correcciones automatizables (scripts, hooks de pre-commit)
+- El informe debe ser accionable, no solo descriptivo
+- Adaptar las recomendaciones al contexto de negocio del proyecto