awc-zns-mtd 2.0.0

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

@@ -0,0 +1,321 @@
+workflow:
+  name: "Development Flow - Implementación Iterativa"
+  id: "development-flow"
+  version: "1.0.0"
+  description: "Workflow de desarrollo siguiendo mejores prácticas de ingeniería de software"
+  
+  metadata:
+    duration: "Continuo (durante sprints)"
+    complexity: "medium-high"
+    team_size: "2-10 developers"
+  
+  phases:
+    - id: "feature-kickoff"
+      name: "Feature Kickoff"
+      
+    - id: "development"
+      name: "Development & Code"
+      
+    - id: "code-review"
+      name: "Code Review"
+      
+    - id: "integration"
+      name: "Integration & Testing"
+
+  agents:
+    primary:
+      - "tech-lead-full-stack"
+      - "senior-backend-developer"
+      - "senior-frontend-developer"
+    
+    supporting:
+      - "database-specialist"
+      - "devops-cloud-engineer"
+      - "code-reviewer"
+
+  steps:
+    - id: "dev-01"
+      name: "Selección de User Story del Sprint Backlog"
+      phase: "feature-kickoff"
+      agent: "senior-backend-developer"
+      duration: "15 minutos"
+      
+      actions:
+        - type: "select"
+          description: "Tomar siguiente historia de mayor prioridad"
+          criteria: "Historia debe estar en estado 'To Do' y cumplir Definition of Ready"
+        
+        - type: "understand"
+          description: "Leer y entender requisitos y criterios de aceptación"
+        
+        - type: "clarify"
+          description: "Si hay dudas, consultar con PO antes de comenzar"
+      
+      deliverables:
+        - "Historia asignada al developer"
+        - "Historia movida a 'In Progress'"
+
+    - id: "dev-02"
+      name: "Diseño Técnico (para features complejas)"
+      phase: "feature-kickoff"
+      agent: "tech-lead-full-stack"
+      duration: "30-60 minutos"
+      when: "Historias >8 story points o con alta complejidad técnica"
+      
+      actions:
+        - type: "design"
+          description: "Diseñar solución técnica"
+          output:
+            - "Diagrama de secuencia (si aplica)"
+            - "Decisión de patrón de diseño a usar"
+            - "Identificar interfaces/contratos"
+        
+        - type: "review"
+          description: "Quick review con Tech Lead (15 min)"
+      
+      deliverables:
+        - "Mini tech spec o diagrama en whiteboard"
+
+    - id: "dev-03"
+      name: "Desarrollo TDD (Test-Driven Development)"
+      phase: "development"
+      agent: "senior-backend-developer"
+      duration: "Variable según complejidad"
+      
+      actions:
+        - type: "test"
+          description: "Escribir test que falla (Red)"
+          approach: "Test unitario que valida el comportamiento esperado"
+        
+        - type: "code"
+          description: "Escribir código mínimo para pasar test (Green)"
+        
+        - type: "refactor"
+          description: "Refactorizar manteniendo tests en verde (Refactor)"
+        
+        - type: "commit"
+          description: "Commit frecuentes con mensajes descriptivos"
+          format: "type(scope): message"
+          examples:
+            - "feat(auth): add Google OAuth login"
+            - "fix(payment): handle null pointer in calculateTotal"
+            - "refactor(user): extract validation to separate service"
+      
+      best_practices:
+        - "Commits pequeños y frecuentes (cada 1-2 horas)"
+        - "Tests primero, código después"
+        - "Cobertura >80% en código nuevo"
+        - "Seguir SOLID principles"
+
+    - id: "dev-04"
+      name: "Code Quality Checks"
+      phase: "development"
+      agent: "senior-backend-developer"
+      duration: "Continuo"
+      
+      actions:
+        - type: "lint"
+          description: "Ejecutar linter antes de commit"
+          tools:
+            - "ESLint (JavaScript/TypeScript)"
+            - "Checkstyle/PMD (Java)"
+            - "Pylint/Black (Python)"
+        
+        - type: "format"
+          description: "Auto-formatear código"
+          tools:
+            - "Prettier"
+            - "Black (Python)"
+            - "google-java-format"
+        
+        - type: "analyze"
+          description: "Ejecutar análisis estático local"
+          tools:
+            - "SonarLint"
+            - "SpotBugs"
+
+    - id: "dev-05"
+      name: "Create Pull Request"
+      phase: "code-review"
+      agent: "senior-backend-developer"
+      duration: "30 minutos"
+      
+      actions:
+        - type: "prepare"
+          description: "Preparar PR para revisión"
+          checklist:
+            - "[ ] Todos los tests pasan"
+            - "[ ] Cobertura >80%"
+            - "[ ] No hay conflictos con main/develop"
+            - "[ ] Código formateado"
+            - "[ ] No hay warnings del linter"
+        
+        - type: "document"
+          description: "Escribir descripción completa del PR"
+          template: |
+            ## Qué hace este PR
+            {Descripción de la funcionalidad}
+            
+            ## User Story / Jira Ticket
+            Closes #{issue_number}
+            
+            ## Cómo probarlo
+            1. {Paso 1}
+            2. {Paso 2}
+            
+            ## Screenshots (si aplica)
+            {Imágenes}
+            
+            ## Checklist
+            - [ ] Tests agregados
+            - [ ] Documentación actualizada
+        
+        - type: "request"
+          description: "Solicitar revisión de 2+ reviewers"
+      
+      deliverables:
+        - "Pull Request creado"
+        - "Reviewers asignados"
+
+    - id: "dev-06"
+      name: "Code Review Process"
+      phase: "code-review"
+      agent: "code-reviewer"
+      duration: "1-2 horas"
+      
+      actions:
+        - type: "review"
+          description: "Revisar código línea por línea"
+          focus:
+            - "Correctness: ¿El código hace lo que debe?"
+            - "Readability: ¿Es fácil de entender?"
+            - "Maintainability: ¿Es fácil de modificar?"
+            - "Performance: ¿Hay problemas evidentes?"
+            - "Security: ¿Hay vulnerabilidades?"
+        
+        - type: "comment"
+          description: "Dejar comentarios constructivos"
+          types:
+            - "💡 Suggestion (opcional)"
+            - "❓ Question (requiere respuesta)"
+            - "🚨 Must fix (bloqueante)"
+        
+        - type: "approve"
+          description: "Aprobar o solicitar cambios"
+          criteria: "Mínimo 2 aprobaciones antes de merge"
+      
+      best_practices:
+        - "Review en <24 horas"
+        - "Comentarios constructivos, no destructivos"
+        - "Aprobar si cambios menores pendientes (nits)"
+
+    - id: "dev-07"
+      name: "Address Review Comments"
+      phase: "code-review"
+      agent: "senior-backend-developer"
+      duration: "1-4 horas"
+      
+      actions:
+        - type: "resolve"
+          description: "Resolver comentarios del review"
+        
+        - type: "update"
+          description: "Pushear cambios al PR"
+        
+        - type: "discuss"
+          description: "Si hay desacuerdo, discutir con revisor"
+
+    - id: "dev-08"
+      name: "Merge to Main/Develop"
+      phase: "integration"
+      agent: "tech-lead-full-stack"
+      duration: "15 minutos"
+      
+      actions:
+        - type: "validate"
+          description: "Validar que CI/CD pipeline pasó"
+          checks:
+            - "✅ Build successful"
+            - "✅ All tests pass"
+            - "✅ Code coverage >80%"
+            - "✅ No security vulnerabilities"
+        
+        - type: "merge"
+          description: "Merge PR usando estrategia acordada"
+          strategies:
+            - "Squash and merge (preferido para features)"
+            - "Merge commit (para releases)"
+            - "Rebase and merge (para mantener historia lineal)"
+        
+        - type: "cleanup"
+          description: "Borrar branch feature después de merge"
+      
+      deliverables:
+        - "Código integrado en main/develop"
+        - "Branch feature eliminada"
+
+    - id: "dev-09"
+      name: "Deploy to Dev/Staging"
+      phase: "integration"
+      agent: "devops-cloud-engineer"
+      duration: "Automático (CI/CD)"
+      
+      actions:
+        - type: "trigger"
+          description: "CI/CD pipeline se ejecuta automáticamente al merge"
+        
+        - type: "deploy"
+          description: "Deploy automático a ambiente de desarrollo"
+        
+        - type: "verify"
+          description: "Smoke tests automáticos post-deployment"
+      
+      deliverables:
+        - "Feature desplegada en dev/staging"
+
+  deliverables:
+    - "Código funcional y testeado"
+    - "Tests automatizados (>80% cobertura)"
+    - "Pull Request mergeado"
+    - "Feature desplegada en dev/staging"
+    - "Documentación actualizada (si aplica)"
+
+  metrics:
+    - name: "Code Review Time"
+      target: "< 24 horas"
+    
+    - name: "PR Size"
+      target: "< 400 líneas de código"
+      note: "PRs grandes son difíciles de revisar"
+    
+    - name: "Code Coverage"
+      target: "> 80%"
+    
+    - name: "Technical Debt Ratio"
+      target: "< 5%"
+
+  best_practices:
+    - "Feature branches, no commits directos a main"
+    - "PR pequeños (<400 líneas) para facilitar review"
+    - "TDD: tests primero, código después"
+    - "Commits frecuentes con mensajes descriptivos"
+    - "Code review obligatorio (mínimo 2 aprobaciones)"
+    - "Automatizar todo lo que se pueda (CI/CD)"
+    - "Documentar decisiones técnicas complejas"
+
+  tools:
+    version_control:
+      - "Git"
+      - "GitHub / GitLab / Bitbucket"
+    
+    ci_cd:
+      - "GitHub Actions"
+      - "GitLab CI"
+      - "Jenkins"
+      - "CircleCI"
+    
+    quality:
+      - "SonarQube"
+      - "ESLint"
+      - "Prettier"
+      - "Jest / JUnit / PyTest"

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

