awc-zns-mtd 2.0.0

package/src/modules/awc-zns-mtd/workflows/qa-flow/workflow.yaml

@@ -0,0 +1,291 @@
+workflow:
+  name: "QA Flow - Aseguramiento de Calidad"
+  id: "qa-flow"
+  version: "1.0.0"
+  description: "Workflow de testing y aseguramiento de calidad integral"
+  
+  metadata:
+    duration: "Continuo durante desarrollo + 1 semana intensiva pre-release"
+    complexity: "high"
+    team_size: "1-3 QA Engineers"
+  
+  phases:
+    - id: "test-planning"
+      name: "Test Planning"
+      
+    - id: "automated-testing"
+      name: "Automated Testing"
+      
+    - id: "manual-testing"
+      name: "Manual & Exploratory Testing"
+      
+    - id: "uat"
+      name: "User Acceptance Testing"
+
+  agents:
+    primary:
+      - "qa-test-automation-engineer"
+      - "security-specialist"
+      - "performance-engineer"
+
+  steps:
+    - id: "qa-01"
+      name: "Crear Test Plan"
+      phase: "test-planning"
+      agent: "qa-test-automation-engineer"
+      duration: "2-4 horas"
+      when: "Inicio de sprint o inicio de release"
+      
+      actions:
+        - type: "analyze"
+          description: "Analizar user stories del sprint"
+        
+        - type: "design"
+          description: "Diseñar casos de prueba"
+          coverage:
+            - "Happy paths"
+            - "Edge cases"
+            - "Error scenarios"
+        
+        - type: "prioritize"
+          description: "Priorizar testing por criticidad"
+      
+      deliverables:
+        - "Test Plan document"
+        - "Test cases en test management tool"
+
+    - id: "qa-02"
+      name: "Unit Testing (Developers)"
+      phase: "automated-testing"
+      agent: "senior-backend-developer"
+      duration: "Continuo durante desarrollo"
+      
+      actions:
+        - type: "write"
+          description: "Escribir unit tests (TDD)"
+          target: ">80% code coverage"
+        
+        - type: "run"
+          description: "Ejecutar tests en cada commit (CI/CD)"
+      
+      deliverables:
+        - "Unit tests con >80% coverage"
+
+    - id: "qa-03"
+      name: "Integration Testing"
+      phase: "automated-testing"
+      agent: "qa-test-automation-engineer"
+      duration: "2-4 horas por feature"
+      
+      actions:
+        - type: "write"
+          description: "Escribir integration tests"
+          tools:
+            - "Postman/Newman (API testing)"
+            - "Jest/JUnit (integration tests)"
+        
+        - type: "automate"
+          description: "Integrar tests al CI/CD pipeline"
+      
+      deliverables:
+        - "Integration test suite"
+
+    - id: "qa-04"
+      name: "End-to-End Testing"
+      phase: "automated-testing"
+      agent: "qa-test-automation-engineer"
+      duration: "1-2 días por flujo crítico"
+      
+      actions:
+        - type: "write"
+          description: "Escribir E2E tests para flujos críticos"
+          tools:
+            - "Cypress"
+            - "Playwright"
+            - "Selenium"
+        
+        - type: "maintain"
+          description: "Mantener tests estables (evitar flakiness)"
+      
+      deliverables:
+        - "E2E test suite para flujos críticos"
+
+    - id: "qa-05"
+      name: "Performance Testing"
+      phase: "automated-testing"
+      agent: "performance-engineer"
+      duration: "1-2 días"
+      when: "Pre-release o cuando hay cambios de performance"
+      
+      actions:
+        - type: "test"
+          description: "Ejecutar load testing"
+          tools: "JMeter, Gatling, K6"
+          scenarios:
+            - "Normal load (usuarios promedio)"
+            - "Peak load (tráfico pico)"
+            - "Stress test (hasta breaking point)"
+        
+        - type: "analyze"
+          description: "Analizar resultados y bottlenecks"
+      
+      deliverables:
+        - "Performance test report"
+
+    - id: "qa-06"
+      name: "Security Testing"
+      phase: "automated-testing"
+      agent: "security-specialist"
+      duration: "1 día"
+      when: "Pre-release"
+      
+      actions:
+        - type: "scan"
+          description: "Ejecutar security scans"
+          tools:
+            - "OWASP ZAP"
+            - "Snyk"
+            - "Burp Suite"
+        
+        - type: "audit"
+          description: "Revisar OWASP Top 10"
+      
+      deliverables:
+        - "Security scan report"
+        - "Vulnerabilities list (priorizado por CVSS)"
+
+    - id: "qa-07"
+      name: "Exploratory Testing"
+      phase: "manual-testing"
+      agent: "qa-test-automation-engineer"
+      duration: "4-8 horas por sprint"
+      
+      actions:
+        - type: "explore"
+          description: "Testing exploratorio sin script"
+          approach: "Thinking like a user, intentar romper el sistema"
+        
+        - type: "document"
+          description: "Documentar bugs encontrados"
+      
+      deliverables:
+        - "Bug reports en Jira"
+
+    - id: "qa-08"
+      name: "Regression Testing"
+      phase: "manual-testing"
+      agent: "qa-test-automation-engineer"
+      duration: "Automático (CI/CD)"
+      when: "Cada deployment"
+      
+      actions:
+        - type: "run"
+          description: "Ejecutar regression test suite completa"
+        
+        - type: "verify"
+          description: "Verificar que no se rompió nada existente"
+      
+      deliverables:
+        - "Regression test results"
+
+    - id: "qa-09"
+      name: "User Acceptance Testing (UAT)"
+      phase: "uat"
+      agent: "product-owner-business-analyst"
+      duration: "3-5 días"
+      when: "Pre-release"
+      attendees: "Stakeholders + usuarios finales"
+      
+      actions:
+        - type: "prepare"
+          description: "Preparar ambiente de UAT"
+        
+        - type: "test"
+          description: "Usuarios finales prueban features"
+        
+        - type: "collect"
+          description: "Recolectar feedback y bugs"
+        
+        - type: "approve"
+          description: "Stakeholders aprueban para producción"
+      
+      deliverables:
+        - "UAT sign-off document"
+        - "Lista de bugs encontrados en UAT"
+
+    - id: "qa-10"
+      name: "Test Report & Go/No-Go Decision"
+      phase: "uat"
+      agent: "qa-test-automation-engineer"
+      duration: "2 horas"
+      
+      actions:
+        - type: "compile"
+          description: "Compilar resultados de todos los tests"
+          metrics:
+            - "Test pass rate"
+            - "Critical bugs open"
+            - "Code coverage"
+            - "Performance benchmarks"
+        
+        - type: "decide"
+          description: "Go/No-Go decision para producción"
+          criteria:
+            - "0 critical bugs"
+            - "< 5 high priority bugs"
+            - "Test pass rate > 95%"
+      
+      deliverables:
+        - "Final QA Report"
+        - "Go/No-Go recommendation"
+
+  deliverables:
+    - "Test Plan"
+    - "Automated test suites (unit, integration, E2E)"
+    - "Performance test results"
+    - "Security scan report"
+    - "Bug reports"
+    - "Final QA Report"
+    - "UAT sign-off"
+
+  metrics:
+    - name: "Test Coverage"
+      target: "> 80%"
+    
+    - name: "Test Pass Rate"
+      target: "> 95%"
+    
+    - name: "Bug Detection Rate"
+      description: "% de bugs encontrados en QA vs producción"
+      target: "> 90% (pocos bugs escapan a producción)"
+    
+    - name: "Regression Test Execution Time"
+      target: "< 30 minutos"
+
+  best_practices:
+    - "Shift-left testing: involucrar QA desde el inicio"
+    - "Automatizar todo lo que sea repetible"
+    - "Mantener tests estables y rápidos"
+    - "Testing en pirámide: muchos unit, algunos integration, pocos E2E"
+    - "Usar feature flags para testing en producción"
+
+  tools:
+    unit_testing:
+      - "Jest (JavaScript)"
+      - "JUnit (Java)"
+      - "PyTest (Python)"
+    
+    e2e_testing:
+      - "Cypress"
+      - "Playwright"
+      - "Selenium"
+    
+    performance:
+      - "JMeter"
+      - "Gatling"
+      - "K6"
+    
+    security:
+      - "OWASP ZAP"
+      - "Snyk"
+      - "Burp Suite"

