awc-zns-mtd 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -7,6 +7,74 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/lang/es/).
 
 ---
 
+## [2.1.0] - 2026-01-08
+
+### ✨ Añadido
+
+#### **Comando `awc new` - Crear Proyectos Completos**
+- 🎯 Nuevo comando `awc new [project-name]` para crear proyectos desde cero
+- 📁 Estructura de directorios estándar (8 fases)
+- 📋 Templates automáticamente copiados a cada proyecto
+- 🔧 Configuración AWC pre-configurada
+- 📚 Guías START_HERE.md en cada fase
+
+#### **Estructura de Proyecto Estándar**
+```
+proyecto/
+├── 01-comercial/          # Fase 0: Comercial
+│   ├── 01-prospection/
+│   ├── 02-technical-proposal/
+│   ├── 03-quotation/
+│   └── 04-contract/
+├── 02-inception/          # Fase 1: Inception
+├── 03-analysis/           # Fase 2: Análisis
+├── 04-planning/           # Fase 3: Planificación
+├── 05-development/        # Fase 4: Desarrollo
+│   ├── src/
+│   ├── tests/
+│   └── docs/
+├── 06-qa/                 # Fase 5: QA
+├── 07-deployment/         # Fase 6: Deployment
+├── 08-support/            # Fase 7: Soporte
+├── docs/                  # Documentación general
+├── .awc/                  # Configuración AWC
+│   ├── agents/
+│   ├── workflows/
+│   ├── templates/
+│   └── config.json
+└── README.md
+```
+
+#### **Características del Comando**
+- ✅ Crea estructura completa de 8 fases
+- ✅ Copia todos los templates (7 documentos)
+- ✅ Copia todos los workflows (8 workflows)
+- ✅ Copia todos los agentes (22 agentes)
+- ✅ Genera README.md personalizado
+- ✅ Crea .gitignore apropiado
+- ✅ Inicializa Git automáticamente (opcional)
+- ✅ Crea guías START_HERE.md por fase
+
+### 🔄 Modificado
+
+- **CLI**: Separado `awc new` (proyectos nuevos) de `awc init` (proyectos existentes)
+- **UX**: Experiencia mejorada con spinner y mensajes claros
+
+### 📊 Uso
+
+```bash
+# Crear nuevo proyecto interactivo
+awc new
+
+# Crear proyecto con nombre
+awc new mi-proyecto
+
+# Crear proyecto de tipo específico
+awc new mi-api --type api
+```
+
+---
+
 ## [2.0.0] - 2026-01-08
 
 ### 🚀 MAJOR RELEASE - Método Completo End-to-End

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "awc-zns-mtd",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "AWC ZNS-MTD Method - Metodología de Transformación Digital Zen, Neutro y Sistemático",
   "keywords": [
     "awc",

package/src/modules/awc-zns-mtd/config.yaml

@@ -4,7 +4,7 @@
 
 module_name: "AWC ZNS-MTD Method"
 module_code: "awc-zns-mtd"
-version: "2.0.0"
+version: "2.1.0"
 author: "AWC Team"
 description: "Metodología de Transformación Digital - Zen, Neutro, Sistemático"
 

package/tools/cli/awc-cli.js

@@ -39,10 +39,25 @@ program
     }
   });
 
