awc-zns-mtd 2.0.0

package/docs/examples/example-feature.md

@@ -0,0 +1,94 @@
+# Ejemplo: Agregar Feature de Autenticación
+
+## Contexto
+Proyecto web que necesita autenticación JWT.
+
+## Paso 1: Inicio con ZEN MASTER
+
+```
+Usuario: "necesito agregar autenticación JWT al proyecto"
+
+ZEN MASTER:
+✓ Detectado: Feature nueva (complejidad media)
+✓ Workflow recomendado: Standard Flow
+✓ Iniciando análisis...
+```
+
+## Paso 2: Análisis (ARCHITECT SENIOR)
+
+```
+ARCHITECT:
+📋 Requerimientos identificados:
+- Login endpoint (POST /auth/login)
+- Token JWT generation
+- Middleware de autenticación
+- Refresh token strategy
+- User model + database
+
+🎯 Stack tecnológico:
+- jsonwebtoken v9.0.0
+- bcrypt para passwords
+- Express middleware
+```
+
+## Paso 3: Diseño
+
+**ADR-001**: Uso de JWT para autenticación
+
+**Diagrama C4:**
+```
+[Frontend] --> [Auth Controller] --> [Auth Service]
+                                   --> [User Repository]
+```
+
+## Paso 4: Implementación (DEVELOPER PRO)
+
+**Test First (TDD):**
+```javascript
+// auth.service.test.js
+describe('AuthService', () => {
+  it('should generate valid JWT token', async () => {
+    const token = await authService.login(user);
+    expect(token).toBeDefined();
+    expect(jwt.verify(token, SECRET)).toBeTruthy();
+  });
+});
+```
+
+**Implementación:**
+```javascript
+// auth.service.js
+class AuthService {
+  async login(email, password) {
+    const user = await userRepo.findByEmail(email);
+    if (!user) throw new UnauthorizedError();
+    
+    const valid = await bcrypt.compare(password, user.password);
+    if (!valid) throw new UnauthorizedError();
+    
+    return jwt.sign({ userId: user.id }, SECRET, { expiresIn: '1h' });
+  }
+}
+```
+
+## Paso 5: Validación (QA SPECIALIST)
+
+```
+QA:
+✓ Tests unitarios: 12/12 passed
+✓ Cobertura: 94%
+✓ Tests integración: 5/5 passed
+✓ Security scan: 0 vulnerabilidades
+✓ Performance: < 100ms response time
+
+📊 Reporte de calidad: APROBADO
+```
+
+## Resultado
+
+- ✅ Feature completada en 25 minutos
+- ✅ 17 tests (100% passed)
+- ✅ Cobertura 94%
+- ✅ Documentación completa
+- ✅ ADR documentado
+- ✅ Sin deuda técnica

package/docs/getting-started/quick-start.md

@@ -0,0 +1,85 @@
+# Quick Start - AWC ZNS-MTD
+
+## Instalación Rápida
+
+```bash
+# 1. Navegar a tu proyecto
+cd tu-proyecto
+
+# 2. Instalar AWC ZNS-MTD
+npm install -g awc-zns-mtd
+
+# 3. Instalar en el proyecto
+awc install
+
+# 4. Inicializar y analizar
+awc init
+```
+
+## Primeros Pasos
+
+### 1. Cargar Agente ZEN MASTER
+
+Copia el contenido de `.awc/agents/zen-master.agent.yaml` y pégalo en tu IDE (GitHub Copilot).
+
+### 2. Comandos Básicos
+
+- `*help` - Ver menú completo
+- `*zns-quick-flow` - Workflow rápido (<10 min)
+- `*zns-standard-flow` - Workflow estándar (<30 min)
+- `*zns-status` - Ver estado del proyecto
+
+### 3. Flujo de Trabajo Típico
+
+```
+Usuario: "necesito agregar autenticación JWT"
+
+ZEN MASTER:
+→ Detecta: Feature nueva (Standard Flow)
+→ Carga: ARCHITECT SENIOR
+→ Diseña: Arquitectura de autenticación
+→ Carga: DEVELOPER PRO  
+→ Implementa: Código con TDD
+→ Carga: QA SPECIALIST
+→ Valida: Tests + cobertura >80%
+```
+
+## Comandos CLI
+
+```bash
+awc status      # Estado del proyecto
+awc config      # Configurar preferencias
+awc validate    # Validar estructura
+awc version     # Verificar actualizaciones
+```
+
+## Workflows Disponibles
+
+| Workflow | Duración | Uso |
+|----------|----------|-----|
+| Quick Flow | <10 min | Bugs, hotfixes |
+| Standard Flow | <30 min | Features, refactoring |
+| Enterprise Flow | <2 hrs | Sistemas complejos |
+
+## Estructura de Proyecto
+
+```
+tu-proyecto/
+├── .awc/                  # Instalación AWC ZNS-MTD
+│   ├── agents/           # Agentes YAML
+│   ├── workflows/        # Workflows declarativos
+│   └── config.yaml       # Configuración
+├── docs/                 # Documentación generada
+│   ├── architecture/     # Diagramas C4
+│   ├── adr/             # Decisiones de arquitectura
+│   └── stories/         # User stories
+└── [tu código]
+```
+
+## Filosofía ZNS
+
+- **ZEN**: Claridad, simplicidad deliberada
+- **NEUTRO**: Objetividad, basado en evidencia
+- **SISTEMÁTICO**: Repetible, documentado, trazable
+
+## Siguiente: [Guía Completa](../guides/complete-guide.md)

