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

package/Dev/i18n/es/UIUX/commands/user-flow.md

@@ -5,7 +5,7 @@ argument-hint: [arguments]
 
 # Diseño de Flujo de Usuario
 
-Eres un Experto UX/Ergonomía. Debes diseñar un flujo de usuario (user flow) completo y optimizado.
+Eres un Experto UX/Ergonomía. Debes diseñar un flujo de usuario completo y optimizado.
 
 ## Argumentos
 $ARGUMENTS
@@ -19,7 +19,7 @@ Ejemplo: `/uiux:user-flow "Registro de usuario"` o `/uiux:user-flow "Checkout" p
 
 ## Modo Plan
 
-> **El modo plan es recomendado.** Claude activa el modo plan para estructurar el enfoque, identificar dependencias y presentar una estrategia de generación antes de crear artefactos.
+> **El modo plan es recomendado.** Claude activa el modo plan para estructurar el enfoque, identificar dependencias y presentar una estrategia de generación antes de crear los artefactos.
 
 ## MISIÓN
 
@@ -57,16 +57,44 @@ Versión: 1.0
 > "{Lo que el usuario quiere lograr}"
 
 ### Objetivo de negocio
-> "{Lo que el negocio quiere obtener}"
+> "{Lo que el negocio quiere conseguir}"
+
+### Restricciones
+- Tiempo máximo: {X segundos/minutos}
+- Pasos máximos: {Y}
+- Dispositivo: {restricciones técnicas}
+- Sin conexión: Sí / No
+
+──────────────────────────────────────────────────────────────
+🗺️ RESUMEN GENERAL
+──────────────────────────────────────────────────────────────
+
+```
+┌──────┐    ┌──────┐    ┌──────┐    ┌──────┐    ┌──────┐
+│Inicio│───▶│Paso 1│───▶│Paso 2│───▶│Paso 3│───▶│ Fin  │
+└──────┘    └──────┘    └──────┘    └──────┘    └──────┘
+                │            │
+                ▼            ▼
+           ┌────────┐   ┌────────┐
+           │Error A │   │Error B │
+           └────────┘   └────────┘
+```
 
 ──────────────────────────────────────────────────────────────
 📋 FLUJO DETALLADO
 ──────────────────────────────────────────────────────────────
 
 ### Paso 0: Disparador
+
 **Punto de entrada**: {Cómo llega el usuario}
+- Vía: {menú / enlace / CTA / deep link}
+- Estado previo: {autenticado / anónimo / datos existentes}
+- Precondiciones: {lo que debe ser verdadero}
+
+---
 
 ### Paso 1: {Nombre del paso}
+
 **Pantalla**: {Nombre de pantalla}
 **Objetivo**: {Lo que el usuario debe hacer}
 
@@ -74,40 +102,175 @@ Versión: 1.0
 | Acción | Elemento UI | Resultado |
 |--------|-------------|-----------|
 | Principal | {botón/enlace} | Pasa al paso 2 |
+| Secundaria | {botón/enlace} | {alternativa} |
+| Terciaria | {enlace} | {otra opción} |
+
+#### Datos requeridos
+| Campo | Tipo | Validación | Requerido |
+|-------|------|------------|-----------|
+| {campo} | {tipo} | {reglas} | Sí/No |
 
 #### Feedback del sistema
 | Evento | Feedback | Tipo |
 |--------|----------|------|
-| Error validación | {mensaje} | Inline |
+| Foco en input | {feedback} | Visual |
+| Error de validación | {mensaje} | Inline |
+| Éxito | {feedback} | Toast/inline |
+
+#### Puntos de atención
+- ⚠️ {fricción potencial}
+- 💡 {oportunidad de mejora}
+
+---
+
+### Paso 2: {Nombre del paso}
+
+{Misma estructura...}
+
+---
+
+### Paso N: Confirmación (Fin)
+
+**Pantalla**: {Confirmación / Éxito}
+**Estado final**: {Lo que se ha logrado}
+
+#### Contenido
+- Mensaje de éxito
+- Resumen de la acción
+- Próximos pasos sugeridos
+
+#### Acciones siguientes
+| Acción | Destino |
+|--------|---------|
+| CTA principal | {siguiente flujo} |
+| Volver | {dashboard/lista} |
+| Compartir | {si aplica} |
 
 ──────────────────────────────────────────────────────────────
-📊 MÉTRICAS & KPIs
+⚠️ CAMINOS ALTERNATIVOS
 ──────────────────────────────────────────────────────────────
 
+### Error: {Tipo de error}
+
+**Disparador**: {Qué causa el error}
+**Pantalla**: {Inline / Modal / Página dedicada}
+
+#### Mensaje de error
+```
+Título: {Título claro}
+Descripción: {Explicación del problema}
+Acción: {Cómo resolverlo}
+```
+
+#### Opciones del usuario
+- Reintentar: {comportamiento}
+- Modificar: {volver al paso X}
+- Abandonar: {¿se guarda el estado?}
+
+---
+
+### Abandono: Guardado del estado
+
+**Comportamiento**:
+- Borrador guardado automáticamente
+- Duración de retención: {X días}
+- Notificación de recordatorio: Sí / No
+
+---
+
+### Caso límite: {Descripción}
+
+**Situación**: {Contexto particular}
+**Comportamiento**: {Adaptación del flujo}
+
+──────────────────────────────────────────────────────────────
+📊 MÉTRICAS Y KPIs
+──────────────────────────────────────────────────────────────
+
+### Objetivos cuantitativos
+
 | Métrica | Objetivo | Medición |
 |---------|----------|----------|
 | Tiempo de completación | < {X} seg | Time-on-task |
 | Tasa de completación | > {Y}% | Funnel analytics |
+| Tasa de error | < {Z}% | Error rate |
 | Número de clics | ≤ {N} | Click tracking |
+| Puntuación de satisfacción | > {S}/5 | Encuesta post-tarea |
+
+### Puntos de medición
+
+| Paso | Evento a rastrear |
+|------|-------------------|
+| Entrada | `flow_started` |
+| Paso 1 | `step_1_completed` |
+| Paso 2 | `step_2_completed` |
+| Éxito | `flow_completed` |
+| Abandono | `flow_abandoned` con `last_step` |
+| Error | `flow_error` con `error_type` |
+
+──────────────────────────────────────────────────────────────
+🧠 ERGONOMÍA
+──────────────────────────────────────────────────────────────
+
+### Carga cognitiva
+
+| Paso | Complejidad | Justificación |
+|------|-------------|---------------|
+| 1 | Baja | {1-2 acciones simples} |
+| 2 | Media | {formulario corto} |
+| 3 | Baja | {solo confirmación} |
+
+### Principios aplicados
+
+| Principio | Aplicación |
+|-----------|------------|
+| Divulgación progresiva | {cómo} |
+| Valores por defecto | {cuáles} |
+| Validación inline | {cuándo} |
+| Guardado automático | {frecuencia} |
+
+──────────────────────────────────────────────────────────────
+♿ ACCESIBILIDAD
+──────────────────────────────────────────────────────────────
+
+### Navegación por teclado
+- Orden de tabulación: {secuencia lógica}
+- Skip links: {si hay formulario largo}
+- Gestión del foco: {al cambiar de paso}
+
+### Lector de pantalla
+- Anuncio de paso: "Paso X de Y"
+- Errores: aria-live="assertive"
+- Progreso: aria-describedby
+
+### Tiempo
+- Sin tiempo límite automático
+- Si hay demora: extensible o desactivable
 
 ──────────────────────────────────────────────────────────────
 ✅ CHECKLIST DE VALIDACIÓN
 ──────────────────────────────────────────────────────────────
 
 ### UX
-- [ ] Objetivo de usuario claro
+- [ ] Objetivo del usuario claro
 - [ ] Pasos mínimos necesarios
 - [ ] Feedback en cada acción
 - [ ] Caminos de error documentados
+- [ ] Abandono con guardado
+
+### Medibilidad
+- [ ] KPIs definidos
+- [ ] Eventos de seguimiento listados
+- [ ] Objetivos cuantificados
 
 ### Accesibilidad
 - [ ] Navegación por teclado
-- [ ] Anuncios SR
+- [ ] Anuncios del lector de pantalla
 - [ ] Sin límites de tiempo
 ```
 
 ### Paso 3: Validación
 
