awc-zns-mtd 2.5.0 → 2.6.1

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

@@ -1,6 +1,6 @@
 /**
  * Comando: new
- * Crea un nuevo proyecto con estructura completa AWC ZNS-MTD
+ * Crea un nuevo directorio de proyecto con configuración base AWC ZNS-MTD
  */
 
 const fs = require('fs-extra');
@@ -45,38 +45,23 @@ async function newProjectCommand(projectName, options = {}) {
     process.exit(1);
   }
 
-  // Preguntas de configuración
-  const answers = await inquirer.prompt([
+  // Preguntar responsable del proyecto
+  const { responsible, description, gitInit } = 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: 'responsible',
+      message: '👤 Responsable del proyecto:',
+      validate: (input) => {
+        if (!input.trim()) return 'El responsable es requerido';
+        return true;
+      }
     },
     {
       type: 'input',
       name: 'description',
-      message: '📝 Descripción breve del proyecto:',
+      message: '📝 Descripción breve (opcional):',
       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',
@@ -85,107 +70,45 @@ async function newProjectCommand(projectName, options = {}) {
     }
   ]);
 
-  const spinner = ora('Creando estructura del proyecto...').start();
+  const spinner = ora('Creando estructura base 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',
-      '01-comercial/docs/client-docs/requerimientos',
-      '01-comercial/docs/client-docs/presentaciones',
-      '01-comercial/docs/client-docs/contratos',
-      
-      // Fase 1: Inception
-      '02-inception/01-kickoff',
-      '02-inception/02-prd',
-      '02-inception/03-backlog',
-      '02-inception/04-release-planning',
-      '02-inception/docs/client-docs/procesos',
-      '02-inception/docs/client-docs/manuales',
-      '02-inception/docs/client-docs/imagenes',
-      
-      // Fase 2: Análisis
-      '03-analysis/01-code-audit',
-      '03-analysis/02-architecture-review',
-      '03-analysis/03-technical-debt',
-      '03-analysis/04-recommendations',
-      '03-analysis/docs/client-docs/arquitectura',
-      '03-analysis/docs/client-docs/databases',
-      '03-analysis/docs/client-docs/especificaciones',
-      
-      // Fase 3: Planificación
-      '04-planning/01-sprint-planning',
-      '04-planning/02-backlog-refinement',
-      '04-planning/03-release-planning',
-      '04-planning/04-roadmap',
-      '04-planning/docs/client-docs/historias',
-      '04-planning/docs/client-docs/estimaciones',
-      
-      // Fase 4: Desarrollo
-      '05-development/src',
-      '05-development/tests',
-      '05-development/docs',
-      '05-development/docs/client-docs/apis',
-      '05-development/docs/client-docs/integraciones',
-      '05-development/docs/client-docs/recursos',
-      
-      // Fase 5: QA
-      '06-qa/test-plans',
-      '06-qa/test-cases',
-      '06-qa/test-results',
-      '06-qa/bug-reports',
-      '06-qa/docs/client-docs/criterios-aceptacion',
-      '06-qa/docs/client-docs/escenarios-prueba',
-      
-      // Fase 6: Deployment
-      '07-deployment/environments',
-      '07-deployment/scripts',
-      '07-deployment/logs',
-      '07-deployment/docs/client-docs/infraestructura',
-      '07-deployment/docs/client-docs/accesos',
-      
-      // Fase 7: Soporte
-      '08-support/incidents',
-      '08-support/bug-fixes',
-      '08-support/maintenance',
-      '08-support/docs/client-docs/incidentes',
-      '08-support/docs/client-docs/cambios',
-      
-      // Documentación general
-      'docs/architecture',
-      'docs/adr',
-      'docs/api',
-      'docs/guides',
-      
-      // Configuración AWC
+    // 2. Crear estructura base mínima
+    const baseDirectories = [
       '.awc/agents',
       '.awc/workflows',
-      '.awc/templates'
+      '.awc/templates',
+      'docs'
     ];
 
-    for (const dir of directories) {
+    for (const dir of baseDirectories) {
       await fs.ensureDir(path.join(projectPath, dir));
     }
-    spinner.text = 'Estructura de directorios creada';
+    spinner.text = 'Estructura base creada';
 
-    // 3. Copiar templates
-    const srcTemplatesPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/templates');
-    const destTemplatesPath = path.join(projectPath, '.awc/templates');
+    // 3. Copiar agentes base (4 agentes core)
+    const srcAgentsPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/agents');
+    const destAgentsPath = path.join(projectPath, '.awc/agents');
     
-    if (await fs.pathExists(srcTemplatesPath)) {
-      await fs.copy(srcTemplatesPath, destTemplatesPath);
-      spinner.text = 'Templates copiados';
+    if (await fs.pathExists(srcAgentsPath)) {
+      await fs.copy(srcAgentsPath, destAgentsPath);
+      spinner.text = 'Agentes base copiados';
+    }
+
+    // 4. Copiar agentes especializados (22 agentes)
+    const srcCustomAgentsPath = path.join(__dirname, '../../../src/modules/custom-agents/cli/.awc-agents');
+    const destCustomAgentsPath = path.join(projectPath, '.awc/agents/specialized');
+    
+    if (await fs.pathExists(srcCustomAgentsPath)) {
+      await fs.copy(srcCustomAgentsPath, destCustomAgentsPath);
+      spinner.text = 'Agentes especializados copiados';
     }
 
-    // 4. Copiar workflows
+    // 5. Copiar workflows
     const srcWorkflowsPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/workflows');
     const destWorkflowsPath = path.join(projectPath, '.awc/workflows');
     
@@ -194,32 +117,33 @@ async function newProjectCommand(projectName, options = {}) {
       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');
+    // 6. Copiar templates
+    const srcTemplatesPath = path.join(__dirname, '../../../src/modules/awc-zns-mtd/templates');
+    const destTemplatesPath = path.join(projectPath, '.awc/templates');
     
-    if (await fs.pathExists(srcAgentsPath)) {
-      await fs.copy(srcAgentsPath, destAgentsPath);
-      spinner.text = 'Agentes copiados';
+    if (await fs.pathExists(srcTemplatesPath)) {
+      await fs.copy(srcTemplatesPath, destTemplatesPath);
+      spinner.text = 'Templates copiados';
     }
 
-    // 6. Crear archivo de configuración AWC
+    // 7. 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
+        description: description,
+        responsible: responsible
       },
+      projectType: null,
+      initialized: false,
       preferences: {
         communication_language: 'Spanish',
         document_output_language: 'Spanish',
         code_language: 'English'
       },
       workflows: {
-        current_phase: 'comercial',
+        current_phase: null,
         completed_phases: []
       }
     };
@@ -231,29 +155,21 @@ async function newProjectCommand(projectName, options = {}) {
     );
     spinner.text = 'Configuración AWC creada';
 
-    // 7. Crear README.md del proyecto
-    const readme = createReadmeContent(projectName, answers);
+    // 8. Crear README.md del proyecto
+    const readme = createReadmeContent(projectName, responsible, description);
     await fs.writeFile(path.join(projectPath, 'README.md'), readme);
     spinner.text = 'README.md creado';
 
-    // 8. Crear .gitignore
+    // 9. 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';
-
-    // 9.0. Crear README para client-docs
-    await createClientDocsReadmes(projectPath);
-    spinner.text = 'README de client-docs creados';
-
-    // 9.1. Crear configuración de VS Code
-    await createVSCodeConfig(projectPath);
+    // 10. Crear configuración de VS Code
+    await createVSCodeConfig(projectPath, projectName);
     spinner.text = 'Configuración VS Code creada';
 
-    // 9.2. Copiar copilot-instructions.md
+    // 11. Copiar copilot-instructions.md
     const githubDir = path.join(projectPath, '.github');
     await fs.ensureDir(githubDir);
     const templateCopilotPath = path.join(__dirname, '../../../templates/.github/copilot-instructions.md');
@@ -262,8 +178,13 @@ async function newProjectCommand(projectName, options = {}) {
       spinner.text = 'GitHub Copilot instructions creadas';
     }
 
-    // 10. Inicializar Git si se solicitó
-    if (answers.gitInit) {
+    // 12. Crear archivo NEXT_STEPS.md
+    const nextSteps = createNextStepsContent(projectName);
+    await fs.writeFile(path.join(projectPath, 'NEXT_STEPS.md'), nextSteps);
+    spinner.text = 'Guía de próximos pasos creada';
+
+    // 13. Inicializar Git si se solicitó
+    if (gitInit) {
       const { execSync } = require('child_process');
       try {
         execSync('git init', { cwd: projectPath, stdio: 'ignore' });
@@ -282,36 +203,25 @@ async function newProjectCommand(projectName, options = {}) {
 
     // Mostrar resumen
     console.log(chalk.cyan('\n' + '═'.repeat(60)));
-    console.log(chalk.cyan('📦 Resumen del Proyecto'));
+    console.log(chalk.cyan('📦 Proyecto Creado'));
     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('Responsable:')}   ${chalk.yellow(responsible)}`);
     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'));
+    console.log(`  ${chalk.green('2.')} awc init ${chalk.gray('# Inicializar tipo de proyecto')}`);
+    console.log(`  ${chalk.green('3.')} Leer ${chalk.yellow('NEXT_STEPS.md')} para más detalles\n`);
+
+    console.log(chalk.yellow('⚠️  La estructura de fases se creará al ejecutar') + chalk.green(' awc init\n'));
 
   } catch (error) {
     spinner.fail(chalk.red('❌ Error creando proyecto'));
+    console.error(error);
     throw error;
   }
 }
@@ -319,95 +229,57 @@ async function newProjectCommand(projectName, options = {}) {
 /**
  * Crea el contenido del README.md
  */
-function createReadmeContent(projectName, answers) {
+function createReadmeContent(projectName, responsible, description) {
   return `# ${projectName}
 
-> ${answers.description}
+> ${description}
 
 ## 📋 Información del Proyecto
 
-- **Tipo**: ${answers.projectType}
-- **Equipo**: ${answers.teamSize}
+- **Responsable**: ${responsible}
 - **Metodología**: AWC ZNS-MTD (Zen, Neutro, Sistemático)
+- **Estado**: Pendiente de inicialización
 
-## 🚀 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
+## 🚀 Próximos Pasos
 
-## 🔧 Configuración AWC
+Este proyecto ha sido creado con la estructura base de AWC ZNS-MTD.
 
-El directorio \`.awc/\` contiene:
+### 1. Inicializar Tipo de Proyecto
 
-- \`agents/\` - Agentes especializados AWC ZNS-MTD
-- \`workflows/\` - Workflows para cada fase
-- \`templates/\` - Templates de documentos
-- \`config.json\` - Configuración del proyecto
+\`\`\`bash
+awc init
+\`\`\`
 
-## 🎯 Estado Actual
+El comando \`awc init\` te preguntará:
+- Tipo de proyecto (auditoría, desarrollo nuevo, migración, etc.)
+- Tecnologías a utilizar
+- Tipo de workflow (quick, standard, enterprise)
 
-**Fase actual**: Comercial (inicio)
+Basado en tus respuestas, creará automáticamente:
+- ✅ Estructura de directorios por fase
+- ✅ Directorios client-docs específicos
+- ✅ Templates relevantes para tu proyecto
+- ✅ Workflows configurados
 
-Revisar \`01-comercial/START_HERE.md\` para comenzar.
+### 2. Comenzar a Trabajar
 
-## 📝 Comandos AWC
+Una vez inicializado, seguir las guías en cada fase del proyecto.
+
+## 🔧 Configuración AWC
+
+El directorio \`.awc/\` contiene:
+
+- \`agents/\` - 4 agentes base + 22 agentes especializados
+- \`workflows/\` - 8 workflows completos
+- \`templates/\` - 7 templates profesionales
+- \`config.json\` - Configuración del proyecto
+
+## 📝 Comandos Disponibles
 
 \`\`\`bash
+# Inicializar proyecto (siguiente paso)
+awc init
+
 # Ver estado del proyecto
 awc status
 
@@ -420,7 +292,7 @@ awc config
 
 ---
 
-Generado con ❤️ usando AWC ZNS-MTD Method
+Generado con ❤️ usando AWC ZNS-MTD Method v${getVersion()}
 `;
 }
 
@@ -449,7 +321,6 @@ target/
 *.swp
 *.swo
 *~
-.DS_Store
 
 # Logs
 logs/
@@ -478,550 +349,137 @@ coverage/
 .nyc_output/
 
 # Confidential (keep locally, never commit)
-01-comercial/04-contract/*.pdf
-**/confidential/
+**/client-docs/contratos/
+**/client-docs/accesos/
 **/*-confidential.*
 `;
 }
 
 /**
- * Crea guías de inicio para cada fase
+ * Crea contenido de NEXT_STEPS.md
  */
-async function createPhaseGuides(projectPath) {
-  const phases = [
-    {
-      dir: '01-comercial',
-      title: 'Fase 0: Comercial',
-      content: `# 🎯 START HERE - Fase Comercial
+function createNextStepsContent(projectName) {
+  return `# 🎯 Próximos Pasos - ${projectName}
+
+## ¿Qué hacer ahora?
 
-## Objetivo
-Capturar requisitos del cliente, evaluar viabilidad y generar oferta comercial.
+Tu proyecto ha sido creado con la **estructura base** de AWC ZNS-MTD.
 
-## Pasos a seguir
+### 📌 Paso 1: Inicializar el Proyecto
 
-### 1. Discovery & Prospección
-📂 Directorio: \`01-prospection/\`
+Ejecuta el comando de inicialización:
 
-- [ ] Completar \`.awc/templates/discovery-notes.md\`
-- [ ] Identificar stakeholders clave
-- [ ] Entender el problema de negocio
-- [ ] Documentar contexto actual
+\`\`\`bash
+awc init
+\`\`\`
 
-### 2. Análisis de Viabilidad
-📂 Directorio: \`01-prospection/\`
+### 🔍 ¿Qué hace \`awc init\`?
 
-- [ ] Completar \`.awc/templates/viabilidad.md\`
-- [ ] Evaluar viabilidad técnica
-- [ ] Evaluar viabilidad económica
-- [ ] Identificar riesgos principales
+El comando \`awc init\` te preguntará:
 
-### 3. Oferta Técnica
-📂 Directorio: \`02-technical-proposal/\`
+#### 1️⃣ Tipo de Proyecto
+- **🔍 Auditoría de Código Existente**: Evaluar sistema legacy
+- **🆕 Desarrollo Desde Cero**: Nuevo proyecto desde cero
+- **🔄 Migración/Modernización**: Migrar sistema existente
+- **🛠️ Mantenimiento/Soporte**: Dar soporte a sistema existente
+- **📱 Aplicación Móvil**: App iOS/Android
+- **🌐 API/Microservicios**: Backend services
+- **🏢 Sistema Empresarial**: ERP, CRM, etc.
 
-- [ ] Copiar template: \`.awc/templates/oferta-comercial.md\`
-- [ ] Definir solución propuesta
-- [ ] Especificar stack tecnológico
-- [ ] Definir alcance y exclusiones
+#### 2️⃣ Workflow Recomendado
+- **⚡ Quick**: Proyectos pequeños (1-2 semanas)
+- **📊 Standard**: Proyectos medianos (1-3 meses)
+- **🏢 Enterprise**: Proyectos grandes (3+ meses)
 
-### 4. Cotización
-📂 Directorio: \`03-quotation/\`
+#### 3️⃣ Stack Tecnológico
+- Backend: Java, .NET, Python, PHP, Node.js
+- Frontend: React, Angular, Vue
+- Base de datos: SQL, NoSQL
 
-- [ ] Copiar template: \`.awc/templates/cotizacion.md\`
-- [ ] Estimar esfuerzo por fase
-- [ ] Calcular costos
-- [ ] Definir cronograma
+### ✅ Resultado de \`awc init\`
 
-### 5. Contrato (confidencial)
-📂 Directorio: \`04-contract/\`
+Basado en tus respuestas, creará automáticamente:
 
-- [ ] Negociar términos
-- [ ] Firmar contrato
-- [ ] Mover a siguiente fase
+- ✅ **Estructura de fases** (01-comercial, 02-inception, 03-analysis, etc.)
+- ✅ **Directorios client-docs/** específicos para tu tipo de proyecto
+- ✅ **Templates** relevantes copiados a cada fase
+- ✅ **Agentes especializados** cargados según tu stack
+- ✅ **Guías START_HERE.md** en cada fase
 
-## ✅ Criterios de Salida
-- ✅ Contrato firmado
-- ✅ Cliente aprobó oferta y cotización
-- ✅ Equipo asignado
-- ✅ Fecha de kickoff definida
+### 📂 Ejemplos de Estructura Según Tipo
 
-## ➡️ 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
+**Auditoría de Código**:
+\`\`\`
+proyecto/
+├── 01-comercial/          # Discovery y contrato
+├── 03-analysis/           # PRINCIPAL: Auditoría completa
+│   ├── docs/client-docs/  # Código existente del cliente
+│   └── reports/           # Reportes de auditoría
+├── 04-planning/           # Plan de mejoras
+└── 08-support/            # Recomendaciones
+\`\`\`
 
-## Objetivo
-Implementar user stories siguiendo TDD y mejores prácticas.
+**Desarrollo Desde Cero**:
+\`\`\`
+proyecto/
+├── 01-comercial/          # Discovery
+├── 02-inception/          # PRINCIPAL: PRD y diseño
+├── 04-planning/           # Sprints
+├── 05-development/        # PRINCIPAL: Implementación
+│   ├── src/
+│   └── tests/
+├── 06-qa/                 # Testing
+└── 07-deployment/         # Despliegue
+\`\`\`
 
-## Estructura
+**Migración/Modernización**:
 \`\`\`
-05-development/
-├── src/           # Código fuente
-├── tests/         # Tests (unit, integration, e2e)
-└── docs/          # Documentación técnica
+proyecto/
+├── 01-comercial/          # Análisis de viabilidad
+├── 03-analysis/           # PRINCIPAL: Análisis de sistema legacy
+│   ├── docs/client-docs/  # Documentación sistema actual
+│   └── migration-plan/
+├── 05-development/        # Desarrollo nuevo sistema
+└── 07-deployment/         # Plan de migración
 \`\`\`
 
-## 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/**
-`
-    }
-  ];
+### 🎯 Comandos Útiles
 
-  for (const phase of phases) {
-    const filePath = path.join(projectPath, phase.dir, 'START_HERE.md');
-    await fs.writeFile(filePath, phase.content);
-  }
-}
+\`\`\`bash
+# Inicializar proyecto
+awc init
 
-/**
- * Crea README.md en directorios client-docs
- */
-async function createClientDocsReadmes(projectPath) {
-  const clientDocsReadmes = [
-    {
-      path: '01-comercial/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Comercial
-
-Este directorio contiene toda la documentación proporcionada por el cliente durante la fase comercial.
-
-## 📂 Estructura
-
-### requerimientos/
-Documentos de requerimientos del cliente:
-- PDFs con especificaciones funcionales
-- Word con listados de requerimientos
-- Excel con matrices de requerimientos
-- Presentaciones con necesidades del negocio
-
-### presentaciones/
-Presentaciones del cliente:
-- Decks ejecutivos
-- Presentaciones de producto actual
-- Material de marketing
-- Diagramas de flujo de negocio
-
-### contratos/
-Documentos contractuales (CONFIDENCIAL):
-- Contratos firmados
-- NDAs
-- SOWs (Statement of Work)
-- Anexos contractuales
-
-⚠️ **IMPORTANTE**: Los archivos en \`contratos/\` están en .gitignore por defecto.
-
-## 📝 Buenas Prácticas
-
-1. **Nomenclatura**: Usar formato \`YYYYMMDD-nombre-descriptivo.ext\`
-   - ✅ \`20260107-requerimientos-funcionales-v1.pdf\`
-   - ❌ \`documento.pdf\`
-
-2. **Versionado**: Incluir versión en el nombre
-   - \`requerimientos-v1.0.docx\`
-   - \`requerimientos-v1.1.docx\`
-
-3. **Organización**: Un archivo por tipo de documento
-   - No mezclar requerimientos con contratos
-   - Mantener presentaciones separadas
-
-4. **Respaldo**: Mantener originales intactos
-   - No editar documentos del cliente
-   - Crear copias de trabajo si es necesario
-`
-    },
-    {
-      path: '02-inception/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Inception
-
-Este directorio contiene la documentación del cliente relevante para el inicio del proyecto.
-
-## 📂 Estructura
-
-### procesos/
-Diagramas y documentación de procesos actuales:
-- Diagramas de flujo (BPMN, Visio)
-- Mapas de procesos de negocio
-- Descripciones de workflows actuales
-- Casos de uso documentados
-
-### manuales/
-Manuales de usuario de sistemas existentes:
-- Manuales de usuario en PDF/Word
-- Guías de operación
-- Documentación de sistemas legacy
-- FAQs del sistema actual
-
-### imagenes/
-Material visual del cliente:
-- Screenshots de sistemas actuales
-- Wireframes/mockups proporcionados
-- Logos y branding guidelines
-- Fotografías de procesos físicos
-- Diagramas y esquemas
-
-## 📝 Uso Recomendado
-
-**procesos/**: Usar para entender flujos actuales y diseñar mejoras
-**manuales/**: Referencia para features esperados en el nuevo sistema  
-**imagenes/**: Material visual para PRD y documentación
-
-## ⚠️ Importante
-- Estos documentos son REFERENCIA, no especificaciones finales
-- Validar con stakeholders antes de implementar
-- Mantener trazabilidad con el PRD
-`
-    },
-    {
-      path: '03-analysis/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Análisis
-
-Documentación técnica del cliente para auditoría y análisis.
-
-## 📂 Estructura
-
-### arquitectura/
-Diagramas arquitectónicos actuales:
-- Diagramas de arquitectura (C4, UML)
-- Diagramas de red e infraestructura
-- Diagramas de componentes
-- Documentos de diseño técnico
-
-### databases/
-Documentación de bases de datos:
-- Esquemas de base de datos (ERD)
-- Modelos de datos en PDF/Visio
-- Scripts SQL de estructura
-- Diccionarios de datos
-- Excel con tablas y campos
-
-### especificaciones/
-Especificaciones técnicas:
-- Documentos de APIs existentes (Swagger, Postman)
-- Especificaciones de interfaces
-- Protocolos de integración
-- Documentación de servicios web
-
-## 🎯 Objetivo
-
-Entender la arquitectura actual para:
-- Identificar technical debt
-- Planificar migraciones
-- Diseñar integraciones
-- Evaluar impacto de cambios
-
-## 📊 Artefactos Generados
-
-A partir de esta documentación, el equipo AWC generará:
-- Reporte de auditoría de código
-- Análisis de arquitectura
-- Assessment de technical debt
-- Recomendaciones de mejora
-`
-    },
-    {
-      path: '04-planning/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Planificación
-
-Documentación del cliente para planificación de sprints.
-
-## 📂 Estructura
-
-### historias/
-User stories y casos de uso del cliente:
-- Word/Excel con historias de usuario
-- Casos de uso detallados
-- Escenarios de negocio
-- Criterios de aceptación iniciales
-
-### estimaciones/
-Material para estimación:
-- Hojas de cálculo con estimaciones del cliente
-- Referencias de proyectos similares
-- Benchmarks de performance esperado
-- Constraints de tiempo/presupuesto
-
-## 💡 Uso
-
-Esta documentación ayuda a:
-- Refinar user stories del backlog
-- Validar estimaciones del equipo
-- Alinear expectativas de tiempos
-- Priorizar features según negocio
-`
-    },
-    {
-      path: '05-development/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Desarrollo
-
-Recursos técnicos del cliente necesarios para implementación.
-
-## 📂 Estructura
-
-### apis/
-Documentación de APIs a integrar:
-- Swagger/OpenAPI specs
-- Colecciones de Postman
-- WSDL de servicios SOAP
-- Documentación de endpoints REST
-- Credenciales de acceso (sandbox/test)
-
-### integraciones/
-Sistemas externos a integrar:
-- Manuales de integración
-- Diagramas de flujo de integración
-- Mappings de campos
-- Ejemplos de payloads XML/JSON
-- Certificados SSL/TLS
-
-### recursos/
-Assets para la aplicación:
-- Imágenes para UI (logos, iconos)
-- Archivos de diseño (Figma, Sketch exports)
-- Fuentes corporativas
-- Guidelines de branding
-- Templates de documentos
-
-## 🔧 Integración
-
-**Antes de integrar**:
-1. Validar credenciales en ambiente de pruebas
-2. Revisar rate limits y SLAs
-3. Documentar endpoints en Swagger local
-4. Crear tests de integración
-
-**Durante desarrollo**:
-- Mantener colecciones de Postman actualizadas
-- Documentar cambios en APIs
-- Reportar issues de integración al cliente
-`
-    },
-    {
-      path: '06-qa/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase QA
-
-Material del cliente para validación y pruebas.
-
-## 📂 Estructura
-
-### criterios-aceptacion/
-Criterios de aceptación del cliente:
-- Excel/Word con criterios de aceptación
-- Checklist de features esperados
-- Requerimientos no funcionales (SLA, performance)
-- Escenarios de validación de negocio
-
-### escenarios-prueba/
-Escenarios de prueba proporcionados:
-- Casos de prueba del cliente
-- Datos de prueba (datasets CSV/Excel)
-- Scripts de carga de datos
-- Escenarios end-to-end prioritarios
-
-## ✅ Validación
-
-Esta documentación se usa para:
-1. Crear test cases alineados con expectativas
-2. Generar datos de prueba realistas
-3. Validar acceptance criteria
-4. Preparar UAT con el cliente
-
-## 📋 UAT (User Acceptance Testing)
-
-Coordinar con cliente:
-- [ ] Ambiente de UAT preparado
-- [ ] Usuarios de prueba creados
-- [ ] Datasets cargados
-- [ ] Sesiones de UAT agendadas
-- [ ] Formulario de signoff preparado
-`
-    },
-    {
-      path: '07-deployment/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Deployment
-
-Información de infraestructura del cliente para deployment.
-
-## 📂 Estructura
-
-### infraestructura/
-Documentación de infraestructura del cliente:
-- Diagramas de red
-- Especificaciones de servidores
-- Configuraciones de firewalls
-- IPs y rangos asignados
-- Políticas de seguridad
-
-### accesos/
-Credenciales y accesos (CONFIDENCIAL):
-- Credenciales de servidores
-- VPN configs
-- Certificados SSL
-- API keys de producción
-- Passwords de bases de datos
-
-⚠️ **CRÍTICO**: 
-- Archivos en esta carpeta están en .gitignore
-- Usar gestor de secretos (Azure Key Vault, AWS Secrets Manager)
-- NUNCA commitear credenciales al repositorio
-
-## 🚀 Pre-Deployment Checklist
-
-- [ ] Accesos a servidores validados
-- [ ] VPN configurada y probada
-- [ ] DNS apuntando correctamente
-- [ ] Certificados SSL instalados
-- [ ] Firewall rules configurados
-- [ ] Backup de producción realizado
-`
-    },
-    {
-      path: '08-support/docs/client-docs/README.md',
-      content: `# 📄 Documentación del Cliente - Fase Soporte
-
-Documentación de incidentes y solicitudes del cliente.
-
-## 📂 Estructura
-
-### incidentes/
-Reportes de incidentes del cliente:
-- Screenshots de errores
-- Logs proporcionados por el cliente
-- Videos reproduciendo issues
-- Reportes de usuarios finales
-
-### cambios/
-Solicitudes de cambio:
-- Change requests (PDFs/Word)
-- Nuevos requerimientos post-lanzamiento
-- Solicitudes de mejoras
-- Feedback de usuarios
-
-## 🎫 Gestión de Incidentes
-
-**Flujo recomendado**:
-1. Cliente reporta → Copiar evidencia a \`incidentes/\`
-2. Crear ticket en sistema de tracking
-3. Reproducir y documentar en \`08-support/incidents/\`
-4. Resolver y validar con cliente
-
-**Nomenclatura**:
-- \`INC-001-descripcion-corta/\` (subdirectorio por incidente)
-- Dentro: screenshots, logs, análisis, solución
-
-## 📝 Change Requests
-
-**Evaluación**:
-1. Cliente envía CR → Guardar en \`cambios/\`
-2. Equipo analiza impacto (tiempo/costo)
-3. Aprobar/rechazar con justificación
-4. Si aprobado → Crear user stories en backlog
-`
-    }
-  ];
+# Ver estado actual
+awc status
 
-  for (const readme of clientDocsReadmes) {
-    const filePath = path.join(projectPath, readme.path);
-    await fs.writeFile(filePath, readme.content);
-  }
+# Validar estructura
+awc validate
+
+# Ver configuración
+awc config
+\`\`\`
+
+### 📚 Más Información
+
+- **Documentación**: [README.md](./README.md)
+- **Agentes**: Revisa \`.awc/agents/\` para ver los 26 agentes disponibles
+- **Workflows**: Consulta \`.awc/workflows/\` para ver los 8 workflows
+- **Templates**: Usa \`.awc/templates/\` para documentos profesionales
+
+---
+
+🚀 **¡Listo para empezar!** Ejecuta \`awc init\` ahora.
+`;
 }
 
 /**
  * Crea configuración de VS Code para cargar AWC automáticamente
  */
-async function createVSCodeConfig(projectPath) {
+async function createVSCodeConfig(projectPath, projectName) {
   const vscodeDir = path.join(projectPath, '.vscode');
   await fs.ensureDir(vscodeDir);
 
-  // settings.json - Configuración de workspace
+  // settings.json
   const settings = {
     "github.copilot.enable": {
       "*": true
@@ -1051,7 +509,7 @@ async function createVSCodeConfig(projectPath) {
     { spaces: 2 }
   );
 
-  // extensions.json - Extensiones recomendadas
+  // extensions.json
   const extensions = {
     "recommendations": [
       "github.copilot",
@@ -1067,12 +525,12 @@ async function createVSCodeConfig(projectPath) {
     { spaces: 2 }
   );
 
-  // AWC-ZNS-MTD.code-workspace - Workspace file
+  // workspace file
   const workspace = {
     "folders": [
       {
         "path": ".",
-        "name": path.basename(projectPath)
+        "name": projectName
       }
     ],
     "settings": {
@@ -1090,7 +548,7 @@ async function createVSCodeConfig(projectPath) {
   };
 
   await fs.writeJson(
-    path.join(projectPath, `${path.basename(projectPath)}.code-workspace`),
+    path.join(projectPath, `${projectName}.code-workspace`),
     workspace,
     { spaces: 2 }
   );