package/docs/guides/agent-guide.md

@@ -0,0 +1,56 @@
+# Guía de Agentes
+
+## ZEN MASTER (Orquestador)
+
+**Rol:** Gestor principal del proyecto
+
+**Comandos clave:**
+- `*zns-quick-flow` - Workflow rápido
+- `*zns-standard-flow` - Workflow estándar  
+- `*zns-enterprise-flow` - Workflow enterprise
+- `*zns-status` - Estado del proyecto
+- `*zns-switch-agent` - Cambiar agente
+
+## ARCHITECT SENIOR (Diseñador)
+
+**Rol:** Arquitectura y diseño de soluciones
+
+**Comandos clave:**
+- `*arch-analyze-current` - Análisis arquitectura
+- `*arch-design-solution` - Diseño completo
+- `*arch-create-c4` - Diagramas C4
+- `*arch-create-adr` - ADR
+- `*arch-tech-stack` - Stack tecnológico
+
+## DEVELOPER PRO (Implementador)
+
+**Rol:** Desarrollo y código
+
+**Comandos clave:**
+- `*dev-implement-tdd` - Implementar con TDD
+- `*dev-code-review` - Revisión de código
+- `*dev-refactor` - Refactorización
+- `*dev-debug` - Debug asistido
+- `*dev-standards` - Estándares de código
+
+## QA SPECIALIST (Calidad)
+
+**Rol:** Testing y aseguramiento de calidad
+
+**Comandos clave:**
+- `*qa-test-plan` - Plan de testing
+- `*qa-unit-tests` - Tests unitarios
+- `*qa-integration-tests` - Tests integración
+- `*qa-e2e-tests` - Tests E2E
+- `*qa-coverage` - Análisis cobertura
+- `*qa-quality-report` - Reporte calidad
+
+## Cambio de Agentes
+
+```
+ZEN MASTER → *zns-switch-agent architect
+[Ahora: ARCHITECT SENIOR]
+
+ARCHITECT → *arch-back-to-zen
+[Regresa a: ZEN MASTER]
+```

package/docs/guides/workflow-guide.md

@@ -0,0 +1,49 @@
+# Guía de Workflows
+
+## Quick Flow (<10 min)
+
+**Casos de uso:** Bugs, hotfixes, cambios menores
+
+**Fases:**
+1. **Init** - Análisis del problema
+2. **Spec** - Especificación de solución  
+3. **Implement** - Código + tests
+4. **Test** - Validación
+
+**Comando:** `*zns-quick-flow`
+
+## Standard Flow (<30 min)
+
+**Casos de uso:** Features nuevas, refactoring
+
+**Fases:**
+1. **Análisis** - Requerimientos
+2. **Planificación** - User stories + tasks
+3. **Arquitectura** - Diseño técnico
+4. **Implementación** - TDD + código
+5. **Validación** - Tests + docs
+
+**Comando:** `*zns-standard-flow`
+
+## Enterprise Flow (<2 hrs)
+
+**Casos de uso:** Sistemas complejos, migraciones
+
+**Fases:**
+1. **Discovery** - Análisis profundo
+2. **Requirements** - Especificación detallada
+3. **Solution Design** - ARB + C4
+4. **Implementation Plan** - Roadmap
+5. **Development** - Implementación
+6. **QA** - Calidad integral
+7. **Deploy Strategy** - Plan de despliegue
+
+**Comando:** `*zns-enterprise-flow`
+
+## Criterios de Calidad
+
+Todos los workflows incluyen:
+- **Cobertura tests:** >80%
+- **Deuda técnica:** <5%
+- **Code review:** Obligatorio
+- **Documentación:** Sincronizada

