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

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

@@ -1,203 +1,253 @@
 ---
-description: Angular Standards Compliance Check
+description: Verificar el cumplimiento completo de Angular
+argument-hint: [argumentos]
 ---
 
-# Angular Standards Compliance Check
+# Verificar el cumplimiento completo de Angular
 
-Verify that the Angular project follows established coding standards and best practices.
+## Argumentos
 
-## What This Command Does
+$ARGUMENTS (opcional: ruta del proyecto a analizar)
 
-1. **Standards Verification**
-   - Check coding conventions
-   - Verify naming conventions
-   - Validate file organization
-   - Check import order
-   - Verify documentation standards
+## Modo Plan
 
-2. **Angular-Specific Checks**
-   - Standalone components usage
-   - Signals implementation
-   - OnPush change detection
-   - Modern control flow (@if, @for)
-   - Typed forms
+> El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
-3. **Generated Report**
-   - Non-compliant files
-   - Severity levels
-   - Remediation recommendations
-   - Compliance score (/100)
+## MISIÓN
 
-## Modo Plan
+Realizar una auditoría de cumplimiento completa del proyecto Angular 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.
 
-> El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
+### Paso 1: Preparación de la auditoría
 
-## Compliance Areas
-
-### 1. Component Standards
-
-```typescript
-// ✅ Compliant
-@Component({
-  selector: 'app-user-profile',
-  standalone: true,
-  imports: [CommonModule],
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: `...`
-})
-export class UserProfileComponent {}
-
-// ❌ Non-compliant
-@Component({
-  selector: 'user-profile',     // Missing app- prefix
-  // standalone: missing       // Not standalone
-  // changeDetection: missing  // Not OnPush
-})
-export class UserProfile {}    // Missing Component suffix
-```
+Preparar el entorno de auditoría:
+- [ ] Identificar la ruta del proyecto a auditar
+- [ ] Verificar la presencia de archivos de configuración (angular.json, tsconfig.json, package.json)
+- [ ] Listar los directorios principales (src/app/, e2e/, etc.)
+- [ ] Identificar la estructura del proyecto y la versión de Angular
 
-### 2. Signal Usage
+**Nota**: Si se proporciona $ARGUMENTS, usarlo como ruta del proyecto; de lo contrario, usar el directorio actual.
 
-```typescript
-// ✅ Compliant - Using signals
-export class CounterComponent {
-  count = signal(0);
-  doubleCount = computed(() => this.count() * 2);
-}
+### Paso 2: Auditoría de Arquitectura (25 puntos)
 
-// ❌ Non-compliant - Using observables for local state
-export class CounterComponent {
-  count$ = new BehaviorSubject(0);
-}
-```
+Ejecutar la verificación completa de arquitectura:
 
-### 3. Template Syntax
+**Comando**: Usar el comando slash `/angular:check-architecture` o seguir manualmente los pasos en `check-architecture.md`
 
-```html
-<!-- ✅ Compliant - Modern control flow -->
-@if (loading()) {
-  <app-spinner />
-}
+**Criterios evaluados**:
+- Estructura de módulos orientada al dominio (6 pts)
+- Uso de componentes standalone (6 pts)
+- Lazy loading y enrutamiento (4 pts)
+- Separación Core/Shared/Feature (4 pts)
+- Organización de la capa de servicios (3 pts)
+- Patrones de inyección de dependencias (2 pts)
 
-@for (item of items(); track item.id) {
-  <app-item [data]="item" />
-}
+**Referencia**: `check-architecture.md`
 
-<!-- ❌ Non-compliant - Legacy syntax -->
-<app-spinner *ngIf="loading"></app-spinner>
-<app-item *ngFor="let item of items" [data]="item"></app-item>
-```
+### Paso 3: Auditoría de Calidad del Código (25 puntos)
 
-### 4. Dependency Injection
+Ejecutar la verificación de calidad del código:
 
-```typescript
-// ✅ Compliant - inject() function
-export class MyComponent {
-  private readonly userService = inject(UserService);
-}
+**Comando**: Usar el comando slash `/angular:check-code-quality` o seguir manualmente los pasos en `check-code-quality.md`
 
-// ⚠️ Warning - Constructor injection (valid but verbose)
-export class MyComponent {
-  constructor(private userService: UserService) {}
-}
-```
+**Criterios evaluados**:
+- Modo estricto de TypeScript y seguridad de tipos (5 pts)
+- Cumplimiento de ESLint (5 pts)
+- Signals y patrones modernos de Angular (4 pts)
+- Principios KISS/DRY/YAGNI (4 pts)
+- Convenciones de nomenclatura y estructura de archivos (4 pts)
+- Detección de cambios OnPush (3 pts)
 
-### 5. File Naming
+**Referencia**: `check-code-quality.md`
 
-```
-✅ Compliant:
-- user-profile.component.ts
-- auth.service.ts
-- auth.guard.ts
-- date-format.pipe.ts
-
-❌ Non-compliant:
-- UserProfile.component.ts (PascalCase)
-- authService.ts (missing suffix)
-- AuthGuard.ts (PascalCase)
-```
+### Paso 4: Auditoría de Pruebas (25 puntos)
 