@@ -0,0 +1,276 @@
+# Enterprise Flow - AWC ZNS-MTD
+# Para sistemas complejos y arquitecturas empresariales (< 2 horas)
+
+workflow:
+  metadata:
+    name: "Enterprise Flow - Transformación Digital ZNS"
+    id: "enterprise-flow"
+    version: "1.0.0"
+    duration: "< 2 horas"
+    use_case: "Proyectos complejos, arquitecturas empresariales, múltiples stakeholders, compliance"
+    complexity: "high"
+
+  description: |
+    Workflow completo para iniciativas empresariales complejas:
+    - Nuevos sistemas/plataformas
+    - Migraciones arquitectónicas
+    - Proyectos multi-equipo
+    - Requisitos de compliance/governance
+    
+    Incluye: Discovery → Requirements → Solution Design → Implementation Plan → Development → QA → Deploy Strategy
+
+  phases:
+    # FASE 1: DISCOVERY (Descubrimiento Profundo)
+    - phase: "discovery"
+      steps:
+        - id: "1-discovery"
+          name: "Descubrimiento Estratégico"
+          agent: "zen-master"
+          duration: "15 min"
+          actions:
+            - "Entrevista con stakeholders clave"
+            - "Mapeo de procesos de negocio actuales"
+            - "Identificación de pain points y oportunidades"
+            - "Análisis de restricciones (técnicas, presupuesto, tiempo, compliance)"
+            - "Definición de visión y objetivos estratégicos"
+          
+          outputs:
+            - "Stakeholder map"
+            - "Current state analysis"
+            - "Pain points prioritizados"
+            - "Visión del proyecto"
+            - "Restricciones documentadas"
+          
+          zen_principle: "Entendimiento profundo antes de proponer soluciones"
+
+    # FASE 2: REQUIREMENTS (Requerimientos Completos)
+    - phase: "requirements"
+      steps:
+        - id: "2-requirements"
+          name: "Análisis de Requerimientos"
+          agent: "architect-senior"
+          duration: "20 min"
+          actions:
+            - "Crear PRD (Product Requirements Document) completo"
+            - "Definir requerimientos funcionales detallados"
+            - "Especificar requerimientos no funcionales (performance, seguridad, escalabilidad)"
+            - "Identificar dependencias externas"
+            - "Crear user stories con criterios de aceptación"
+            - "Priorización MoSCoW (Must, Should, Could, Won't)"
+          
+          outputs:
+            - "PRD completo (2000-5000 palabras)"
+            - "Requerimientos funcionales"
+            - "Requerimientos no funcionales"
+            - "User stories con ACs"
+            - "Backlog priorizado"
+          
+          sistematico_principle: "Documentación exhaustiva de requerimientos"
+
+    # FASE 3: SOLUTION DESIGN (Diseño de Solución)
+    - phase: "solution_design"
+      steps:
+        - id: "3-solution-design"
+          name: "Arquitectura de Solución"
+          agent: "architect-senior"
+          duration: "25 min"
+          actions:
+            - "Diseñar arquitectura de alto nivel (C4 Context + Container)"
+            - "Seleccionar stack tecnológico con justificación"
+            - "Diseñar patrones de integración"
+            - "Definir estrategia de datos"
+            - "Diseñar seguridad y autenticación/autorización"
+            - "Planificar escalabilidad y alta disponibilidad"
+            - "Crear ADRs para decisiones críticas"
+          
+          outputs:
+            - "Architecture design document"
+            - "C4 diagrams (Context, Container, Component)"
+            - "Tech stack seleccionado con justificación"
+            - "ADRs para decisiones clave"
+            - "Security architecture"
+            - "Data architecture"
+          
+          neutro_principle: "Evaluación objetiva de alternativas tecnológicas"
+
+    # FASE 4: IMPLEMENTATION PLAN (Plan de Implementación)
+    - phase: "implementation_plan"
+      steps:
+        - id: "4-implementation-plan"
+          name: "Planificación de Ejecución"
+          agent: "zen-master"
+          duration: "15 min"
+          actions:
+            - "Desglosar en fases/sprints"
+            - "Identificar MVP y funcionalidades incrementales"
+            - "Asignar responsabilidades"
+            - "Definir milestones y deliverables"
+            - "Crear roadmap temporal"
+            - "Identificar riesgos y plan de mitigación"
+          
+          outputs:
+            - "Implementation roadmap"
+            - "MVP definition"
+            - "Sprint plan (primeras 2-3 iteraciones)"
+            - "Risk register con mitigaciones"
+            - "Team assignments"
+          
+          zen_principle: "Planificación clara con enfoque en valor incremental"
+
+    # FASE 5: DEVELOPMENT (Desarrollo Iterativo)
+    - phase: "development"
+      steps:
+        - id: "5-develop"
+          name: "Desarrollo Incremental"
+          agent: "developer-pro"
+          duration: "30 min (primera iteración)"
+          actions:
+            - "Setup de proyecto (repo, CI/CD, tooling)"
+            - "Implementar infraestructura base"
+            - "Desarrollar componentes core (TDD)"
+            - "Integración continua"
+            - "Code reviews sistemáticos"
+            - "Refactoring continuo"
+          
+          outputs:
+            - "Código base funcional"
+            - "Tests automatizados"
+            - "CI/CD pipeline configurado"
+            - "Documentación técnica"
+          
+          sistematico_principle: "Desarrollo disciplinado con tests y reviews"
+
+    # FASE 6: QA & VALIDATION (Aseguramiento de Calidad)
+    - phase: "qa_validation"
+      steps:
+        - id: "6-qa"
+          name: "QA Integral"
+          agent: "qa-specialist"
+          duration: "15 min"
+          actions:
+            - "Testing funcional completo"
+            - "Testing no funcional (performance, security, accessibility)"
+            - "Auditoría de código"
+            - "Validación de compliance"
+            - "UAT (User Acceptance Testing)"
+            - "Bug tracking y resolución"
+          
+          outputs:
+            - "Test results report"
+            - "Performance benchmarks"
+            - "Security audit report"
+            - "QA sign-off"
+            - "UAT feedback"
+          
+          neutro_principle: "Validación objetiva con métricas medibles"
+
+    # FASE 7: DEPLOY STRATEGY (Estrategia de Despliegue)
+    - phase: "deploy_strategy"
+      steps:
+        - id: "7-deploy-strategy"
+          name: "Planificación de Despliegue"
+          agent: "architect-senior"
+          duration: "10 min"
+          actions:
+            - "Definir estrategia de despliegue (blue/green, canary, etc.)"
+            - "Crear runbook de deployment"
+            - "Planificar rollback strategy"
+            - "Configurar monitoring y alertas"
+            - "Crear post-deployment checklist"
+            - "Documentar operational procedures"
+          
+          outputs:
+            - "Deployment strategy document"
+            - "Runbook"
+            - "Rollback plan"
+            - "Monitoring dashboard"
+            - "Operational docs"
+          
+          sistematico_principle: "Despliegue planificado con contingencias"
+
+  decision_gates:
+    - gate: "stakeholder_alignment"
+      after_step: "1-discovery"
+      condition: "Si hay desalineación en visión/objetivos"
+      action: "PAUSE - Resolver desalineación antes de continuar"
+    
+    - gate: "requirements_approval"
+      after_step: "2-requirements"
+      condition: "PRD debe ser aprobado por stakeholders"
+      action: "REVIEW & APPROVE before proceeding"
+    
+    - gate: "architecture_review"
+      after_step: "3-solution-design"
+      condition: "Arquitectura debe pasar review de equipo senior"
+      action: "ARCHITECTURE REVIEW BOARD approval required"
+    
+    - gate: "mvp_validation"
+      after_step: "4-implementation-plan"
+      condition: "MVP debe ser validado con usuarios/stakeholders"
+      action: "VALIDATE MVP definition before development"
+    
+    - gate: "quality_gates"
+      after_step: "6-qa"
+      condition: "Todos los quality gates deben pasar"
+      action: "NO DEPLOYMENT until all gates pass"
+
+  quality_gates_enterprise:
+    - "PRD aprobado por product owner"
+    - "Arquitectura revisada por architecture board"
+    - "Security review aprobado"
+    - "Compliance requirements verificados"
+    - "Performance benchmarks cumplidos"
+    - "Cobertura de tests >= 85%"
+    - "Code review aprobado por 2+ seniors"
+    - "UAT aprobado por usuarios clave"
+    - "Documentación completa y actualizada"
+    - "Runbook de deployment validado"
+
+  success_criteria:
+    - "Stakeholders alineados en visión"
+    - "Requerimientos documentados y aprobados"
+    - "Arquitectura sólida y escalable"
+    - "MVP funcional entregado"
+    - "Calidad empresarial (tests, docs, security)"
+    - "Despliegue planificado con contingencias"
+    - "Equipo capacitado en el sistema"
+
+  artifacts:
+    - "Stakeholder map y meeting notes"
+    - "PRD completo (2000-5000 palabras)"
+    - "Architecture design document"
+    - "C4 diagrams (Context, Container, Component, Code)"
+    - "ADRs para decisiones arquitectónicas"
+    - "Tech stack justification"
+    - "Implementation roadmap"
+    - "Risk register"
+    - "Código fuente con tests"
+    - "CI/CD pipeline"
+    - "Test reports (functional, performance, security)"
+    - "Deployment runbook"
+    - "Operational documentation"
+
+  metrics_tracked:
+    - "Tiempo por fase"
+    - "Velocity (story points por sprint)"
+    - "Cobertura de tests"
+    - "Defect density"
+    - "Performance benchmarks"
+    - "Security vulnerabilities"
+    - "Technical debt ratio"
+    - "Stakeholder satisfaction"
+
+  governance:
+    - "Weekly status reports"
+    - "Bi-weekly sprint reviews"
+    - "Monthly steering committee"
+    - "Architecture review board (para decisiones críticas)"
+    - "Change control board (para cambios de scope)"
+
+  anti_patterns_to_avoid:
+    - "❌ Saltarse discovery y empezar a codificar"
+    - "❌ PRD incompleto o ambiguo"
+    - "❌ Arquitectura no revisada por pares"
+    - "❌ Despliegue sin plan de rollback"
+    - "❌ Documentación desactualizada"
+    - "❌ No involucrar stakeholders hasta el final"