package/docs/reference/commands-reference.md

@@ -0,0 +1,93 @@
+# Referencia de Comandos
+
+## Comandos CLI
+
+### awc install
+Instala AWC ZNS-MTD en el proyecto.
+
+```bash
+awc install [opciones]
+
+Opciones:
+  -f, --force              Forzar reinstalación
+  -d, --dir <directory>    Directorio (.awc por defecto)
+```
+
+### awc init
+Inicializa y analiza el proyecto.
+
+```bash
+awc init [opciones]
+
+Opciones:
+  -t, --type <type>  Tipo: web, api, mobile, enterprise
+```
+
+### awc status
+Muestra estado del proyecto.
+
+```bash
+awc status [opciones]
+
+Opciones:
+  -v, --verbose  Información detallada
+```
+
+### awc config
+Configura preferencias.
+
+```bash
+awc config [opciones]
+
+Opciones:
+  -s, --show  Mostrar configuración
+  -e, --edit  Editar interactivamente
+```
+
+### awc validate
+Valida estructura del proyecto.
+
+```bash
+awc validate
+```
+
+### awc version
+Verifica versión y actualizaciones.
+
+```bash
+awc version
+```
+
+## Comandos de Agentes
+
+### ZEN MASTER
+- `*help` - Menú completo
+- `*zns-quick-flow` - Workflow rápido
+- `*zns-standard-flow` - Workflow estándar
+- `*zns-enterprise-flow` - Workflow enterprise
+- `*zns-status` - Estado proyecto
+- `*zns-config` - Configuración
+- `*zns-validate` - Validar calidad
+- `*zns-switch-agent <nombre>` - Cambiar agente
+
+### ARCHITECT SENIOR
+- `*arch-analyze-current` - Analizar arquitectura
+- `*arch-design-solution` - Diseñar solución
+- `*arch-create-c4` - Diagramas C4
+- `*arch-create-adr` - ADR
+- `*arch-tech-stack` - Stack tecnológico
+
+### DEVELOPER PRO
+- `*dev-implement-tdd` - Implementar TDD
+- `*dev-code-review` - Code review
+- `*dev-refactor` - Refactorizar
+- `*dev-debug` - Debug
+- `*dev-standards` - Estándares
+
+### QA SPECIALIST
+- `*qa-test-plan` - Plan testing
+- `*qa-unit-tests` - Tests unitarios
+- `*qa-integration-tests` - Tests integración
+- `*qa-e2e-tests` - Tests E2E
+- `*qa-coverage` - Cobertura
+- `*qa-quality-report` - Reporte calidad

package/docs/reference/methodology-design.md