-## Scoring Criteria
+Ejecutar la verificación de pruebas:
 
-| Category | Weight | Criteria |
-|----------|--------|----------|
-| Standalone Components | 20% | All components are standalone |
-| Signals Usage | 15% | Local state uses signals |
-| OnPush Strategy | 15% | All components use OnPush |
-| Modern Control Flow | 10% | @if/@for instead of *ngIf/*ngFor |
-| Typed Forms | 10% | Forms are strongly typed |
-| Naming Conventions | 10% | Correct file/class naming |
-| Import Organization | 10% | Imports properly ordered |
-| Documentation | 10% | Key components documented |
+**Comando**: Usar el comando slash `/angular:check-testing` o seguir manualmente los pasos en `check-testing.md`
 
-## Output Format
+**Criterios evaluados**:
+- Cobertura de código (7 pts)
+- Pruebas unitarias para servicios y pipes (6 pts)
+- Pruebas de componentes con TestBed (4 pts)
+- Pruebas de integración (3 pts)
+- Pruebas E2E (3 pts)
+- Aislamiento de pruebas y mocks (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 `/angular:check-security` o seguir manualmente los pasos en `check-security.md`
+
+**Criterios evaluados**:
+- Prevención de XSS y DomSanitizer (6 pts)
+- Gestión de secretos y credenciales (5 pts)
+- Validación y saneamiento de entradas (4 pts)
+- Vulnerabilidades en dependencias (4 pts)
+- Autenticación y guardias de rutas (3 pts)
+- CSRF e interceptores HTTP (2 pts)
+- Política de seguridad de contenidos (1 pt)
+
+**Referencia**: `check-security.md`
+
+### Paso 6: Consolidación y Puntuación Global
+
+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
+
+**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
+
+### Paso 7: Recomendaciones y Plan de Acción
+
+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
 
 ```
-══════════════════════════════════════════════════════════════
-ANGULAR COMPLIANCE REPORT
-══════════════════════════════════════════════════════════════
-
-📊 SCORE: 85/100
-
-✅ PASSING (6)
-──────────────────────────────────────────────────────────────
-• Standalone components: 100% (24/24 components)
-• OnPush strategy: 100% (24/24 components)
-• Typed forms: 100% (8/8 forms)
-• Import organization: 100%
-• File naming: 100%
-• Documentation: 90%
-
-⚠️ WARNINGS (2)
-──────────────────────────────────────────────────────────────
-• Modern control flow: 75% (18/24 templates)
-  - src/app/features/users/user-list.component.html:15 - Uses *ngFor
-  - src/app/shared/modal/modal.component.html:8 - Uses *ngIf
-
-• Signals usage: 80% (16/20 components with local state)
-  - src/app/features/auth/login.component.ts - Uses BehaviorSubject
-
-❌ ERRORS (1)
-──────────────────────────────────────────────────────────────
-• Constructor injection detected (prefer inject()):
-  - src/app/core/services/api.service.ts:15
-
-📋 RECOMMENDATIONS
-──────────────────────────────────────────────────────────────
-1. Migrate remaining *ngFor to @for with track
-2. Replace BehaviorSubject with signal() for local state
-3. Use inject() function instead of constructor injection
-
-══════════════════════════════════════════════════════════════
-```
+AUDITORÍA DE CUMPLIMIENTO ANGULAR - 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%
 
-## Automated Checks
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Run these commands to verify compliance:
+FORTALEZAS GENERALES:
+1. [Fortaleza identificada en múltiples categorías]
+2. [Otra fortaleza principal]
+3. [Tercera fortaleza]
 
-```bash
-# Lint check
-ng lint
+MEJORAS GENERALES:
+1. [Mejora transversal menor]
+2. [Otra mejora recomendada]
+3. [Tercera mejora]
 
-# Type check
-npx tsc --noEmit
+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]
 
-# Test coverage
-npm run test:ci
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-# Build check
-ng build --configuration=production
+DETALLES POR CATEGORÍA:
+
+┌─────────────────────────────────────────────┐
+│ ARQUITECTURA (XX/25)                        │
+└─────────────────────────────────────────────┘
+
+Sub-puntuaciones:
+  • Módulos orientados al dominio    : XX/6
+  • Componentes standalone           : XX/6
+  • Lazy loading y enrutamiento      : XX/4
+  • Core/Shared/Feature              : XX/4
+  • Capa de servicios                : XX/3
+  • Inyección de dependencias        : XX/2
+
+Fortalezas:
+- [Fortalezas de arquitectura]
+
+Problemas:
+- [Problemas de arquitectura]
+
+[Secciones similares para Calidad del 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. RECOMENDADO - [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]
+
+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]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-## Checklist
-
-- [ ] All components are standalone
-- [ ] All components use OnPush change detection
-- [ ] Local state uses signals (not BehaviorSubject)
-- [ ] Templates use @if/@for/@switch
-- [ ] Forms are typed (FormGroup<T>)
-- [ ] inject() used for dependency injection
-- [ ] File naming follows conventions
-- [ ] Imports are organized
-- [ ] Public API documented
-- [ ] Tests pass with >80% coverage
+## 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