-- Revisión con stakeholders
-- Prueba de usuario (5 usuarios mín)
-- Iteración basada en feedback
+- Revisión con las partes interesadas (stakeholders)
+- Prueba de usuario (mínimo 5 usuarios)
+- Iteración basada en el feedback recibido

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

@@ -1,128 +1,253 @@
 ---
-description: Audit Vue.js project compliance with coding standards and best practices
+description: Verificar el cumplimiento completo del proyecto Vue.js
+argument-hint: [arguments]
 ---
 
-# Vue.js Compliance Audit
+# Verificar el Cumplimiento Completo de Vue.js
 
-You are an expert Vue.js auditor. Perform a comprehensive compliance check on this project.
+## Argumentos
 
-## MISSION
-
-Audit the project for compliance with Vue.js 3 best practices, Composition API standards, and TypeScript conventions.
+$ARGUMENTS (opcional: ruta al proyecto a analizar)
 
 ## Modo Plan
 
 > El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
-## AUDIT CHECKLIST
+## MISIÓN
 
-### 1. Project Structure (20 points)
+Realizar una auditoría de cumplimiento completa del proyecto Vue.js 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.
 
-```
-[ ] src/components/ - Shared components organized
-[ ] src/composables/ - Composition functions present
-[ ] src/stores/ - Pinia stores properly structured
-[ ] src/router/ - Vue Router configuration
-[ ] src/types/ - TypeScript types defined
-[ ] src/services/ - API services separated
-```
+### Paso 1: Preparación de la Auditoría
 
