awc-zns-mtd 2.0.0

package/src/modules/custom-agents/config.yaml

@@ -0,0 +1,478 @@
+module:
+  metadata:
+    name: "Custom Agents Module"
+    id: "custom-agents"
+    version: "1.0.0"
+    description: "Agentes especializados personalizados del equipo"
+    author: "AWC Team"
+    
+  philosophy:
+    zen:
+      description: "Claridad técnica, código limpio, enfoque en valor"
+      practices:
+        - "Componentes reutilizables y testeables"
+        - "Arquitectura modular escalable"
+        - "Simplicidad deliberada sobre complejidad accidental"
+    
+    neutro:
+      description: "Decisiones basadas en métricas y evidencia"
+      practices:
+        - "Performance medido (Core Web Vitals, Lighthouse)"
+        - "Calidad cuantificada (coverage, complexity, duplication)"
+        - "Security validado (npm audit, CSP headers)"
+    
+    sistematico:
+      description: "Procesos repetibles, documentación sincronizada"
+      practices:
+        - "Testing coverage >80%"
+        - "TypeScript strict mode"
+        - "Definition of Done checklist"
+        - "Code review obligatorio"
+
+  agents:
+    # ========================================
+    # FRONTEND DEVELOPMENT (2 agentes)
+    # ========================================
+    - id: "frontend-react-senior"
+      file: "agents/frontend-react-senior.agent.yaml"
+      category: "development"
+      subcategory: "frontend"
+      stack: ["React 18+", "Next.js 14+", "TypeScript 5+", "Tailwind CSS"]
+      whenToUse: "Desarrollo frontend web, optimización performance, accesibilidad, SEO"
+      workflows: 14
+      
+    - id: "react-native-senior"
+      file: "agents/react-native-senior.agent.yaml"
+      category: "development"
+      subcategory: "mobile"
+      stack: ["React Native", "Expo", "TypeScript", "Hermes", "Zustand"]
+      whenToUse: "Desarrollo mobile iOS/Android, Clean Architecture, DDD, TDD"
+      workflows: 6
+      
+    # ========================================
+    # BACKEND DEVELOPMENT (4 agentes)
+    # ========================================
+    - id: "backend-java-senior"
+      file: "agents/backend-java-senior.agent.yaml"
+      category: "development"
+      subcategory: "backend"
+      stack: ["Java 21 LTS", "Spring Boot 3.4", "PostgreSQL 16", "Kafka"]
+      whenToUse: "Desarrollo backend Java, arquitectura hexagonal, DDD, TDD, microservices"
+      workflows: 17
+      
+    - id: "python-senior"
+      file: "agents/python-senior.agent.yaml"
+      category: "development"
+      subcategory: "backend"
+      stack: ["Python 3.11+", "Django 4.2+", "FastAPI", "Pydantic"]
+      whenToUse: "Desarrollo backend Python, APIs REST, async, data processing"
+      workflows: 11
+      
+    - id: "dotnet-core-senior"
+      file: "agents/dotnet-core-senior.agent.yaml"
+      category: "development"
+      subcategory: "backend"
+      stack: [".NET 6/8", "ASP.NET Core", "MediatR", "EF Core"]
+      whenToUse: "Desarrollo .NET, Clean Architecture, CQRS, microservices"
+      workflows: 11
+      
+    - id: "php-senior"
+      file: "agents/php-senior.agent.yaml"
+      category: "development"
+      subcategory: "backend"
+      stack: ["PHP 8.2+", "Laravel 10+", "Symfony 6+", "PHPStan L9"]
+      whenToUse: "Desarrollo PHP, hexagonal architecture, strict types, testing"
+      workflows: 10
+      
+    # ========================================
+    # INFRASTRUCTURE & DEVOPS (2 agentes)
+    # ========================================
+    - id: "devsecops-onpremise-senior"
+      file: "agents/devsecops-onpremise-senior.agent.yaml"
+      category: "infrastructure"
+      subcategory: "devops"
+      stack: ["K3s/K8s", "Jenkins", "ArgoCD", "Trivy", "Prometheus"]
+      whenToUse: "DevSecOps on-premise, K3s clusters, GitOps, security automation"
+      workflows: 12
+      
+    - id: "database-engineer-senior"
+      file: "agents/database-engineer-senior.agent.yaml"
+      category: "infrastructure"
+      subcategory: "database"
+      stack: ["PostgreSQL 16", "DDD Data Modeling", "Flyway"]
+      whenToUse: "Diseño de bases de datos, migraciones, performance tuning, DDD modeling"
+      workflows: 10
+      
+    # ========================================
+    # ARCHITECTURE & DESIGN (4 agentes)
+    # ========================================
+    - id: "solution-architect-senior"
+      file: "agents/solution-architect-senior.agent.yaml"
+      category: "architecture"
+      subcategory: "solution-architect"
+      stack: ["PlantUML C4", "AWS/Azure/GCP", "Terraform", "ADRs"]
+      whenToUse: "Arquitectura de soluciones, ADRs, diagramas C4, estimación TCO"
+      workflows: 5
+      
+    - id: "aspnet-core-architect-senior"
+      file: "agents/aspnet-core-architect-senior.agent.yaml"
+      category: "architecture"
+      subcategory: "dotnet-architect"
+      stack: [".NET 6/8", "ASP.NET Core", "MassTransit", "Azure"]
+      whenToUse: "Arquitectura .NET, hexagonal, DDD, CQRS, microservices, event-driven"
+      workflows: 11
+      
+    - id: "c4-diagram-specialist"
+      file: "agents/c4-diagram-specialist.agent.yaml"
+      category: "architecture"
+      subcategory: "documentation"
+      stack: ["PlantUML", "C4 Model", "Graphviz", "Draw.io"]
+      whenToUse: "Diagramas de arquitectura C4, documentación visual, context mapping DDD"
+      workflows: 11
+      
+    - id: "technical-stories-architect"
+      file: "agents/technical-stories-architect.agent.yaml"
+      category: "architecture"
+      subcategory: "technical-design"
+      stack: ["DDD", "Hexagonal Architecture", "TDD", "OpenAPI", "SQL"]
+      whenToUse: "Descomponer épicas en HUTs, DDD strategic/tactical, hexagonal, TDD design"
+      workflows: 7
+      
+    # ========================================
+    # QUALITY & AUDIT (3 agentes)
+    # ========================================
+    - id: "frontend-audit-master"
+      file: "agents/frontend-audit-master.agent.yaml"
+      category: "quality"
+      subcategory: "audit"
+      stack: ["Lighthouse CI", "axe DevTools", "WAVE", "npm audit", "ESLint"]
+      whenToUse: "Auditoría frontend completa, scoring /100, performance, a11y, security"
+      workflows: 6
+      
+    - id: "backend-audit-master"
+      file: "agents/backend-audit-master.agent.yaml"
+      category: "quality"
+      subcategory: "audit"
+      stack: ["OWASP Top 10", "SonarQube", "JaCoCo", "ArchUnit", "Trivy"]
+      whenToUse: "Auditoría backend completa, scoring A-F, arquitectura, security, obsolescence"
+      workflows: 7
+      
+    - id: "validation-quality-master"
+      file: "agents/validation-quality-master.agent.yaml"
+      category: "quality"
+      subcategory: "validation"
+      stack: ["ISO 25010", "IEEE 830", "TOGAF", "C4 Model"]
+      whenToUse: "Validación de calidad: completitud, consistencia, corrección, claridad, trazabilidad"
+      workflows: 7
+      
+    # ========================================
+    # BUSINESS & PRODUCT (1 agente)
+    # ========================================
+    - id: "product-owner-business-analyst"
+      file: "agents/product-owner-business-analyst.agent.yaml"
+      category: "business"
+      subcategory: "product-management"
+      stack: ["INVEST", "Gherkin BDD", "User Story Mapping", "MoSCoW"]
+      whenToUse: "Historias de usuario INVEST, backlog management, criterios aceptación Gherkin"
+      workflows: 10
+      
+    # ========================================
+    # COST & ESTIMATION (1 agente)
+    # ========================================
+    - id: "cost-estimator-senior"
+      file: "agents/cost-estimator-senior.agent.yaml"
+      category: "business"
+      subcategory: "estimation"
+      stack: ["Story Points", "TCO", "FinOps", "ROI/NPV/IRR"]
+      whenToUse: "Estimación de costos (story→horas→$), TCO cloud 3 años, ROI analysis"
+      workflows: 5
+      
+    # ========================================
+    # PROMPT ENGINEERING (2 agentes)
+    # ========================================
+    - id: "prompt-engineer-senior"
+      file: "agents/prompt-engineer-senior.agent.yaml"
+      category: "ai"
+      subcategory: "prompt-engineering"
+      stack: ["Chain-of-Thought", "Tree-of-Thought", "ReAct", "Few-Shot"]
+      whenToUse: "Crear, analizar, optimizar prompts; técnicas avanzadas (CoT, ToT, ReAct)"
+      workflows: 5
+      
+    - id: "prompt-architect-senior"
+      file: "agents/prompt-architect-senior.agent.yaml"
+      category: "ai"
+      subcategory: "prompt-architecture"
+      stack: ["Multi-agent systems", "Workflow orchestration", "ISO/IEC 23053"]
+      whenToUse: "Arquitectura de prompts, multi-agent systems, diseño de workflows complejos"
+      workflows: 4
+      
+    # ========================================
+    # DOCUMENTATION & ANALYSIS (3 agentes)
+    # ========================================
+    - id: "consolidation-context-master"
+      file: "agents/consolidation-context-master.agent.yaml"
+      category: "documentation"
+      subcategory: "consolidation"
+      stack: ["PDF parsing", "OCR", "NLP", "Markdown generation"]
+      whenToUse: "Consolidar contexto de proyecto desde múltiples fuentes (PDFs, Word, código)"
+      workflows: 7
+      
+    - id: "document-export-specialist"
+      file: "agents/document-export-specialist.agent.yaml"
+      category: "documentation"
+      subcategory: "export"
+      stack: ["pandoc", "python-docx", "PlantUML CLI", "Word .docx"]
+      whenToUse: "Exportar documentación Markdown→Word con formato profesional"
+      workflows: 8
+      
+    - id: "obsolescence-analyst-senior"
+      file: "agents/obsolescence-analyst-senior.agent.yaml"
+      category: "analysis"
+      subcategory: "obsolescence"
+      stack: ["NVD NIST", "CVE database", "EOL tracking", "Risk matrix"]
+      whenToUse: "Análisis de obsolescencia tecnológica, CVEs, EOL, plan de modernización"
+      workflows: 7
+      
+  quality_standards:
+    code_coverage: ">80%"
+    technical_debt: "<5%"
+    code_review: "mandatory"
+    documentation: "synchronized"
+    
+  workflows:
+    total: 191
+    available:
+      # Frontend React (14)
+      - "create-react-component"
+      - "create-nextjs-page"
+      - "integrate-api"
+      - "build-form"
+      - "optimize-performance"
+      - "fix-accessibility"
+      - "setup-seo"
+      - "create-testing-suite"
+      - "security-audit"
+      - "setup-state-management"
+      - "setup-ui-library"
+      - "review-architecture"
+      - "generate-quality-report"
+      - "migrate-react-19"
+      
+      # React Native (6)
+      - "setup-rn-project"
+      - "create-bounded-context"
+      - "create-aggregate"
+      - "create-use-case"
+      - "run-tests"
+      - "audit-architecture"
+      
+      # Backend Java (17)
+      - "implement-hut"
+      - "create-aggregate-ddd"
+      - "create-use-case-application"
+      - "create-repository-jpa"
+      - "create-rest-controller-post"
+      - "tdd-cycle"
+      - "outside-in-tdd"
+      - "create-domain-event"
+      - "kafka-integration"
+      - "security-oauth2"
+      - "database-migration-flyway"
+      - "architecture-test-archunit"
+      - "integration-test-testcontainers"
+      - "mutation-testing-pit"
+      - "sonarqube-analysis"
+      - "refactor-hexagonal"
+      - "performance-optimization-java"
+      
+      # Python (11)
+      - "create-python-project"
+      - "create-api-endpoint-fastapi"
+      - "create-domain-model-dataclass"
+      - "async-service"
+      - "celery-task"
+      - "pytest-suite"
+      - "poetry-dependencies"
+      - "mypy-type-check"
+      - "black-format"
+      - "ruff-lint"
+      - "hexagonal-refactor-python"
+      
+      # .NET Core (11)
+      - "create-dotnet-solution"
+      - "cqrs-command-mediatr"
+      - "cqrs-query-mediatr"
+      - "ef-migration"
+      - "mediatr-handler"
+      - "integration-test-dotnet"
+      - "clean-architecture-setup"
+      - "fluent-validation"
+      - "automapper-config"
+      - "unit-test-xunit"
+      - "repository-pattern"
+      
+      # PHP (10)
+      - "create-php-project-composer"
+      - "domain-entity-value-objects"
+      - "api-resource-laravel"
+      - "service-contract-interface"
+      - "phpstan-analysis-level9"
+      - "pest-tests"
+      - "phpunit-coverage"
+      - "doctrine-orm-mapping"
+      - "hexagonal-php"
+      - "strict-types-enforce"
+      
+      # DevSecOps (12)
+      - "k3s-cluster-setup"
+      - "jenkins-pipeline-cicd"
+      - "security-scan-trivy"
+      - "gitops-deployment-argocd"
+      - "backup-strategy-k8s"
+      - "monitoring-prometheus"
+      - "logging-elk-stack"
+      - "secrets-vault-hashicorp"
+      - "disaster-recovery-plan"
+      - "infrastructure-as-code-terraform"
+      - "container-registry-setup"
+      - "helm-chart-deployment"
+      
+      # Database (10)
+      - "create-table-ddd-conventions"
+      - "migration-script-flyway"
+      - "performance-audit-explain"
+      - "data-model-review-ddd"
+      - "index-optimization"
+      - "query-tuning"
+      - "partition-strategy"
+      - "replication-setup"
+      - "backup-restore-automation"
+      - "schema-versioning"
+      
+      # Solution Architect (5)
+      - "design-architecture-c4"
+      - "create-adr"
+      - "create-c4-diagram-plantuml"
+      - "estimate-costs-tco"
+      - "generate-architecture-document"
+      
+      # ASP.NET Architect (11)
+      - "create-microservice-architecture"
+      - "create-aggregate-csharp"
+      - "cqrs-command-architecture"
+      - "event-driven-integration-masstransit"
+      - "azure-service-bus-setup"
+      - "api-gateway-design"
+      - "saga-pattern-orchestration"
+      - "distributed-cache-redis"
+      - "monitoring-application-insights"
+      - "security-identity-server"
+      - "container-orchestration-k8s"
+      
+      # C4 Diagram (11)
+      - "c4-context-diagram-level1"
+      - "c4-container-diagram-level2"
+      - "c4-component-diagram-level3"
+      - "c4-code-diagram-level4"
+      - "context-map-ddd-strategic"
+      - "deployment-diagram"
+      - "sequence-diagram"
+      - "dynamic-diagram"
+      - "plantuml-generation"
+      - "diagram-versioning-git"
+      - "export-diagrams-png-svg"
+      
+      # Technical Stories (7)
+      - "full-technical-decomposition"
+      - "strategic-ddd-analysis-bounded-contexts"
+      - "tactical-ddd-modeling-aggregates"
+      - "hexagonal-design-ports-adapters"
+      - "tdd-design-red-green-refactor"
+      - "technical-specifications-openapi"
+      - "generate-huts-from-epics"
+      
+      # Frontend Audit (6)
+      - "full-audit-frontend"
+      - "audit-performance-lighthouse"
+      - "audit-accessibility-wcag"
+      - "audit-security-frontend"
+      - "audit-testing-coverage"
+      - "audit-seo-metadata"
+      
+      # Backend Audit (7)
+      - "full-audit-backend"
+      - "audit-architecture-hexagonal"
+      - "audit-security-owasp"
+      - "audit-obsolescence-tech-stack"
+      - "audit-performance-backend"
+      - "audit-testing-backend"
+      - "audit-code-quality-sonarqube"
+      
+      # Validation Quality (7)
+      - "full-validation-quality"
+      - "validate-completeness"
+      - "validate-consistency"
+      - "validate-correctness"
+      - "validate-clarity"
+      - "validate-traceability"
+      - "generate-validation-report"
+      
+      # Product Owner (10)
+      - "create-user-story-invest"
+      - "gherkin-scenario-bdd"
+      - "backlog-generation-prioritized"
+      - "acceptance-criteria-measurable"
+      - "story-mapping-workflow"
+      - "epic-decomposition"
+      - "moscow-prioritization"
+      - "story-points-fibonacci"
+      - "sprint-planning"
+      - "refinement-session"
+      
+      # Cost Estimator (5)
+      - "estimate-project-full"
+      - "estimate-epic-stories"
+      - "estimate-story-hours-cost"
+      - "estimate-cloud-tco-3years"
+      - "calculate-roi-npv-irr"
+      
+      # Prompt Engineer (5)
+      - "create-prompt-structured"
+      - "analyze-prompt-quality"
+      - "optimize-prompt-performance"
+      - "test-prompt-validation"
+      - "validate-structure-prompt"
+      
+      # Prompt Architect (4)
+      - "architect-prompt-multi-agent"
+      - "design-agent-persona"
+      - "design-workflow-orchestration"
+      - "validate-compliance-standards"
+      
+      # Consolidation Context (7)
+      - "full-consolidation-context"
+      - "analyze-documentation-sources"
+      - "extract-business-context"
+      - "extract-functional-requirements"
+      - "extract-non-functional-requirements"
+      - "reconcile-contradictions"
+      - "generate-consolidated-files"
+      
+      # Document Export (8)
+      - "full-export-documentation"
+      - "prepare-diagrams-plantuml"
+      - "convert-markdown-to-word"
+      - "apply-professional-format"
+      - "validate-export-quality"
+      - "export-executive-summary"
+      - "export-architecture-document"
+      - "export-api-specification"
+      
+      # Obsolescence Analyst (7)
+      - "full-obsolescence-analysis"
+      - "inventory-tech-stack"
+      - "analyze-architecture-patterns"
+      - "inventory-endpoints-apis"
+      - "identify-vulnerabilities-cves"
+      - "generate-risk-matrix"
+      - "create-modernization-plan"