package/src/modules/awc-zns-mtd/workflows/quick-flow/workflow.yaml

@@ -0,0 +1,121 @@
+# Quick Flow - AWC ZNS-MTD
+# Para bugs, hotfixes y cambios menores (< 10 min)
+
+workflow:
+  metadata:
+    name: "Quick Flow - Cambios Rápidos ZNS"
+    id: "quick-flow"
+    version: "1.0.0"
+    duration: "< 10 minutos"
+    use_case: "Bugs, hotfixes, cambios menores que no requieren diseño arquitectónico"
+    complexity: "low"
+
+  description: |
+    Workflow optimizado para cambios rápidos que mantienen estándares ZNS:
+    - Bug fixes urgentes
+    - Cambios de configuración
+    - Ajustes de UI menores
+    - Correcciones de typos/documentación
+    
+    Mantiene calidad con: spec técnica mínima + tests + code review
+
+  steps:
+    - id: "1-quick-init"
+      name: "Inicialización Rápida"
+      agent: "zen-master"
+      duration: "1 min"
+      actions:
+        - "Confirmar que el cambio es realmente 'quick' (< 10 min de implementación)"
+        - "Si es más complejo, recomendar Standard Flow o Enterprise Flow"
+        - "Verificar que no impacta arquitectura core"
+      
+      outputs:
+        - "Confirmación de scope (simple/complejo)"
+        - "Prioridad del cambio (P0-P4)"
+      
+      zen_principle: "Claridad en el scope - no subestimar complejidad"
+    
+    - id: "2-quick-spec"
+      name: "Especificación Mínima"
+      agent: "developer-pro"
+      duration: "2 min"
+      actions:
+        - "Describir el cambio en 2-3 líneas"
+        - "Identificar archivos a modificar"
+        - "Definir criterio de aceptación simple"
+        - "Identificar riesgos potenciales"
+      
+      outputs:
+        - "Quick spec (qué, dónde, criterio)"
+        - "Archivos afectados"
+        - "Riesgos identificados"
+      
+      neutro_principle: "Evaluar riesgos objetivamente, incluso en cambios pequeños"
+    
+    - id: "3-quick-implement"
+      name: "Implementación Ágil"
+      agent: "developer-pro"
+      duration: "5 min"
+      actions:
+        - "Implementar el cambio siguiendo coding standards"
+        - "Escribir test mínimo (si aplica)"
+        - "Verificar que no rompe tests existentes"
+        - "Commit con mensaje descriptivo"
+      
+      outputs:
+        - "Código implementado"
+        - "Tests actualizados/creados"
+        - "Commit descriptivo"
+      
+      sistematico_principle: "Tests y commits claros, incluso en cambios rápidos"
+    
+    - id: "4-quick-test"
+      name: "Validación Rápida"
+      agent: "qa-specialist"
+      duration: "2 min"
+      actions:
+        - "Ejecutar tests afectados"
+        - "Verificar criterio de aceptación"
+        - "Smoke test manual si es UI"
+        - "Aprobar para merge si todo OK"
+      
+      outputs:
+        - "Resultado de tests (pass/fail)"
+        - "QA sign-off"
+      
+      zen_principle: "Testing enfocado - no sobre-testing en cambios simples"
+
+  decision_gates:
+    - gate: "complexity_check"
+      after_step: "1-quick-init"
+      condition: "Si el cambio requiere > 10 min o afecta arquitectura"
+      action: "STOP - Recomendar Standard Flow o Enterprise Flow"
+    
+    - gate: "tests_pass"
+      after_step: "4-quick-test"
+      condition: "Si algún test falla"
+      action: "RETURN to step 3 - Fix implementation"
+
+  quality_gates:
+    - "Al menos 1 test de regresión (si código funcional)"
+    - "Code review rápido (< 5 min) por peer"
+    - "No introducir deuda técnica"
+    - "Commit message descriptivo"
+
+  success_criteria:
+    - "Cambio implementado en < 10 minutos"
+    - "Tests pasan"
+    - "No degradación de calidad"
+    - "Documentación inline si es necesario"
+
+  artifacts:
+    - "Quick spec (1 párrafo)"
+    - "Código modificado"
+    - "Tests actualizados"
+    - "Commit descriptivo"
+
+  anti_patterns_to_avoid:
+    - "❌ Saltarse tests porque 'es rápido'"
+    - "❌ No considerar efectos secundarios"
+    - "❌ Commits sin mensaje claro"
+    - "❌ Subestimar complejidad real"