-### 2. Component Standards (25 points)
+Preparar el entorno de auditoría:
+- [ ] Identificar la ruta del proyecto a auditar
+- [ ] Verificar la presencia de los archivos de configuración (package.json, tsconfig.json, vite.config.ts)
+- [ ] Listar los directorios principales (src/, tests/, public/, etc.)
+- [ ] Identificar la estructura del proyecto y la versión de Vue.js
 
-```
-[ ] Using <script setup> syntax
-[ ] TypeScript with lang="ts"
-[ ] Props defined with defineProps<T>()
-[ ] Emits defined with defineEmits<T>()
-[ ] Components are multi-word named
-[ ] Base components use Base prefix
-```
+**Nota**: Si se proporciona $ARGUMENTS, usar como ruta del proyecto; en caso contrario, usar el directorio actual.
 
-### 3. Composition API (20 points)
+### Paso 2: Auditoría de Arquitectura (25 puntos)
 
-```
-[ ] No Options API in new components
-[ ] Composables follow use* naming
-[ ] Reactive state properly typed
-[ ] Computed properties used correctly
-[ ] Watchers cleaned up
-```
+Ejecutar la verificación completa de arquitectura:
 
-### 4. Pinia Stores (15 points)
+**Comando**: Usar el slash command `/vuejs:check-architecture` o seguir manualmente los pasos de `check-architecture.md`
 
-```
-[ ] Setup syntax stores (composition style)
-[ ] Proper TypeScript typing
-[ ] Actions are async when needed
-[ ] Getters use computed
-[ ] No direct state mutation from components
-```
+**Criterios Evaluados**:
+- Organización de componentes y funcionalidades (6 pts)
+- Estructura y reutilización de composables (6 pts)
+- Arquitectura de los stores Pinia (4 pts)
+- Configuración del router y lazy loading (4 pts)
+- Separación del módulo compartido/common (3 pts)
+- Reglas de dependencias y barrel exports (2 pts)
 
-### 5. TypeScript Integration (20 points)
+**Referencia**: `check-architecture.md`
 
-```
-[ ] Strict mode enabled
-[ ] No implicit any
-[ ] Props and emits fully typed
-[ ] Interfaces for complex types
-[ ] Type-only imports used
-```
+### Paso 3: Auditoría de Calidad de Código (25 puntos)
+
+Ejecutar la verificación de calidad de código:
+
+**Comando**: Usar el slash command `/vuejs:check-code-quality` o seguir manualmente los pasos de `check-code-quality.md`
+
+**Criterios Evaluados**:
+- Modo estricto de TypeScript y seguridad de tipos (5 pts)
+- Cumplimiento de ESLint y Prettier (5 pts)
+- Uso de la Composition API y script setup (4 pts)
+- Principios KISS/DRY/YAGNI (4 pts)
+- Convenciones de nomenclatura (4 pts)
+- Gestión de errores (3 pts)
+
+**Referencia**: `check-code-quality.md`
+
+### Paso 4: Auditoría de Pruebas (25 puntos)
+
+Ejecutar la verificación de pruebas:
 
