awc-zns-mtd 2.6.0 → 2.6.1

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

@@ -135,7 +135,7 @@ async function newProjectCommand(projectName, options = {}) {
         description: description,
         responsible: responsible
       },
-      projectType: null, // Se definirá con awc init
+      projectType: null,
       initialized: false,
       preferences: {
         communication_language: 'Spanish',
@@ -221,6 +221,7 @@ async function newProjectCommand(projectName, options = {}) {
 
   } catch (error) {
     spinner.fail(chalk.red('❌ Error creando proyecto'));
+    console.error(error);
     throw error;
   }
 }
@@ -293,338 +294,6 @@ awc config
 
 Generado con ❤️ usando AWC ZNS-MTD Method v${getVersion()}
 `;
-}
-
-    // 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
-      '.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';
-
-    // 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);
-    spinner.text = 'Configuración VS Code creada';
-
-    // 9.2. Copiar copilot-instructions.md
-    const githubDir = path.join(projectPath, '.github');
-    await fs.ensureDir(githubDir);
-    const templateCopilotPath = path.join(__dirname, '../../../templates/.github/copilot-instructions.md');
-    if (await fs.pathExists(templateCopilotPath)) {
-      await fs.copy(templateCopilotPath, path.join(githubDir, 'copilot-instructions.md'));
-      spinner.text = 'GitHub Copilot instructions 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
-`;
 }
 
 /**
@@ -652,7 +321,6 @@ target/
 *.swp
 *.swo
 *~
-.DS_Store
 
 # Logs
 logs/
@@ -681,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
@@ -1254,7 +509,7 @@ async function createVSCodeConfig(projectPath) {
     { spaces: 2 }
   );
 
-  // extensions.json - Extensiones recomendadas
+  // extensions.json
   const extensions = {
     "recommendations": [
       "github.copilot",
@@ -1270,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": {
@@ -1293,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 }
   );