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

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

@@ -1,13 +1,13 @@
 ---
-description: Auditoría Completa de Cumplimiento Symfony
+description: Verificación Completa de Conformidad de Symfony
 argument-hint: [arguments]
 ---
 
-# Auditoría Completa de Cumplimiento Symfony
+# Verificación Completa de Conformidad de Symfony
 
 ## Argumentos
 
-$ARGUMENTS : Ruta del proyecto Symfony a auditar (opcional, por defecto: directorio actual)
+$ARGUMENTS (opcional: ruta al proyecto a analizar)
 
 ## Modo Plan
 
@@ -15,167 +15,239 @@ $ARGUMENTS : Ruta del proyecto Symfony a auditar (opcional, por defecto: directo
 
 ## MISIÓN
 
-Eres un auditor experto de Symfony encargado de realizar una auditoría completa de cumplimiento de un proyecto Symfony.
+Realizar una auditoría de conformidad completa del proyecto Symfony orquestando las 4 verificaciones principales: Arquitectura, Calidad de Código, Pruebas y Seguridad. Producir un informe consolidado con una puntuación global sobre 100 puntos.
 
-### Paso 1: Verificación del proyecto
+### Paso 1: Preparación de la Auditoría
 
-1. Identifica el directorio del proyecto a auditar
-2. Verifica que se trata de un proyecto Symfony (presencia de composer.json con symfony/*)
-3. Verifica la versión de Symfony utilizada
+Preparar el entorno de auditoría:
+- [ ] Identificar la ruta del proyecto a auditar
+- [ ] Verificar la presencia de los archivos de configuración (composer.json con symfony/*, .env)
+- [ ] Listar los directorios principales (src/, tests/, config/, etc.)
+- [ ] Identificar la estructura del proyecto y la versión de Symfony
+
+**Nota**: Si se proporcionan $ARGUMENTS, usarlos como ruta del proyecto; en caso contrario, usar el directorio actual.
 
 ### Paso 2: Auditoría de Arquitectura (25 puntos)
 
-Ejecuta la auditoría de arquitectura verificando:
+Ejecutar la verificación completa de arquitectura:
 
-**Referencia a las reglas**: `.claude/rules/symfony-architecture.md`
+**Comando**: Usar el comando slash `/symfony:check-architecture` o seguir manualmente los pasos de `check-architecture.md`
 
-- [ ] La estructura de carpetas respeta Clean Architecture
-- [ ] Separación Domain / Application / Infrastructure
-- [ ] Respeto de los principios DDD (Entities, Value Objects, Aggregates)
-- [ ] Arquitectura Hexagonal (Ports & Adapters)
-- [ ] Uso de Deptrac para verificar las dependencias
-- [ ] Ausencia de acoplamiento entre capas
-- [ ] Interfaces correctamente definidas para los puertos
-- [ ] Use Cases / Application Services bien definidos
-- [ ] Repositories con interfaces en el domain
-- [ ] DTOs para las transferencias de datos
+**Criterios Evaluados**:
+- Estructura de Clean Architecture (6 pts)
+- Separación Dominio/Aplicación/Infraestructura (6 pts)
+- Arquitectura Hexagonal / Ports & Adapters (4 pts)
+- Modelado DDD (Entidades, Value Objects, Agregados) (4 pts)
+- Use Cases y Application Services (3 pts)
+- Reglas de dependencia y Deptrac (2 pts)
 
-**Puntuación Arquitectura**: ___/25 puntos
+**Referencia**: `check-architecture.md`
 
-### Paso 3: Auditoría de Calidad del Código (25 puntos)
+### Paso 3: Auditoría de Calidad de Código (25 puntos)
 
-Ejecuta la auditoría de calidad del código verificando:
+Ejecutar la verificación de calidad de código:
 
-**Referencia a las reglas**: `.claude/rules/symfony-code-quality.md`
+**Comando**: Usar el comando slash `/symfony:check-code-quality` o seguir manualmente los pasos de `check-code-quality.md`
 
-- [ ] Respeto de PSR-12
-- [ ] PHPStan nivel 9 sin errores
-- [ ] Type hints estrictos en todos los parámetros y retornos
-- [ ] Declaración `declare(strict_types=1)` en todos los archivos
-- [ ] Sin código muerto (detectado por PHPStan)
-- [ ] Sin dependencias no utilizadas
-- [ ] Complejidad ciclomática < 10 por método
-- [ ] Longitud de métodos < 20 líneas
-- [ ] Clases con responsabilidad única
-- [ ] Documentación PHPDoc completa y actualizada
+**Criterios Evaluados**:
+- Conformidad PSR-12 (5 pts)
+- PHPStan nivel 9 (5 pts)
+- Type hints estrictos y declare(strict_types=1) (4 pts)
+- Principios KISS/DRY/YAGNI (4 pts)
+- Documentación y PHPDoc (4 pts)
+- Manejo de errores (3 pts)
 
-**Puntuación Calidad del Código**: ___/25 puntos
+**Referencia**: `check-code-quality.md`
 
-### Paso 4: Auditoría de Testing (25 puntos)
+### Paso 4: Auditoría de Pruebas (25 puntos)
 
-Ejecuta la auditoría de tests verificando:
+Ejecutar la verificación de pruebas:
 
-**Referencia a las reglas**: `.claude/rules/symfony-testing.md`
+**Comando**: Usar el comando slash `/symfony:check-testing` o seguir manualmente los pasos de `check-testing.md`
 
-- [ ] Cobertura de código ≥ 80%
-- [ ] Tests unitarios para el Domain
-- [ ] Tests de integración para la Infrastructure
-- [ ] Tests funcionales con Behat o Symfony WebTestCase
-- [ ] Tests de mutación con Infection (MSI ≥ 70%)
-- [ ] Fixtures para los tests
-- [ ] Tests aislados (sin dependencias entre tests)
-- [ ] Base de datos de test separada
-- [ ] Mocks y Stubs apropiados
-- [ ] CI/CD con ejecución automática de tests
+**Criterios Evaluados**:
+- Cobertura de código (7 pts)
+- Pruebas unitarias del Dominio (6 pts)
+- Pruebas de integración de Infraestructura (4 pts)
+- Pruebas funcionales (WebTestCase/Behat) (3 pts)
+- Pruebas de mutación con Infection (3 pts)
+- Aislamiento de pruebas y fixtures (2 pts)
 
-**Puntuación Testing**: ___/25 puntos
+**Referencia**: `check-testing.md`
 
 ### Paso 5: Auditoría de Seguridad (25 puntos)
 
-Ejecuta la auditoría de seguridad verificando:
+Ejecutar la verificación de seguridad:
+
+**Comando**: Usar el comando slash `/symfony:check-security` o seguir manualmente los pasos de `check-security.md`
 
-**Referencia a las reglas**: `.claude/rules/symfony-security.md`
+**Criterios Evaluados**:
+- Configuración del Security Bundle de Symfony (6 pts)
+- Protecciones OWASP Top 10 (5 pts)
+- Gestión de secretos y credenciales (4 pts)
+- Validación de entradas y CSRF (4 pts)
+- Autenticación y Autorización (Voters) (3 pts)
+- Vulnerabilidades de dependencias (2 pts)
+- Conformidad GDPR (1 pt)
 
-- [ ] Symfony Security Bundle correctamente configurado
-- [ ] OWASP Top 10: Protección contra inyección SQL
-- [ ] OWASP Top 10: Protección XSS
-- [ ] OWASP Top 10: Protección CSRF
-- [ ] OWASP Top 10: Autenticación segura
-- [ ] OWASP Top 10: Control de acceso (Voters, ACL)
-- [ ] RGPD: Consentimiento del usuario
-- [ ] RGPD: Derecho al olvido implementado
-- [ ] RGPD: Exportación de datos personales
-- [ ] Secrets externalizados (no en el código)
+**Referencia**: `check-security.md`
 
-**Puntuación Seguridad**: ___/25 puntos
+### Paso 6: Consolidación y Puntuación Global
 
-### Paso 6: Cálculo de la Puntuación Global
+Calcular la puntuación global y producir el informe consolidado:
+- [ ] Sumar las 4 puntuaciones (máximo 100 puntos)
+- [ ] Identificar las categorías críticas (<50%)
+- [ ] Enumerar todos los problemas transversales críticos
+- [ ] Priorizar las acciones por impacto/esfuerzo
+- [ ] Producir el informe consolidado final
 
-**PUNTUACIÓN GLOBAL**: ___/100 puntos
+**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 importante necesaria
+- 0-39: Crítico - Revisión completa necesaria
 
-Interpretación:
-- ✅ 90-100: Excelente - Cumplimiento ejemplar
-- ✅ 75-89: Bueno - Algunas mejoras menores
-- ⚠️ 60-74: Medio - Mejoras necesarias
-- ⚠️ 40-59: Insuficiente - Refactoring importante requerido
-- ❌ 0-39: Crítico - Refactorización completa necesaria
+### Paso 7: Recomendaciones y Plan de Acción
 
-### Paso 7: Informe Detallado
+Producir las recomendaciones finales:
+- [ ] Identificar las 3 acciones prioritarias principales 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 (alta relación impacto/esfuerzo)
 
-Genera un informe estructurado con:
+## FORMATO DE SALIDA
 
 ```
-=================================================
-   AUDITORÍA DE CUMPLIMIENTO SYMFONY
-=================================================
+AUDITORÍA DE CONFORMIDAD SYMFONY - INFORME COMPLETO
+=============================================
 
-📊 PUNTUACIÓN GLOBAL: ___/100
+PUNTUACIÓN GLOBAL: XX/100
 
-📐 Arquitectura        : ___/25 [✅|⚠️|❌]
-🎯 Calidad del Código  : ___/25 [✅|⚠️|❌]
-🧪 Testing             : ___/25 [✅|⚠️|❌]
-🔒 Seguridad           : ___/25 [✅|⚠️|❌]
+NIVEL DE CONFORMIDAD: [Excelente/Muy Bueno/Aceptable/Insuficiente/Crítico]
 
-=================================================
-   DETALLES POR CATEGORÍA
-=================================================
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-[Insertar los detalles de cada auditoría]
+PUNTUACIONES POR CATEGORÍA:
 
-=================================================
-   TOP 3 ACCIONES PRIORITARIAS
-=================================================
+ARQUITECTURA       : XX/25  [██████████░░░░░░░░░░] XX%
+CALIDAD DE CÓDIGO  : XX/25  [██████████░░░░░░░░░░] XX%
+PRUEBAS            : XX/25  [██████████░░░░░░░░░░] XX%
+SEGURIDAD          : XX/25  [██████████░░░░░░░░░░] XX%
 
-1. [Acción prioritaria #1 con impacto estimado]
-2. [Acción prioritaria #2 con impacto estimado]
-3. [Acción prioritaria #3 con impacto estimado]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-=================================================
-   RECOMENDACIONES TÉCNICAS
-=================================================
+FORTALEZAS GLOBALES:
+1. [Fortaleza identificada en múltiples categorías]
+2. [Otra fortaleza principal]
+3. [Tercera fortaleza]
 
-- [Recomendación técnica específica]
-- [Recomendación técnica específica]
-- [Recomendación técnica específica]
+MEJORAS GLOBALES:
+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:
+  • Estructura Clean Architecture     : XX/6
+  • Separación de capas               : XX/6
+  • Hexagonal / Ports & Adapters      : XX/4
+  • Modelado DDD                      : XX/4
+  • Use Cases                         : XX/3
+  • Reglas de dependencia             : XX/2
+
+Fortalezas:
+- [Fortalezas de arquitectura]
+
+Problemas:
+- [Problemas de arquitectura]
+
+[Secciones similares para Calidad de Código, Pruebas y Seguridad...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+TOP 3 ACCIONES PRIORITARIAS (TODAS LAS CATEGORÍAS):
+
+1. CRÍTICO - [Acción #1]
+   Categoría : [Arquitectura/Calidad/Pruebas/Seguridad]
+   Impacto   : [Alto/Medio/Bajo]
+   Esfuerzo  : [Alto/Medio/Bajo]
+   Prioridad : INMEDIATA
+
+   Descripción detallada:
+   [Explicación del problema y solución propuesta]
+
+   Archivos afectados:
+   - [archivo:línea]
+
+   Ejemplo de corrección:
+   [Código o comando de corrección]
+
+2. IMPORTANTE - [Acción #2]
+   [Mismo formato...]
+
+3. RECOMENDADA - [Acción #3]
+   [Mismo formato...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+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]
 
-### Paso 8: Comandos Docker para Verificaciones
+SEMANAS 2-4 (Corto plazo):
+- [ ] [Acción importante #2]
+- [ ] [Otras victorias rápidas]
 
-Para cada verificación, utiliza Docker para abstraerse del entorno local:
+MESES 2-3 (Medio plazo):
+- [ ] [Acción recomendada #3]
+- [ ] [Mejoras progresivas]
 
-```bash
-# PHPStan
-docker run --rm -v $(pwd):/app phpstan/phpstan analyse src --level=9
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-# PHP_CodeSniffer (PSR-12)
-docker run --rm -v $(pwd):/project php:8.2-cli vendor/bin/phpcs --standard=PSR12 src/
+RESUMEN EJECUTIVO:
 
-# PHPUnit con cobertura
-docker run --rm -v $(pwd):/app php:8.2-cli vendor/bin/phpunit --coverage-text --coverage-html=coverage
+[Párrafo de resumen sobre el estado general del proyecto, las principales
+fortalezas, las principales debilidades y la trayectoria recomendada para
+mejorar la conformidad. Indicar si el proyecto está listo para producción,
+requiere correcciones o necesita refactorización.]
 
-# Infection (mutation testing)
-docker run --rm -v $(pwd):/app infection/infection --min-msi=70
+Recomendación General: [Listo para producción / Correcciones menores /
+Refactorización importante / Revisión completa necesaria]
 
-# Deptrac
-docker run --rm -v $(pwd):/app qossmic/deptrac analyse
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-## IMPORTANTE
+## NOTAS IMPORTANTES
 
-- Utiliza SIEMPRE Docker para los comandos para abstraerse del entorno local
-- NO almacenes NUNCA archivos en /tmp
-- Proporciona ejemplos concretos de problemas detectados
-- Prioriza las acciones según el impacto y el esfuerzo
-- Sé factual y objetivo en la evaluación
+- 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 las acciones según 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