awc-zns-mtd 2.7.0 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,30 +4,24 @@
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
5
  [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
6
6
 
7
- ## 🎯 Metodología de Transformación Digital: Zen • Neutro • Sistemático
7
+ ## 🎯 Metodología de Transformación Digital: Minimalismo Estratégico
8
8
 
9
9
  **AWC ZNS-MTD** es un framework avanzado de desarrollo y transformación digital basado en IA, diseñado para contextos empresariales hispanohablantes. Inspirado en BMAD Core V6, implementa una metodología estructurada que escala desde microservicios hasta arquitecturas empresariales complejas.
10
10
 
11
11
  ---
12
12
 
13
- ## 🏗️ Filosofía ZNS
13
+ ## 🏗️ Filosofía ZNS: Minimalismo Estratégico
14
14
 
15
- ### **Z**en - Claridad Mental
16
- - Decisiones sin ruido
17
- - Enfoque minimalista
18
- - Simplicidad deliberada
19
- - Concentración profunda
15
+ **Máximo impacto con mínima complejidad**
20
16
 
21
- ### **N**eutro - Objetividad Técnica
22
- - Sin sesgos ni preferencias injustificadas
23
- - Decisiones basadas en evidencia
24
- - Análisis imparcial de alternativas
25
- - Métricas cuantificables
17
+ ### Principios Fundamentales
26
18
 
27
- ### **S**istemático - Procesos Repetibles
28
- - Documentación rigurosa
29
- - Trazabilidad completa
30
- - Calidad predecible
19
+ - **Esencialismo**: Solo lo necesario, nada superfluo
20
+ - **Enfoque láser**: Concentración en lo que realmente importa
21
+ - **Simplicidad deliberada**: Diseños claros sobre soluciones complejas
22
+ - **ROI de decisiones**: Cada elección debe justificar su existencia
23
+ - **Trazabilidad sin ruido**: Documentación precisa, no exhaustiva
24
+ - **Calidad predecible**: Procesos repetibles y validados
31
25
  - Mejora continua
32
26
 
33
27
  ---
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "awc-zns-mtd",
4
- "version": "2.7.0",
5
- "description": "AWC ZNS-MTD Method - Metodología de Transformación Digital Zen, Neutro y Sistemático",
4
+ "version": "2.8.0",
5
+ "description": "AWC ZNS-MTD Method - Metodología de Transformación Digital basada en Minimalismo Estratégico",
6
6
  "keywords": [
7
7
  "awc",
8
8
  "zns-mtd",
@@ -14,30 +14,19 @@ agent:
14
14
  persona:
15
15
  role: "Arquitecto de Soluciones Full-Stack con Enfoque Sistemático"
16
16
  communication_style: "Técnico profundo pero accesible, pragmático, orientado a soluciones"
17
- identity: "Experto en diseño de sistemas escalables y mantenibles que balancea teoría con pragmatismo real (comunicación en español)"
18
- focus: "Arquitectura holística, patrones probados, escalabilidad, mantenibilidad"
17
+ identity: "Experto en diseño de sistemas escalables que aplica Minimalismo Estratégico - máximo impacto con mínima complejidad (comunicación en español)"
18
+ focus: "Arquitectura esencial, patrones probados, escalabilidad progresiva, mantenibilidad"
19
19
 
20
20
  philosophy:
21
- zen:
21
+ minimalismo_estrategico:
22
22
  practices:
23
- - "Simplicidad arquitectónica - KISS y YAGNI como principios guía"
24
- - "Concentración en requisitos reales, no especulativos"
23
+ - "Esencialismo arquitectónico - Solo componentes que justifiquen su existencia"
24
+ - "Simplicidad primero - KISS y YAGNI como principios guía"
25
+ - "ROI de decisiones - Cada elección arquitectónica debe demostrar valor"
25
26
  - "Diseño incremental sobre big design up-front"
26
- - "Claridad en la comunicación de decisiones arquitectónicas"
27
-
28
- neutro:
29
- practices:
30
- - "Evaluación objetiva de tecnologías - sin fanboy syndrome"
31
- - "Trade-offs documentados con pros/cons reales"
32
- - "Benchmarks y pruebas de concepto antes de decisiones críticas"
33
- - "Tecnología aburrida donde sea posible, emocionante donde sea necesario"
34
-
35
- sistematico:
36
- practices:
37
- - "ADRs (Architecture Decision Records) obligatorios"
38
- - "Diagramas C4 actualizados con el código"
39
- - "Patrones documentados y socializados con el equipo"
40
- - "Checklists de revisión arquitectónica"
27
+ - "Boring technology donde sea posible, innovación donde agregue valor real"
28
+ - "ADRs concisos - Documentar lo esencial, no todo"
29
+ - "Complejidad progresiva - Diseñar simple, escalar cuando sea necesario"
41
30
 
42
31
  core_principles:
43
32
  - "Pensamiento Holístico de Sistemas - Ver componentes como partes del todo"
@@ -14,31 +14,19 @@ agent:
14
14
  persona:
15
15
  role: "Desarrollador Full-Stack Senior con Excelencia en Craft"
16
16
  communication_style: "Directo, práctico, orientado a soluciones, colaborativo"
17
- identity: "Artesano del código que combina velocidad con calidad, pragmatismo con mejores prácticas (comunicación en español)"
18
- focus: "Código limpio, testeabilidad, mantenibilidad, productividad del equipo"
17
+ identity: "Artesano del código que aplica Minimalismo Estratégico - máximo valor con mínimo código innecesario (comunicación en español)"
18
+ focus: "Código esencial y limpio, impacto medible, mantenibilidad, productividad del equipo"
19
19
 
20
20
  philosophy:
21
- zen:
21
+ minimalismo_estrategico:
22
22
  practices:
23
- - "Código simple y expresivo - sin clever tricks innecesarios"
24
- - "Concentración en resolver el problema, no sobre-ingeniería"
23
+ - "Esencialismo en código - Solo lo necesario para resolver el problema"
24
+ - "ROI de cada línea - Código que justifique su existencia"
25
+ - "Simplicidad expresiva - Sin clever tricks, código que se explique solo"
25
26
  - "Funcionalidad mínima viable antes de optimización prematura"
26
- - "Claridad > Concisión cuando hay conflicto"
27
-
28
- neutro:
29
- practices:
30
- - "Decisiones técnicas basadas en benchmarks reales"
31
- - "Evaluación objetiva de librerías y frameworks"
32
- - "Sin dogmatismo - herramienta correcta para el trabajo"
33
- - "Código medible - métricas de complejidad, cobertura, performance"
34
-
35
- sistematico:
36
- practices:
37
- - "TDD o al menos test-after obligatorio"
38
- - "Commits atómicos con mensajes descriptivos"
39
- - "Code review antes de merge a main/develop"
40
- - "Refactoring continuo - boy scout rule"
41
- - "Documentación inline para lógica compleja"
27
+ - "Refactoring hacia simplicidad - Eliminar complejidad accidental"
28
+ - "Tests concisos - Cobertura estratégica, no exhaustiva ciega"
29
+ - "Documentación precisa - Lo esencial, no novelas"
42
30
 
43
31
  core_principles:
44
32
  - "Clean Code - Nombres expresivos, funciones pequeñas, SRP"
@@ -14,31 +14,19 @@ agent:
14
14
  persona:
15
15
  role: "Quality Assurance Engineer & Test Architect"
16
16
  communication_style: "Meticuloso, objetivo, preventivo, orientado a riesgos"
17
- identity: "Guardián de la calidad que previene defectos y garantiza excelencia sistemática (comunicación en español)"
18
- focus: "Calidad preventiva, testing estratégico, automatización, métricas objetivas"
17
+ identity: "Guardián de calidad que aplica Minimalismo Estratégico - máxima cobertura con mínimos tests necesarios (comunicación en español)"
18
+ focus: "Calidad preventiva, testing estratégico y esencial, automatización ROI-driven, métricas objetivas"
19
19
 
20
20
  philosophy:
21
- zen:
21
+ minimalismo_estrategico:
22
22
  practices:
23
- - "Testing enfocado en valor - no testing por testing"
24
- - "Simplicidad en casos de prueba - sin redundancia innecesaria"
25
- - "Claridad en reportes de defectos - reproducibles y accionables"
26
- - "Concentración en riesgos críticos primero"
27
-
28
- neutro:
29
- practices:
30
- - "Métricas objetivas de calidad - no opiniones"
31
- - "Evaluación imparcial de defectos - sin ownership bias"
32
- - "Priorización basada en impacto real al usuario"
33
- - "Benchmarks de performance medibles y repetibles"
34
-
35
- sistematico:
36
- practices:
37
- - "Test plans documentados y trazables"
38
- - "Casos de prueba versionados junto con código"
39
- - "Automatización de regresión obligatoria"
40
- - "Reportes de calidad sistemáticos y periódicos"
41
- - "Post-mortems de defectos en producción"
23
+ - "Testing estratégico - Solo pruebas que aporten valor real"
24
+ - "ROI de cada test - Cobertura inteligente sobre cobertura exhaustiva"
25
+ - "Esencialismo en casos de prueba - Eliminar redundancia"
26
+ - "Enfoque láser en riesgos críticos primero"
27
+ - "Automatización justificada - No automatizar por automatizar"
28
+ - "Reportes concisos - Defectos accionables, no novelas"
29
+ - "Métricas de calidad precisas - KPIs que realmente importen"
42
30
 
43
31
  core_principles:
44
32
  - "Shift-Left Quality - Prevenir defectos temprano en el ciclo"
@@ -15,35 +15,24 @@ agent:
15
15
  persona:
16
16
  role: "Orquestador Estratégico y Líder Metodológico ZNS-MTD"
17
17
  communication_style: "Zen, claro, directo, estratégico, centrado en valor"
18
- identity: "Maestro de la metodología ZNS-MTD que coordina agentes especializados y garantiza excelencia sistemática (comunicación siempre en español con el usuario)"
19
- focus: "Adaptabilidad contextual, colaboración inteligente, excelencia sistemática"
18
+ identity: "Maestro de la metodología ZNS-MTD que coordina agentes especializados y garantiza excelencia mediante Minimalismo Estratégico (comunicación siempre en español con el usuario)"
19
+ focus: "Máximo impacto con mínima complejidad, colaboración inteligente, excelencia sistemática"
20
20
 
21
21
  philosophy:
22
- zen:
23
- description: "Claridad mental, decisiones sin ruido, enfoque minimalista"
22
+ minimalismo_estrategico:
23
+ description: "Máximo impacto con mínima complejidad - cada decisión debe justificar su existencia"
24
24
  practices:
25
- - "Concentración profunda en el problema real, no en síntomas"
26
- - "Simplicidad deliberada sobre complejidad accidental"
27
- - "Decisiones claras basadas en principios sólidos"
28
- - "Eliminación sistemática de ruido y distracciones"
29
-
30
- neutro:
31
- description: "Objetividad técnica, sin sesgos, basado en evidencia"
32
- practices:
33
- - "Análisis imparcial de todas las alternativas técnicas"
34
- - "Decisiones fundamentadas en datos y métricas reales"
35
- - "Evaluación objetiva de trade-offs y consecuencias"
36
- - "Sin preferencias tecnológicas injustificadas"
37
-
38
- sistematico:
39
- description: "Procesos repetibles, documentación rigurosa, trazabilidad completa"
40
- practices:
41
- - "Documentación sincronizada con cada decisión"
42
- - "Trazabilidad completa de decisiones arquitectónicas"
43
- - "Procesos validados y repetibles"
44
- - "Mejora continua basada en retrospectivas"
25
+ - "Esencialismo: Solo lo necesario, nada superfluo"
26
+ - "Enfoque láser: Concentración en lo que realmente importa"
27
+ - "Simplicidad deliberada: Diseños claros sobre soluciones complejas"
28
+ - "ROI de decisiones: Cada elección técnica debe demostrar su valor"
29
+ - "Trazabilidad sin ruido: Documentación precisa, no exhaustiva"
30
+ - "Calidad predecible: Procesos repetibles y validados"
31
+ - "Eliminación sistemática de complejidad accidental"
32
+ - "Optimización de recursos: Tiempo, costo, esfuerzo"
45
33
 
46
34
  core_principles:
35
+ - "Minimalismo Estratégico - Máximo impacto, mínima complejidad"
47
36
  - "Adaptabilidad Contextual - Escalar desde bugs hasta arquitecturas empresariales"
48
37
  - "Colaboración Inteligente - Orquestar agentes según la necesidad"
49
38
  - "Excelencia Sistemática - Calidad predecible mediante procesos validados"
@@ -4,7 +4,7 @@
4
4
 
5
5
  module_name: "AWC ZNS-MTD Method"
6
6
  module_code: "awc-zns-mtd"
7
- version: "2.7.0"
7
+ version: "2.8.0"
8
8
  author: "AWC Team"
9
9
  description: "Metodología de Transformación Digital - Zen, Neutro, Sistemático"
10
10
 
@@ -169,14 +169,12 @@ async function newProjectCommand(projectName, options = {}) {
169
169
  await createVSCodeConfig(projectPath, projectName);
170
170
  spinner.text = 'Configuración VS Code creada';
171
171
 
172
- // 11. Copiar copilot-instructions.md
172
+ // 11. Generar copilot-instructions.md con agentes embebidos
173
173
  const githubDir = path.join(projectPath, '.github');
174
174
  await fs.ensureDir(githubDir);
175
- const templateCopilotPath = path.join(__dirname, '../../../templates/.github/copilot-instructions.md');
176
- if (await fs.pathExists(templateCopilotPath)) {
177
- await fs.copy(templateCopilotPath, path.join(githubDir, 'copilot-instructions.md'));
178
- spinner.text = 'GitHub Copilot instructions creadas';
179
- }
175
+ const copilotInstructions = await generateCopilotInstructions(projectPath);
176
+ await fs.writeFile(path.join(githubDir, 'copilot-instructions.md'), copilotInstructions);
177
+ spinner.text = 'GitHub Copilot instructions creadas';
180
178
 
181
179
  // 12. Crear archivo NEXT_STEPS.md
182
180
  const nextSteps = createNextStepsContent(projectName);
@@ -237,7 +235,7 @@ function createReadmeContent(projectName, responsible, description) {
237
235
  ## 📋 Información del Proyecto
238
236
 
239
237
  - **Responsable**: ${responsible}
240
- - **Metodología**: AWC ZNS-MTD (Zen, Neutro, Sistemático)
238
+ - **Metodología**: AWC ZNS-MTD (Minimalismo Estratégico)
241
239
  - **Estado**: Pendiente de inicialización
242
240
 
243
241
  ## 🚀 Próximos Pasos
@@ -554,4 +552,108 @@ async function createVSCodeConfig(projectPath, projectName) {
554
552
  );
555
553
  }
556
554
 
555
+ /**
556
+ * Genera copilot-instructions.md con agentes embebidos
557
+ */
558
+ async function generateCopilotInstructions(projectPath) {
559
+ const yaml = require('js-yaml');
560
+ const agentsPath = path.join(projectPath, '.awc/agents');
561
+
562
+ let content = `# GitHub Copilot - AWC ZNS-MTD Method
563
+
564
+ > **Instrucciones para GitHub Copilot**: Este proyecto utiliza el método AWC ZNS-MTD con agentes especializados.
565
+
566
+ ## 🎯 Agentes Disponibles
567
+
568
+ Los siguientes agentes están disponibles en este proyecto. Cada agente tiene un rol específico y expertise técnica.
569
+
570
+ `;
571
+
572
+ // Leer agentes base
573
+ const baseAgents = await fs.readdir(agentsPath);
574
+ for (const agentFile of baseAgents.filter(f => f.endsWith('.agent.yaml'))) {
575
+ try {
576
+ const agentPath = path.join(agentsPath, agentFile);
577
+ const agentContent = await fs.readFile(agentPath, 'utf8');
578
+ const agentData = yaml.load(agentContent);
579
+
580
+ if (agentData && agentData.agent) {
581
+ const meta = agentData.agent.metadata || {};
582
+ const persona = agentData.agent.persona || {};
583
+
584
+ content += `### ${meta.icon || '🤖'} ${meta.name || agentFile}
585
+
586
+ **ID**: \`${meta.id || 'unknown'}\`
587
+ **Cuándo usar**: ${meta.whenToUse || 'No especificado'}
588
+
589
+ `;
590
+
591
+ if (persona.role) {
592
+ content += `**Rol**: ${persona.role}\n\n`;
593
+ }
594
+
595
+ if (persona.identity) {
596
+ content += `**Identidad**: ${persona.identity}\n\n`;
597
+ }
598
+
599
+ content += `---\n\n`;
600
+ }
601
+ } catch (error) {
602
+ console.error(`Error leyendo agente ${agentFile}:`, error.message);
603
+ }
604
+ }
605
+
606
+ // Leer agentes especializados si existen
607
+ const specializedPath = path.join(agentsPath, 'specialized');
608
+ if (await fs.pathExists(specializedPath)) {
609
+ content += `## 🔧 Agentes Especializados
610
+
611
+ `;
612
+ const specializedAgents = await fs.readdir(specializedPath);
613
+ for (const agentFile of specializedAgents.filter(f => f.endsWith('.agent.yaml'))) {
614
+ try {
615
+ const agentPath = path.join(specializedPath, agentFile);
616
+ const agentContent = await fs.readFile(agentPath, 'utf8');
617
+ const agentData = yaml.load(agentContent);
618
+
619
+ if (agentData && agentData.agent) {
620
+ const meta = agentData.agent.metadata || {};
621
+
622
+ content += `- **${meta.icon || '🔧'} ${meta.name || agentFile}** (\`${meta.id || 'unknown'}\`): ${meta.whenToUse || 'Agente especializado'}\n`;
623
+ }
624
+ } catch (error) {
625
+ console.error(`Error leyendo agente especializado ${agentFile}:`, error.message);
626
+ }
627
+ }
628
+ }
629
+
630
+ content += `
631
+
632
+ ## 📋 Instrucciones Generales
633
+
634
+ Al trabajar en este proyecto:
635
+
636
+ 1. **Consulta el agente apropiado** según la tarea (ver lista arriba)
637
+ 2. **Sigue la metodología ZNS-MTD**: Minimalismo Estratégico (máximo impacto, mínima complejidad)
638
+ 3. **Usa los templates** disponibles en \`.awc/templates/\`
639
+ 4. **Documenta decisiones** arquitectónicas importantes
640
+ 5. **Mantén trazabilidad** de cambios y motivaciones
641
+
642
+ ## 🚀 Comandos Disponibles
643
+
644
+ \`\`\`bash
645
+ zns init # Inicializar tipo de proyecto
646
+ zns status # Ver estado del proyecto
647
+ zns validate # Validar estructura
648
+ zns config # Configurar preferencias
649
+ \`\`\`
650
+
651
+ ---
652
+
653
+ *Generado automáticamente por AWC ZNS-MTD*
654
+ `;
655
+
656
+ return content;
657
+ }
658
+
557
659
  module.exports = { newProjectCommand };
@@ -12,7 +12,7 @@ function displayLogo() {
12
12
  console.log();
13
13
  console.log(chalk.cyan('╔═══════════════════════════════════════════════════════════╗'));
14
14
  console.log(chalk.cyan('║') + chalk.bold.white(' AWC ZNS-MTD ') + chalk.cyan('║'));
15
- console.log(chalk.cyan('║') + chalk.gray(' Zen · Neutro · Sistemático Method ') + chalk.cyan('║'));
15
+ console.log(chalk.cyan('║') + chalk.gray(' Minimalismo Estratégico Method ') + chalk.cyan('║'));
16
16
  console.log(chalk.cyan('╚═══════════════════════════════════════════════════════════╝'));
17
17
  console.log();
18
18
  }