package/templates/.github/copilot-instructions.md

@@ -0,0 +1,120 @@
+# GitHub Copilot - Instrucciones del Proyecto
+
+Este proyecto utiliza la **metodología AWC ZNS-MTD** (Zen-Neutro-Sistemático Method for Digital Transformation).
+
+## 🧘 Filosofía ZNS
+
+Sigue estos principios en todas las interacciones:
+
+- **ZEN**: Claridad, simplicidad deliberada, sin ruido. Enfócate en el problema real, no en síntomas.
+- **NEUTRO**: Objetividad técnica basada en evidencia. Decisiones fundamentadas en datos y métricas.
+- **SISTEMÁTICO**: Procesos repetibles, documentación rigurosa, trazabilidad completa.
+
+## 📁 Estructura del Proyecto
+
+```
+.awc/
+├── agents/              # Agentes especializados YAML
+│   ├── zen-master.agent.yaml       # Orquestador principal
+│   ├── architect-senior.agent.yaml # Diseñador de soluciones
+│   ├── developer-pro.agent.yaml    # Experto en implementación
+│   └── qa-specialist.agent.yaml    # Especialista en calidad
+├── workflows/           # Workflows declarativos
+│   ├── quick-flow/     # <10 min: bugs, hotfixes
+│   ├── standard-flow/  # <30 min: features, refactoring
+│   └── enterprise-flow/ # <2 hrs: sistemas complejos
+└── config.yaml         # Configuración del método
+```
+
+## 🎯 Agentes Disponibles
+
+### ZEN MASTER (Orquestador)
+**Cuándo usar**: Coordinación estratégica, toma de decisiones, análisis de complejidad.
+**Archivo**: `.awc/agents/zen-master.agent.yaml`
+**Comandos clave**: *zns-quick-flow, *zns-standard-flow, *zns-enterprise-flow
+
+### ARCHITECT SENIOR (Diseñador)
+**Cuándo usar**: Diseño de arquitectura, decisiones técnicas, ADRs, diagramas C4.
+**Archivo**: `.awc/agents/architect-senior.agent.yaml`
+**Comandos clave**: *arch-design-solution, *arch-create-c4, *arch-create-adr
+
+### DEVELOPER PRO (Implementador)
+**Cuándo usar**: Desarrollo con TDD, code review, refactoring, debugging.
+**Archivo**: `.awc/agents/developer-pro.agent.yaml`
+**Comandos clave**: *dev-implement-tdd, *dev-code-review, *dev-refactor
+
+### QA SPECIALIST (Calidad)
+**Cuándo usar**: Testing, cobertura, validación, reportes de calidad.
+**Archivo**: `.awc/agents/qa-specialist.agent.yaml`
+**Comandos clave**: *qa-test-plan, *qa-unit-tests, *qa-coverage
+
+## 🔄 Workflows Recomendados
+
+### Quick Flow (<10 min)
+Para: Bugs, hotfixes, cambios menores
+Proceso: Init → Spec → Implement → Test
+
+### Standard Flow (<30 min)
+Para: Features nuevas, refactoring moderado
+Proceso: Análisis → Planificación → Arquitectura → Implementación → Validación
+
+### Enterprise Flow (<2 hrs)
+Para: Sistemas complejos, migraciones, arquitecturas grandes
+Proceso: Discovery → Requirements → Design → Plan → Development → QA → Deploy
+
+## 📋 Estándares de Calidad
+
+Todos los cambios deben cumplir:
+- **Cobertura de tests**: >80%
+- **Deuda técnica**: <5%
+- **Code review**: Obligatorio
+- **Documentación**: Sincronizada con código
+- **TDD**: Test-first development
+
+## 🛠️ Comandos CLI Disponibles
+
+```bash
+awc status      # Ver estado del proyecto
+awc validate    # Validar estructura
+awc config      # Configurar preferencias
+```
+
+## 💡 Cómo Trabajar con Agentes
+
+1. **Referencia el agente apropiado** según la tarea:
+   - Arquitectura/Diseño → ARCHITECT SENIOR
+   - Implementación → DEVELOPER PRO
+   - Testing/Calidad → QA SPECIALIST
+   - Coordinación → ZEN MASTER
+
+2. **Sigue el workflow** recomendado según complejidad
+
+3. **Documenta decisiones** en formato ADR cuando sea arquitectónico
+
+4. **Mantén trazabilidad** de todas las decisiones técnicas
+
+## 📖 Documentación
+
+- **Getting Started**: `docs/getting-started/quick-start.md`
+- **Guías**: `docs/guides/`
+- **Ejemplos**: `docs/examples/`
+- **Referencia**: `docs/reference/`
+
+## 🎨 Estilo de Código
+
+- **Comunicación**: Español con el usuario
+- **Código**: Inglés (nombres de variables, funciones, comentarios técnicos)
+- **Documentación**: Español
+- **Commits**: Conventional Commits en español
+
+## ⚡ Principios de Desarrollo
+
+1. **Simplicidad deliberada** sobre complejidad accidental
+2. **Decisiones basadas en evidencia** no en opiniones
+3. **Procesos repetibles** y documentados
+4. **Mejora continua** basada en métricas
+5. **Colaboración inteligente** entre agentes según necesidad
+
+---
+
+Para más detalles, consulta la configuración completa en `.awc/config.yaml`