package/src/modules/awc-zns-mtd/workflows/standard-flow/workflow.yaml

@@ -0,0 +1,181 @@
+# Standard Flow - AWC ZNS-MTD
+# Para features medias y refactorizaciones (< 30 min)
+
+workflow:
+  metadata:
+    name: "Standard Flow - Desarrollo Estándar ZNS"
+    id: "standard-flow"
+    version: "1.0.0"
+    duration: "< 30 minutos"
+    use_case: "Features medias, refactorizaciones, mejoras que requieren diseño técnico"
+    complexity: "medium"
+
+  description: |
+    Workflow balanceado para desarrollo iterativo con calidad:
+    - Features de complejidad media
+    - Refactorizaciones significativas
+    - Nuevos endpoints/componentes
+    - Mejoras de performance
+    
+    Incluye: Análisis → Planificación → Arquitectura → Implementación → Validación
+
+  phases:
+    # FASE 1: ANÁLISIS ZEN
+    - phase: "analisis"
+      steps:
+        - id: "1-analyze"
+          name: "Análisis de Requerimientos"
+          agent: "zen-master"
+          duration: "3 min"
+          actions:
+            - "Entender el problema real (no solo síntomas)"
+            - "Identificar stakeholders y restricciones"
+            - "Clarificar objetivos y criterios de éxito"
+            - "Detectar complejidad real del cambio"
+          
+          outputs:
+            - "Problema clarificado"
+            - "Objetivos SMART"
+            - "Stakeholders identificados"
+          
+          zen_principle: "Claridad en el problema antes de saltar a soluciones"
+
+    # FASE 2: PLANIFICACIÓN NEUTRAL
+    - phase: "planificacion"
+      steps:
+        - id: "2-plan"
+          name: "Planificación Técnica"
+          agent: "developer-pro"
+          duration: "5 min"
+          actions:
+            - "Crear tech spec concisa pero completa"
+            - "Identificar componentes a modificar/crear"
+            - "Definir interfaz pública (API, props, etc.)"
+            - "Estimar esfuerzo real"
+          
+          outputs:
+            - "Tech spec (500-1000 palabras)"
+            - "Componentes afectados"
+            - "Interfaces definidas"
+            - "Estimación de esfuerzo"
+          
+          neutro_principle: "Evaluación objetiva de complejidad y esfuerzo"
+
+    # FASE 3: ARQUITECTURA SISTEMÁTICA
+    - phase: "arquitectura"
+      steps:
+        - id: "3-architecture"
+          name: "Diseño de Solución"
+          agent: "architect-senior"
+          duration: "5 min"
+          actions:
+            - "Seleccionar patrones apropiados"
+            - "Diseñar estructura de datos/clases"
+            - "Identificar dependencias"
+            - "Evaluar alternativas técnicas"
+            - "Documentar decisiones (mini-ADR si aplica)"
+          
+          outputs:
+            - "Diseño de solución"
+            - "Patrones seleccionados"
+            - "Estructura de componentes"
+            - "Decisiones documentadas"
+          
+          sistematico_principle: "Diseño documentado antes de codificar"
+
+    # FASE 4: IMPLEMENTACIÓN ITERATIVA
+    - phase: "implementacion"
+      steps:
+        - id: "4-implement"
+          name: "Desarrollo con TDD"
+          agent: "developer-pro"
+          duration: "12 min"
+          actions:
+            - "Escribir tests primero (TDD) o test-after si TDD no aplica"
+            - "Implementar siguiendo diseño"
+            - "Refactorizar manteniendo tests verdes"
+            - "Commits atómicos con mensajes claros"
+          
+          outputs:
+            - "Código implementado"
+            - "Tests (unit + integration)"
+            - "Commits atómicos"
+          
+          zen_principle: "Implementación simple y directa, sin clever tricks"
+
+    # FASE 5: VALIDACIÓN Y MEJORA
+    - phase: "validacion"
+      steps:
+        - id: "5-validate"
+          name: "Validación Integral"
+          agent: "qa-specialist"
+          duration: "5 min"
+          actions:
+            - "Ejecutar suite completa de tests"
+            - "Verificar cobertura >= 80%"
+            - "Code review con checklist ZNS"
+            - "Validar criterios de aceptación"
+            - "Performance check básico"
+          
+          outputs:
+            - "Tests passing (100%)"
+            - "Cobertura >= 80%"
+            - "Code review aprobado"
+            - "QA sign-off"
+          
+          neutro_principle: "Validación objetiva con métricas medibles"
+
+  decision_gates:
+    - gate: "complexity_escalation"
+      after_step: "1-analyze"
+      condition: "Si la complejidad es alta o afecta múltiples sistemas"
+      action: "ESCALATE to Enterprise Flow"
+    
+    - gate: "design_approval"
+      after_step: "3-architecture"
+      condition: "Si hay decisiones arquitectónicas significativas"
+      action: "REVIEW with team before proceeding"
+    
+    - gate: "quality_check"
+      after_step: "5-validate"
+      condition: "Si cobertura < 80% o tests fallan"
+      action: "RETURN to step 4 - Fix implementation"
+
+  quality_gates:
+    - "Tech spec revisada y aprobada"
+    - "Cobertura de tests >= 80%"
+    - "Code review aprobado por peer senior"
+    - "Performance no degradada"
+    - "No deuda técnica introducida"
+    - "Documentación inline para lógica compleja"
+
+  success_criteria:
+    - "Feature completamente funcional"
+    - "Todos los tests pasan"
+    - "Cobertura >= 80%"
+    - "Code review aprobado"
+    - "Documentación actualizada"
+    - "Tiempo total < 30 minutos"
+
+  artifacts:
+    - "Tech spec (500-1000 palabras)"
+    - "Diseño de solución"
+    - "Mini-ADR (si hay decisiones arquitectónicas)"
+    - "Código implementado"
+    - "Tests (unit + integration)"
+    - "Commits atómicos con mensajes claros"
+    - "Code review comments/approval"
+
+  metrics_tracked:
+    - "Tiempo por fase"
+    - "Cobertura de tests"
+    - "Número de iteraciones"
+    - "Defectos encontrados en QA"
+    - "Complejidad ciclomática"
+
+  anti_patterns_to_avoid:
+    - "❌ Saltarse diseño y empezar a codificar"
+    - "❌ No escribir tests hasta el final"
+    - "❌ Commits gigantes sin atomicidad"
+    - "❌ Code review superficial"
+    - "❌ Documentación desactualizada"