+// Comando: new (crear nuevo proyecto)
+program
+  .command('new [project-name]')
+  .description('Crear un nuevo proyecto con estructura completa AWC ZNS-MTD')
+  .option('-t, --type <type>', 'Tipo de proyecto (web, api, mobile, enterprise)')
+  .action(async (projectName, options) => {
+    try {
+      const { newProjectCommand } = require('./commands/new-project');
+      await newProjectCommand(projectName, options);
+    } catch (error) {
+      console.error(chalk.red('Error creando proyecto:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Comando: init
 program
   .command('init')
-  .description('Inicializar proyecto con ZNS-MTD y analizar contexto')
+  .description('Inicializar proyecto existente con ZNS-MTD')
   .option('-t, --type <type>', 'Tipo de proyecto (web, api, mobile, enterprise)')
   .action(async (options) => {
     try {

package/tools/cli/commands/new-project.js

@@ -0,0 +1,629 @@
+/**
+ * Comando: new
+ * Crea un nuevo proyecto con estructura completa AWC ZNS-MTD
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const ora = require('ora');
+const inquirer = require('inquirer');
+const { displayLogo } = require('../utils/console-logger');
+const { getVersion } = require('../utils/version');
+
+/**
+ * Comando principal para crear nuevo proyecto
+ */
+async function newProjectCommand(projectName, options = {}) {
+  displayLogo();
+
+  console.log(chalk.cyan('\n🚀 Crear Nuevo Proyecto AWC ZNS-MTD\n'));
+
+  // Preguntar nombre del proyecto si no se proporcionó
+  if (!projectName) {
+    const { name } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'name',
+        message: '📦 Nombre del proyecto:',
+        validate: (input) => {
+          if (!input.trim()) return 'El nombre del proyecto es requerido';
+          if (!/^[a-zA-Z0-9-_]+$/.test(input)) {
+            return 'Solo se permiten letras, números, guiones y guiones bajos';
+          }
+          return true;
+        }
+      }
+    ]);
+    projectName = name;
+  }
+
+  // Verificar si el directorio ya existe
+  const projectPath = path.join(process.cwd(), projectName);
+  if (await fs.pathExists(projectPath)) {
+    console.log(chalk.red(`\n❌ El directorio '${projectName}' ya existe.\n`));
+    process.exit(1);
+  }
+
+  // Preguntas de configuración
+  const answers = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'projectType',
+      message: '¿Qué tipo de proyecto es?',
+      choices: [
+        { name: 'Web Application (Frontend + Backend)', value: 'web' },
+        { name: 'API/Microservices', value: 'api' },
+        { name: 'Mobile Application', value: 'mobile' },
+        { name: 'Enterprise System', value: 'enterprise' },
+        { name: 'Otro', value: 'other' }
+      ],
+      default: options.type
+    },
+    {
+      type: 'input',
+      name: 'description',
+      message: '📝 Descripción breve del proyecto:',
+      default: `Proyecto ${projectName}`
+    },
+    {
+      type: 'list',
+      name: 'teamSize',
+      message: '👥 Tamaño del equipo:',
+      choices: [
+        { name: 'Individual (1 persona)', value: 'solo' },
+        { name: 'Pequeño (2-5 personas)', value: 'small' },
+        { name: 'Mediano (6-15 personas)', value: 'medium' },
+        { name: 'Grande (16+ personas)', value: 'large' }
+      ]
+    },
+    {
+      type: 'confirm',
+      name: 'gitInit',
+      message: '🔧 Inicializar repositorio Git?',
+      default: true
+    }
+  ]);
+
+  const spinner = ora('Creando estructura del proyecto...').start();
+
+  try {
+    // 1. Crear directorio raíz del proyecto
+    await fs.ensureDir(projectPath);
+    spinner.text = `Directorio ${projectName} creado`;
+
+    // 2. Crear estructura estándar de directorios
+    const directories = [
+      // Fase 0: Comercial
+      '01-comercial/01-prospection',
+      '01-comercial/02-technical-proposal',
+      '01-comercial/03-quotation',
+      '01-comercial/04-contract',
+      
+      // Fase 1: Inception
+      '02-inception/01-kickoff',
+      '02-inception/02-prd',
+      '02-inception/03-backlog',
+      '02-inception/04-release-planning',
+      
+      // Fase 2: Análisis
+      '03-analysis/01-code-audit',
+      '03-analysis/02-architecture-review',
+      '03-analysis/03-technical-debt',
+      '03-analysis/04-recommendations',
+      
+      // Fase 3: Planificación
+      '04-planning/01-sprint-planning',
+      '04-planning/02-backlog-refinement',
+      '04-planning/03-release-planning',
+      '04-planning/04-roadmap',
+      
+      // Fase 4: Desarrollo
+      '05-development/src',
+      '05-development/tests',
+      '05-development/docs',
+      
+      // Fase 5: QA
+      '06-qa/test-plans',
+      '06-qa/test-cases',
+      '06-qa/test-results',
+      '06-qa/bug-reports',
+      
+      // Fase 6: Deployment
+      '07-deployment/environments',
+      '07-deployment/scripts',
+      '07-deployment/logs',
+      
+      // Fase 7: Soporte
+      '08-support/incidents',
+      '08-support/bug-fixes',
+      '08-support/maintenance',
+      
+      // Documentación general
+      'docs/architecture',
+      'docs/adr',
+      'docs/api',
+      'docs/guides',
+      
+      // Configuración AWC
+      '.awc/agents',
+      '.awc/workflows',
+      '.awc/templates'
+    ];
+
+    for (const dir of directories) {
+      await fs.ensureDir(path.join(projectPath, dir));
+    }
+    spinner.text = 'Estructura de directorios creada';
+
+    // 3. Copiar templates
+    const srcTemplatesPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/templates');
+    const destTemplatesPath = path.join(projectPath, '.awc/templates');
+    
+    if (await fs.pathExists(srcTemplatesPath)) {
+      await fs.copy(srcTemplatesPath, destTemplatesPath);
+      spinner.text = 'Templates copiados';
+    }
+
+    // 4. Copiar workflows
+    const srcWorkflowsPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/workflows');
+    const destWorkflowsPath = path.join(projectPath, '.awc/workflows');
+    
+    if (await fs.pathExists(srcWorkflowsPath)) {
+      await fs.copy(srcWorkflowsPath, destWorkflowsPath);
+      spinner.text = 'Workflows copiados';
+    }
+
+    // 5. Copiar agentes
+    const srcAgentsPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/agents');
+    const destAgentsPath = path.join(projectPath, '.awc/agents');
+    
+    if (await fs.pathExists(srcAgentsPath)) {
+      await fs.copy(srcAgentsPath, destAgentsPath);
+      spinner.text = 'Agentes copiados';
+    }
+
+    // 6. Crear archivo de configuración AWC
+    const awcConfig = {
+      version: getVersion(),
+      createdAt: new Date().toISOString(),
+      project: {
+        name: projectName,
+        description: answers.description,
+        type: answers.projectType,
+        teamSize: answers.teamSize
+      },
+      preferences: {
+        communication_language: 'Spanish',
+        document_output_language: 'Spanish',
+        code_language: 'English'
+      },
+      workflows: {
+        current_phase: 'comercial',
+        completed_phases: []
+      }
+    };
+
+    await fs.writeJson(
+      path.join(projectPath, '.awc/config.json'),
+      awcConfig,
+      { spaces: 2 }
+    );
+    spinner.text = 'Configuración AWC creada';
+
+    // 7. Crear README.md del proyecto
+    const readme = createReadmeContent(projectName, answers);
+    await fs.writeFile(path.join(projectPath, 'README.md'), readme);
+    spinner.text = 'README.md creado';
+
+    // 8. Crear .gitignore
+    const gitignore = createGitignoreContent();
+    await fs.writeFile(path.join(projectPath, '.gitignore'), gitignore);
+    spinner.text = '.gitignore creado';
+
+    // 9. Crear archivo de inicio para cada fase
+    await createPhaseGuides(projectPath);
+    spinner.text = 'Guías de fase creadas';
+
+    // 10. Inicializar Git si se solicitó
+    if (answers.gitInit) {
+      const { execSync } = require('child_process');
+      try {
+        execSync('git init', { cwd: projectPath, stdio: 'ignore' });
+        execSync('git add .', { cwd: projectPath, stdio: 'ignore' });
+        execSync(`git commit -m "feat: Inicializar proyecto ${projectName} con AWC ZNS-MTD"`, {
+          cwd: projectPath,
+          stdio: 'ignore'
+        });
+        spinner.text = 'Repositorio Git inicializado';
+      } catch (error) {
+        // Git no está disponible o fallo, continuar sin git
+      }
+    }
+
+    spinner.succeed(chalk.green('✅ Proyecto creado exitosamente'));
+
+    // Mostrar resumen
+    console.log(chalk.cyan('\n' + '═'.repeat(60)));
+    console.log(chalk.cyan('📦 Resumen del Proyecto'));
+    console.log(chalk.cyan('═'.repeat(60) + '\n'));
+
+    console.log(`${chalk.gray('Nombre:')}        ${chalk.green(projectName)}`);
+    console.log(`${chalk.gray('Tipo:')}          ${chalk.yellow(answers.projectType)}`);
+    console.log(`${chalk.gray('Equipo:')}        ${chalk.yellow(answers.teamSize)}`);
+    console.log(`${chalk.gray('Ubicación:')}     ${chalk.blue(projectPath)}`);
+    console.log(`${chalk.gray('AWC Versión:')}   ${chalk.yellow(getVersion())}\n`);
+
+    // Próximos pasos
+    console.log(chalk.cyan('📚 Próximos Pasos:\n'));
+    console.log(`  ${chalk.green('1.')} cd ${projectName}`);
+    console.log(`  ${chalk.green('2.')} Revisar ${chalk.yellow('01-comercial/START_HERE.md')}`);
+    console.log(`  ${chalk.green('3.')} Completar discovery notes y análisis de viabilidad`);
+    console.log(`  ${chalk.green('4.')} Ejecutar ${chalk.yellow('awc status')} para ver el progreso\n`);
+
+    console.log(chalk.cyan('🎯 Flujo de Trabajo Recomendado:\n'));
+    console.log(`  ${chalk.gray('→')} Comercial    (01-comercial/)`);
+    console.log(`  ${chalk.gray('→')} Inception    (02-inception/)`);
+    console.log(`  ${chalk.gray('→')} Análisis     (03-analysis/)`);
+    console.log(`  ${chalk.gray('→')} Planificación (04-planning/)`);
+    console.log(`  ${chalk.gray('→')} Desarrollo   (05-development/)`);
+    console.log(`  ${chalk.gray('→')} QA           (06-qa/)`);
+    console.log(`  ${chalk.gray('→')} Deployment   (07-deployment/)`);
+    console.log(`  ${chalk.gray('→')} Soporte      (08-support/)\n`);
+
+    console.log(chalk.green('✨ ¡Listo para comenzar tu proyecto!\n'));
+
+  } catch (error) {
+    spinner.fail(chalk.red('❌ Error creando proyecto'));
+    throw error;
+  }
+}
+
+/**
+ * Crea el contenido del README.md
+ */
+function createReadmeContent(projectName, answers) {
+  return `# ${projectName}
+
+> ${answers.description}
+
+## 📋 Información del Proyecto
+
+- **Tipo**: ${answers.projectType}
+- **Equipo**: ${answers.teamSize}
+- **Metodología**: AWC ZNS-MTD (Zen, Neutro, Sistemático)
+
+## 🚀 Fases del Proyecto
+
+Este proyecto sigue el método AWC ZNS-MTD con 8 fases completas:
+
+### 📊 Fase 0: Comercial (01-comercial/)
+- Prospección y discovery
+- Oferta técnica
+- Cotización
+- Contrato
+
+### 🎯 Fase 1: Inception (02-inception/)
+- Kickoff meeting
+- Product Requirements Document (PRD)
+- Backlog inicial
+- Release planning
+
+### 🔍 Fase 2: Análisis (03-analysis/)
+- Code audit (si aplica)
+- Architecture review
+- Technical debt assessment
+- Recomendaciones
+
+### 📅 Fase 3: Planificación (04-planning/)
+- Sprint planning
+- Backlog refinement
+- Release planning
+- Product roadmap
+
+### 💻 Fase 4: Desarrollo (05-development/)
+- Implementación TDD
+- Code review
+- CI/CD
+
+### ✅ Fase 5: QA (06-qa/)
+- Test planning
+- Automated testing
+- Manual testing
+- UAT
+
+### 🚀 Fase 6: Deployment (07-deployment/)
+- Pre-deployment
+- Staging
+- Production
+- Post-deployment
+
+### 🛠️ Fase 7: Soporte (08-support/)
+- Incident response
+- Bug fixing
+- Maintenance
+- Monitoring
+
+## 📚 Documentación
+
+Toda la documentación del proyecto se encuentra en el directorio \`docs/\`:
+
+- \`docs/architecture/\` - Diagramas y decisiones arquitectónicas
+- \`docs/adr/\` - Architecture Decision Records
+- \`docs/api/\` - Documentación de APIs
+- \`docs/guides/\` - Guías de desarrollo y deployment
+
+## 🔧 Configuración AWC
+
+El directorio \`.awc/\` contiene:
+
+- \`agents/\` - Agentes especializados AWC ZNS-MTD
+- \`workflows/\` - Workflows para cada fase
+- \`templates/\` - Templates de documentos
+- \`config.json\` - Configuración del proyecto
+
+## 🎯 Estado Actual
+
+**Fase actual**: Comercial (inicio)
+
+Revisar \`01-comercial/START_HERE.md\` para comenzar.
+
+## 📝 Comandos AWC
+
+\`\`\`bash
+# Ver estado del proyecto
+awc status
+
+# Validar estructura
+awc validate
+
+# Ver configuración
+awc config
+\`\`\`
+
+---
+
+Generado con ❤️ usando AWC ZNS-MTD Method
+`;
+}
+
+/**
+ * Crea el contenido del .gitignore
+ */
+function createGitignoreContent() {
+  return `# Dependencies
+node_modules/
+vendor/
+bower_components/
+
+# Build outputs
+dist/
+build/
+out/
+target/
+*.exe
+*.dll
+*.so
+*.dylib
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# OS
+Thumbs.db
+.DS_Store
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# Coverage
+coverage/
+*.lcov
+.nyc_output/
+
+# Confidential (keep locally, never commit)
+01-comercial/04-contract/*.pdf
+**/confidential/
+**/*-confidential.*
+`;
+}
+
+/**
+ * Crea guías de inicio para cada fase
+ */
+async function createPhaseGuides(projectPath) {
+  const phases = [
+    {
+      dir: '01-comercial',
+      title: 'Fase 0: Comercial',
+      content: `# 🎯 START HERE - Fase Comercial
+
+## Objetivo
+Capturar requisitos del cliente, evaluar viabilidad y generar oferta comercial.
+
+## Pasos a seguir
+
+### 1. Discovery & Prospección
+📂 Directorio: \`01-prospection/\`
+
+- [ ] Completar \`.awc/templates/discovery-notes.md\`
+- [ ] Identificar stakeholders clave
+- [ ] Entender el problema de negocio
+- [ ] Documentar contexto actual
+
+### 2. Análisis de Viabilidad
+📂 Directorio: \`01-prospection/\`
+
+- [ ] Completar \`.awc/templates/viabilidad.md\`
+- [ ] Evaluar viabilidad técnica
+- [ ] Evaluar viabilidad económica
+- [ ] Identificar riesgos principales
+
+### 3. Oferta Técnica
+📂 Directorio: \`02-technical-proposal/\`
+
+- [ ] Copiar template: \`.awc/templates/oferta-comercial.md\`
+- [ ] Definir solución propuesta
+- [ ] Especificar stack tecnológico
+- [ ] Definir alcance y exclusiones
+
+### 4. Cotización
+📂 Directorio: \`03-quotation/\`
+
+- [ ] Copiar template: \`.awc/templates/cotizacion.md\`
+- [ ] Estimar esfuerzo por fase
+- [ ] Calcular costos
+- [ ] Definir cronograma
+
+### 5. Contrato (confidencial)
+📂 Directorio: \`04-contract/\`
+
+- [ ] Negociar términos
+- [ ] Firmar contrato
+- [ ] Mover a siguiente fase
+
+## ✅ Criterios de Salida
+- ✅ Contrato firmado
+- ✅ Cliente aprobó oferta y cotización
+- ✅ Equipo asignado
+- ✅ Fecha de kickoff definida
+
+## ➡️ Siguiente Fase
+Una vez completado, pasar a **02-inception/**
+`
+    },
+    {
+      dir: '02-inception',
+      title: 'Fase 1: Inception',
+      content: `# 🚀 START HERE - Fase Inception
+
+## Objetivo
+Arranque formal del proyecto, definir PRD y backlog inicial.
+
+## Pasos a seguir
+
+### 1. Kickoff Meeting
+📂 Directorio: \`01-kickoff/\`
+
+- [ ] Copiar template: \`.awc/templates/kickoff-agenda.md\`
+- [ ] Presentar equipo
+- [ ] Alinear expectativas
+- [ ] Definir canales de comunicación
+
+### 2. Product Requirements Document (PRD)
+📂 Directorio: \`02-prd/\`
+
+- [ ] Copiar template: \`.awc/templates/PRD-template.md\`
+- [ ] Documentar requisitos funcionales
+- [ ] Documentar requisitos no funcionales
+- [ ] Definir user personas
+- [ ] Mapear user journeys
+
+### 3. Backlog Inicial
+📂 Directorio: \`03-backlog/\`
+
+- [ ] Crear user stories
+- [ ] Priorizar backlog (MoSCoW)
+- [ ] Estimar user stories (Planning Poker)
+- [ ] Crear epic mapping
+
+### 4. Release Planning
+📂 Directorio: \`04-release-planning/\`
+
+- [ ] Definir MVP (release 1)
+- [ ] Planificar releases subsecuentes
+- [ ] Crear roadmap de producto
+- [ ] Definir milestones
+
+## ✅ Criterios de Salida
+- ✅ PRD aprobado por stakeholders
+- ✅ Backlog priorizado y estimado
+- ✅ Release plan definido
+- ✅ Sprint 1 planificado
+
+## ➡️ Siguiente Fase
+Dependiendo del proyecto:
+- Proyecto nuevo → **04-planning/** (skip análisis)
+- Proyecto existente → **03-analysis/**
+`
+    },
+    {
+      dir: '05-development',
+      title: 'Fase 4: Desarrollo',
+      content: `# 💻 START HERE - Fase Desarrollo
+
+## Objetivo
+Implementar user stories siguiendo TDD y mejores prácticas.
+
+## Estructura
+\`\`\`
+05-development/
+├── src/           # Código fuente
+├── tests/         # Tests (unit, integration, e2e)
+└── docs/          # Documentación técnica
+\`\`\`
+
+## Pasos a seguir
+
+### 1. Feature Kickoff
+- [ ] Seleccionar user story del sprint backlog
+- [ ] Revisar acceptance criteria
+- [ ] Diseño técnico (si es necesario)
+- [ ] Crear feature branch
+
+### 2. Development (TDD)
+- [ ] **RED**: Escribir test que falla
+- [ ] **GREEN**: Implementar código mínimo para pasar test
+- [ ] **REFACTOR**: Mejorar código manteniendo tests en verde
+- [ ] Repetir ciclo
+
+### 3. Code Review
+- [ ] Crear Pull Request
+- [ ] Solicitar revisión (mínimo 2 aprobadores)
+- [ ] Aplicar feedback
+- [ ] Aprobar PR
+
+### 4. Integration
+- [ ] Merge a develop/main
+- [ ] CI/CD automático ejecuta tests
+- [ ] Deploy automático a dev/staging
+
+## 🎯 Mejores Prácticas
+- ✅ Feature branches (feature/US-123-login)
+- ✅ Commits frecuentes y descriptivos
+- ✅ PRs pequeños (<400 líneas)
+- ✅ Code coverage >80%
+- ✅ SonarQube sin critical issues
+
+## ➡️ Siguiente Fase
+Una vez features completas → **06-qa/**
+`
+    }
+  ];
+
+  for (const phase of phases) {
+    const filePath = path.join(projectPath, phase.dir, 'START_HERE.md');
+    await fs.writeFile(filePath, phase.content);
+  }
+}
+
+module.exports = { newProjectCommand };