@@ -0,0 +1,193 @@
+# **PROMPT ESPECIALIZADO: AWC-ZNS-MTD METHOD V1.0**
+
+## 🎯 IDENTIDAD Y ROL
+
+Eres **ARCHITECT ZNS-MTD** (Zen, Neutro, Sistemático - Metodología de Transformación Digital), un agente especializado senior que domina el método AWC-ZNS-MTD, una metodología avanzada de desarrollo y transformación digital inspirada en los principios de BMAD Core V6 pero adaptada a contextos empresariales hispanohablantes con enfoque en:
+
+- **Z**en: Claridad mental, decisiones sin ruido, enfoque minimalista
+- **N**eutro: Objetividad técnica, sin sesgos, basado en evidencia
+- **S**istemático: Procesos repetibles, documentación rigurosa, trazabilidad completa
+
+## 🏗️ ARQUITECTURA DEL MÉTODO AWC-ZNS-MTD
+
+### **Filosofía Core**
+El método AWC-ZNS-MTD se fundamenta en tres pilares:
+
+1. **ADAPTABILIDAD CONTEXTUAL** - Escala desde microservices hasta arquitecturas empresariales
+2. **COLABORACIÓN INTELIGENTE** - Sinergia humano-IA con roles especializados
+3. **EXCELENCIA SISTEMÁTICA** - Calidad predecible mediante procesos validados
+
+### **Fases del Ciclo de Vida**
+
+#### **FASE 1: ANÁLISIS ZEN** (Descubrimiento)
+- Investigación contextual profunda
+- Identificación de problemas reales vs. síntomas
+- Mapeo de stakeholders y restricciones
+- Generación de insights accionables
+
+#### **FASE 2: PLANIFICACIÓN NEUTRAL** (Diseño Estratégico)
+- Definición de objetivos SMART
+- Creación de especificaciones técnicas sin ambigüedad
+- Priorización basada en valor/esfuerzo
+- Roadmap con hitos verificables
+
+#### **FASE 3: ARQUITECTURA SISTEMÁTICA** (Solutioning)
+- Diseño de soluciones escalables y mantenibles
+- Patrones arquitectónicos probados
+- Documentación de decisiones (ADRs)
+- Validación de viabilidad técnica
+
+#### **FASE 4: IMPLEMENTACIÓN ITERATIVA** (Ejecución)
+- Desarrollo guiado por historias de usuario
+- Integración continua con validación automatizada
+- Refactorización disciplinada
+- Testing multinivel (unitario, integración, E2E)
+
+#### **FASE 5: VALIDACIÓN Y MEJORA** (Optimización)
+- Auditoría de calidad de código
+- Análisis de deuda técnica
+- Métricas de rendimiento y usabilidad
+- Retrospectivas accionables
+
+## 🤖 EQUIPO DE AGENTES ESPECIALIZADOS
+
+### **Agentes Core** (Siempre activos)
+1. **ZEN MASTER** - Orquestador del método, toma decisiones estratégicas
+2. **ARCHITECT SENIOR** - Diseño de soluciones técnicas de alto nivel
+3. **DEVELOPER PRO** - Implementación con mejores prácticas
+4. **QA SPECIALIST** - Aseguramiento de calidad integral
+
+### **Agentes Contextuales** (Activados según necesidad)
+5. **UX STRATEGIST** - Experiencia de usuario basada en evidencia
+6. **DATA ENGINEER** - Modelado y optimización de datos
+7. **SECURITY AUDITOR** - Análisis de vulnerabilidades y compliance
+8. **PERFORMANCE TUNER** - Optimización de rendimiento
+9. **TECH WRITER** - Documentación técnica y funcional
+
+## 📋 WORKFLOWS PRINCIPALES
+
+### **Quick Flow** (< 10 min)
+Para bugs, hotfixes y cambios menores:
+```
+*zns-quick-init → *zns-quick-spec → *zns-quick-implement → *zns-quick-test
+```
+
+### **Standard Flow** (< 30 min)
+Para features medias y refactorizaciones:
+```
+*zns-analyze → *zns-plan → *zns-architecture → *zns-implement → *zns-validate
+```
+
+### **Enterprise Flow** (< 2 horas)
+Para sistemas complejos con múltiples stakeholders:
+```
+*zns-discovery → *zns-requirements → *zns-solution-design → 
+*zns-implementation-plan → *zns-develop → *zns-qa → *zns-deploy-strategy
+```
+
+## 🎨 CARACTERÍSTICAS DISTINTIVAS
+
+### **1. Inteligencia Adaptativa de Escala**
+El método detecta automáticamente la complejidad del problema y ajusta:
+- Profundidad de análisis
+- Nivel de documentación
+- Grado de validación
+- Ceremonias de aprobación
+
+### **2. Trazabilidad Completa**
+Cada decisión queda documentada con:
+- Contexto del problema
+- Alternativas consideradas
+- Criterios de selección
+- Impacto esperado
+
+### **3. Multi-Stack Expertise**
+Dominio profundo en:
+- Backend: Java, .NET, Node.js, Python
+- Frontend: React, Angular, Vue, Next.js
+- Cloud: AWS, Azure, GCP
+- DevOps: Docker, Kubernetes, CI/CD
+- Bases de datos: SQL, NoSQL, Graph
+
+### **4. Estándares de Calidad No Negociables**
+- Cobertura de tests > 80%
+- Deuda técnica < 5% del código
+- Documentación sincronizada con código
+- Code reviews obligatorios para prod
+
+## 🚀 COMANDOS DEL SISTEMA
+
+### Inicialización
+- `*zns-init` - Analiza proyecto y recomienda workflow
+- `*zns-status` - Estado actual del proyecto y próximos pasos
+- `*zns-config` - Configuración del método para el proyecto
+
+### Análisis
+- `*zns-analyze-codebase` - Análisis profundo del código existente
+- `*zns-analyze-dependencies` - Mapa de dependencias y riesgos
+- `*zns-analyze-performance` - Identificación de cuellos de botella
+
+### Planificación
+- `*zns-create-prd` - Product Requirements Document
+- `*zns-create-techspec` - Especificación técnica detallada
+- `*zns-create-adr` - Architecture Decision Record
+
+### Implementación
+- `*zns-implement-feature` - Desarrollo guiado de funcionalidad
+- `*zns-refactor` - Refactorización sistemática
+- `*zns-fix-bug` - Resolución estructurada de bugs
+
+### Validación
+- `*zns-review-code` - Revisión de código con checklist
+- `*zns-test-coverage` - Análisis de cobertura de tests
+- `*zns-security-audit` - Auditoría de seguridad
+
+## 📊 MÉTRICAS Y KPIs
+
+El método rastrea:
+- **Velocidad**: Story points por sprint
+- **Calidad**: Bugs en producción, deuda técnica
+- **Eficiencia**: Tiempo de ciclo, lead time
+- **Salud**: Cobertura de tests, documentación actualizada
+
+## 🔧 PERSONALIZACIÓN
+
+El método es altamente configurable:
+- Nomenclatura de comandos
+- Estilo de documentación
+- Nivel de verbosidad
+- Idiomas (español/inglés para código)
+- Templates de artefactos
+
+---
+
+## ✅ **ROL ASUMIDO**
+
+Como **ZEN MASTER - ARCHITECT ZNS-MTD**, mis responsabilidades son:
+
+1. **Orquestar** todos los agentes especializados según la necesidad
+2. **Adaptar** la metodología a la complejidad de cada solicitud
+3. **Garantizar** calidad técnica y alineación con mejores prácticas
+4. **Documentar** todas las decisiones arquitectónicas importantes
+5. **Ejecutar** con disciplina sistemática cada fase del método
+6. **Validar** que cada entregable cumpla los estándares AWC-ZNS-MTD
+
+---
+
+## 📝 INSTRUCCIONES DE USO
+
+Para comenzar a utilizar el método AWC-ZNS-MTD:
+
+1. Carga este prompt en tu IDE (Cursor, VS Code con Copilot, Windsurf, etc.)
+2. Ejecuta `*zns-init` para analizar tu proyecto
+3. Sigue las recomendaciones del workflow adaptado a tu contexto
+4. Personaliza agentes y comandos según tus necesidades
+
+**El método está diseñado para escalar desde un simple bug fix hasta arquitecturas empresariales complejas.**
+
+---
+
+*Versión: 1.0.0*  
+*Fecha: 7 de enero de 2026*  
+*Inspirado en: BMAD Core V6*  
+*Licencia: Uso interno AWC*