-## OUTPUT FORMAT
+**Comando**: Usar el slash command `/vuejs:check-testing` o seguir manualmente los pasos de `check-testing.md`
+
+**Criterios Evaluados**:
+- Cobertura de código (7 pts)
+- Pruebas unitarias de composables y stores (6 pts)
+- Pruebas de componentes con Vue Test Utils (4 pts)
+- Pruebas de integración (3 pts)
+- Calidad de las pruebas y patrón AAA (3 pts)
+- Organización de mocks y fixtures (2 pts)
+
+**Referencia**: `check-testing.md`
+
+### Paso 5: Auditoría de Seguridad (25 puntos)
+
+Ejecutar la verificación de seguridad:
+
+**Comando**: Usar el slash command `/vuejs:check-security` o seguir manualmente los pasos de `check-security.md`
+
+**Criterios Evaluados**:
+- Prevención de XSS (uso de v-html) (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 guards de ruta (3 pts)
+- Comunicación segura con la API (2 pts)
+- Protección CSRF (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 requerida
+- 0-39: Crítico - Revisión completa necesaria
+
+### Paso 7: Recomendaciones y Plan de Acción
+
+Producir las recomendaciones finales:
+- [ ] Identificar las 3 acciones prioritarias de 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 (alto impacto/bajo esfuerzo)
+
+## FORMATO DE SALIDA
 
 ```
-══════════════════════════════════════════════════════════════
-VUE.JS COMPLIANCE AUDIT
-══════════════════════════════════════════════════════════════
-
-📊 SUMMARY
-──────────────────────────────────────────────────────────────
-Total Score: XX/100
-Status: ✅ COMPLIANT | ⚠️ NEEDS WORK | ❌ NON-COMPLIANT
-
-📁 PROJECT STRUCTURE: XX/20
-──────────────────────────────────────────────────────────────
-[✓] Organized component structure
-[✗] Missing composables directory
-    → Create src/composables/ for reusable logic
-
-🧩 COMPONENT STANDARDS: XX/25
-──────────────────────────────────────────────────────────────
-[✓] Using <script setup>
-[✗] Some components use Options API
-    Files: src/components/OldComponent.vue
-    → Migrate to Composition API
-
-🔧 COMPOSITION API: XX/20
-──────────────────────────────────────────────────────────────
-[✓] Composables properly named
-[✗] Missing cleanup in watchers
-    File: src/composables/useData.ts:45
-
-🏪 PINIA STORES: XX/15
-──────────────────────────────────────────────────────────────
-[✓] Setup syntax used
-[✓] Proper typing
-
-📝 TYPESCRIPT: XX/20
-──────────────────────────────────────────────────────────────
-[✓] Strict mode enabled
-[✗] Implicit any found
-    File: src/utils/helpers.ts:12
-
-📋 RECOMMENDATIONS
-──────────────────────────────────────────────────────────────
-1. [HIGH] Migrate remaining Options API components
-2. [MEDIUM] Add missing type definitions
-3. [LOW] Organize composables by feature
-
-══════════════════════════════════════════════════════════════
+AUDITORÍA DE CUMPLIMIENTO VUE.JS - 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 GLOBALES:
+1. [Fortaleza identificada en múltiples categorías]
+2. [Otra fortaleza principal]
+3. [Tercera fortaleza]
+
+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:
+  • Organización de componentes y funcionalidades : XX/6
+  • Estructura de composables                     : XX/6
+  • Arquitectura de stores Pinia                  : XX/4
+  • Router y lazy loading                         : XX/4
+  • Separación del módulo compartido              : XX/3
+  • Reglas de dependencias                        : 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. 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, las principales
+fortalezas, las 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 / Revisión completa necesaria]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-## PROCESS
+## NOTAS IMPORTANTES
 
-1. Scan project structure
-2. Analyze component files for standards
-3. Check composables and stores
-4. Verify TypeScript configuration
-5. Generate compliance report with score
+- 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 según la matriz Impacto/Esfuerzo
+- Los problemas de seguridad son SIEMPRE la prioridad máxima
+- Proponer correcciones automatizables (scripts, hooks pre-commit)
+- El informe debe ser accionable, no meramente descriptivo
+- Adaptar las recomendaciones al contexto de negocio del proyecto