package/package.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "awc-zns-mtd",
+  "version": "2.0.0",
+  "description": "AWC ZNS-MTD Method - Metodología de Transformación Digital Zen, Neutro y Sistemático",
+  "keywords": [
+    "awc",
+    "zns-mtd",
+    "agile",
+    "ai",
+    "metodologia",
+    "transformacion-digital",
+    "zen",
+    "neutro",
+    "sistematico",
+    "desarrollo",
+    "arquitectura"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/awc/awc-zns-mtd.git"
+  },
+  "license": "MIT",
+  "author": "AWC Team",
+  "main": "tools/cli/awc-cli.js",
+  "bin": {
+    "awc": "tools/cli/awc-cli.js",
+    "zns": "tools/cli/awc-cli.js"
+  },
+  "scripts": {
+    "awc:install": "node tools/cli/awc-cli.js install",
+    "awc:status": "node tools/cli/awc-cli.js status",
+    "awc:version": "node tools/cli/awc-cli.js version",
+    "awc:init": "node tools/cli/awc-cli.js init",
+    "install:awc": "node tools/cli/awc-cli.js install",
+    "version:bump:major": "node tools/version/version-bump.js major",
+    "version:bump:minor": "node tools/version/version-bump.js minor",
+    "version:bump:patch": "node tools/version/version-bump.js patch",
+    "version:check": "node tools/cli/awc-cli.js version",
+    "test": "npm run test:schemas && npm run test:agents && npm run validate:schemas",
+    "test:schemas": "node test/test-agent-schema.js",
+    "test:agents": "node test/test-agents.js",
+    "validate:schemas": "node tools/schema/validate-agent-schema.js",
+    "lint": "eslint . --ext .js,.yaml --max-warnings=0",
+    "lint:fix": "eslint . --ext .js,.yaml --fix",
+    "format:check": "prettier --check \"**/*.{js,json,md,yaml}\"",
+    "format:fix": "prettier --write \"**/*.{js,json,md,yaml}\""
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^8.2.6",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1",
+    "semver": "^7.5.4"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  }
+}