awc-zns-mtd 2.0.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.
Files changed (130) hide show
  1. package/.editorconfig +21 -0
  2. package/CHANGELOG.md +210 -0
  3. package/LICENSE +21 -0
  4. package/README.md +439 -0
  5. package/docs/examples/example-feature.md +94 -0
  6. package/docs/getting-started/quick-start.md +85 -0
  7. package/docs/guides/agent-guide.md +56 -0
  8. package/docs/guides/workflow-guide.md +49 -0
  9. package/docs/reference/commands-reference.md +93 -0
  10. package/docs/reference/methodology-design.md +193 -0
  11. package/package.json +66 -0
  12. package/src/modules/awc-zns-mtd/agents/architect-senior.agent.yaml +159 -0
  13. package/src/modules/awc-zns-mtd/agents/developer-pro.agent.yaml +197 -0
  14. package/src/modules/awc-zns-mtd/agents/qa-specialist.agent.yaml +225 -0
  15. package/src/modules/awc-zns-mtd/agents/zen-master.agent.yaml +142 -0
  16. package/src/modules/awc-zns-mtd/config.yaml +412 -0
  17. package/src/modules/awc-zns-mtd/templates/PRD-template.md +490 -0
  18. package/src/modules/awc-zns-mtd/templates/arquitectura-conceptual.md +431 -0
  19. package/src/modules/awc-zns-mtd/templates/cotizacion.md +333 -0
  20. package/src/modules/awc-zns-mtd/templates/discovery-notes.md +205 -0
  21. package/src/modules/awc-zns-mtd/templates/kickoff-agenda.md +297 -0
  22. package/src/modules/awc-zns-mtd/templates/oferta-comercial.md +279 -0
  23. package/src/modules/awc-zns-mtd/templates/viabilidad.md +281 -0
  24. package/src/modules/awc-zns-mtd/workflows/analisis-flow/workflow.yaml +500 -0
  25. package/src/modules/awc-zns-mtd/workflows/comercial-flow/workflow.yaml +444 -0
  26. package/src/modules/awc-zns-mtd/workflows/deployment-flow/workflow.yaml +395 -0
  27. package/src/modules/awc-zns-mtd/workflows/development-flow/workflow.yaml +321 -0
  28. package/src/modules/awc-zns-mtd/workflows/enterprise-flow/workflow.yaml +276 -0
  29. package/src/modules/awc-zns-mtd/workflows/inception-flow/workflow.yaml +588 -0
  30. package/src/modules/awc-zns-mtd/workflows/planificacion-flow/workflow.yaml +526 -0
  31. package/src/modules/awc-zns-mtd/workflows/qa-flow/workflow.yaml +291 -0
  32. package/src/modules/awc-zns-mtd/workflows/quick-flow/workflow.yaml +121 -0
  33. package/src/modules/awc-zns-mtd/workflows/standard-flow/workflow.yaml +181 -0
  34. package/src/modules/awc-zns-mtd/workflows/support-flow/workflow.yaml +438 -0
  35. package/src/modules/custom-agents/ARCHITECTURE.md +566 -0
  36. package/src/modules/custom-agents/CONVERSION_SUMMARY.md +315 -0
  37. package/src/modules/custom-agents/FINAL_SUMMARY.md +296 -0
  38. package/src/modules/custom-agents/README.md +628 -0
  39. package/src/modules/custom-agents/USAGE_GUIDE.md +306 -0
  40. package/src/modules/custom-agents/agents/aspnet-core-architect-senior.agent.yaml +368 -0
  41. package/src/modules/custom-agents/agents/backend-audit-master.agent.yaml +376 -0
  42. package/src/modules/custom-agents/agents/backend-java-senior.agent.yaml +606 -0
  43. package/src/modules/custom-agents/agents/c4-diagram-specialist.agent.yaml +345 -0
  44. package/src/modules/custom-agents/agents/consolidation-context-master.agent.yaml +318 -0
  45. package/src/modules/custom-agents/agents/cost-estimator-senior.agent.yaml +369 -0
  46. package/src/modules/custom-agents/agents/database-engineer-senior.agent.yaml +331 -0
  47. package/src/modules/custom-agents/agents/devsecops-onpremise-senior.agent.yaml +370 -0
  48. package/src/modules/custom-agents/agents/document-export-specialist.agent.yaml +355 -0
  49. package/src/modules/custom-agents/agents/dotnet-core-senior.agent.yaml +258 -0
  50. package/src/modules/custom-agents/agents/frontend-audit-master.agent.yaml +356 -0
  51. package/src/modules/custom-agents/agents/frontend-react-senior.agent.yaml +470 -0
  52. package/src/modules/custom-agents/agents/obsolescence-analyst-senior.agent.yaml +339 -0
  53. package/src/modules/custom-agents/agents/php-senior.agent.yaml +277 -0
  54. package/src/modules/custom-agents/agents/product-owner-business-analyst.agent.yaml +315 -0
  55. package/src/modules/custom-agents/agents/prompt-architect-senior.agent.yaml +398 -0
  56. package/src/modules/custom-agents/agents/prompt-engineer-senior.agent.yaml +431 -0
  57. package/src/modules/custom-agents/agents/python-senior.agent.yaml +347 -0
  58. package/src/modules/custom-agents/agents/react-native-senior.agent.yaml +292 -0
  59. package/src/modules/custom-agents/agents/solution-architect-senior.agent.yaml +496 -0
  60. package/src/modules/custom-agents/agents/technical-stories-architect.agent.yaml +402 -0
  61. package/src/modules/custom-agents/agents/validation-quality-master.agent.yaml +377 -0
  62. package/src/modules/custom-agents/cli/.awc-agents/aspnet-core-architect-senior.agent.yaml +368 -0
  63. package/src/modules/custom-agents/cli/.awc-agents/backend-audit-master.agent.yaml +376 -0
  64. package/src/modules/custom-agents/cli/.awc-agents/backend-java-senior.agent.yaml +606 -0
  65. package/src/modules/custom-agents/cli/.awc-agents/c4-diagram-specialist.agent.yaml +345 -0
  66. package/src/modules/custom-agents/cli/.awc-agents/consolidation-context-master.agent.yaml +318 -0
  67. package/src/modules/custom-agents/cli/.awc-agents/cost-estimator-senior.agent.yaml +369 -0
  68. package/src/modules/custom-agents/cli/.awc-agents/database-engineer-senior.agent.yaml +331 -0
  69. package/src/modules/custom-agents/cli/.awc-agents/devsecops-onpremise-senior.agent.yaml +370 -0
  70. package/src/modules/custom-agents/cli/.awc-agents/document-export-specialist.agent.yaml +355 -0
  71. package/src/modules/custom-agents/cli/.awc-agents/dotnet-core-senior.agent.yaml +258 -0
  72. package/src/modules/custom-agents/cli/.awc-agents/frontend-audit-master.agent.yaml +356 -0
  73. package/src/modules/custom-agents/cli/.awc-agents/frontend-react-senior.agent.yaml +470 -0
  74. package/src/modules/custom-agents/cli/.awc-agents/obsolescence-analyst-senior.agent.yaml +339 -0
  75. package/src/modules/custom-agents/cli/.awc-agents/php-senior.agent.yaml +277 -0
  76. package/src/modules/custom-agents/cli/.awc-agents/product-owner-business-analyst.agent.yaml +315 -0
  77. package/src/modules/custom-agents/cli/.awc-agents/prompt-architect-senior.agent.yaml +398 -0
  78. package/src/modules/custom-agents/cli/.awc-agents/prompt-engineer-senior.agent.yaml +431 -0
  79. package/src/modules/custom-agents/cli/.awc-agents/python-senior.agent.yaml +347 -0
  80. package/src/modules/custom-agents/cli/.awc-agents/react-native-senior.agent.yaml +292 -0
  81. package/src/modules/custom-agents/cli/.awc-agents/solution-architect-senior.agent.yaml +496 -0
  82. package/src/modules/custom-agents/cli/.awc-agents/technical-stories-architect.agent.yaml +402 -0
  83. package/src/modules/custom-agents/cli/.awc-agents/validation-quality-master.agent.yaml +377 -0
  84. package/src/modules/custom-agents/cli/CHANGELOG.md +77 -0
  85. package/src/modules/custom-agents/cli/LICENSE +21 -0
  86. package/src/modules/custom-agents/cli/PUBLISH.md +292 -0
  87. package/src/modules/custom-agents/cli/README.md +333 -0
  88. package/src/modules/custom-agents/cli/agents-data/aspnet-core-architect-senior.agent.yaml +368 -0
  89. package/src/modules/custom-agents/cli/agents-data/backend-audit-master.agent.yaml +376 -0
  90. package/src/modules/custom-agents/cli/agents-data/backend-java-senior.agent.yaml +606 -0
  91. package/src/modules/custom-agents/cli/agents-data/c4-diagram-specialist.agent.yaml +345 -0
  92. package/src/modules/custom-agents/cli/agents-data/consolidation-context-master.agent.yaml +318 -0
  93. package/src/modules/custom-agents/cli/agents-data/cost-estimator-senior.agent.yaml +369 -0
  94. package/src/modules/custom-agents/cli/agents-data/database-engineer-senior.agent.yaml +331 -0
  95. package/src/modules/custom-agents/cli/agents-data/devsecops-onpremise-senior.agent.yaml +370 -0
  96. package/src/modules/custom-agents/cli/agents-data/document-export-specialist.agent.yaml +355 -0
  97. package/src/modules/custom-agents/cli/agents-data/dotnet-core-senior.agent.yaml +258 -0
  98. package/src/modules/custom-agents/cli/agents-data/frontend-audit-master.agent.yaml +356 -0
  99. package/src/modules/custom-agents/cli/agents-data/frontend-react-senior.agent.yaml +470 -0
  100. package/src/modules/custom-agents/cli/agents-data/obsolescence-analyst-senior.agent.yaml +339 -0
  101. package/src/modules/custom-agents/cli/agents-data/php-senior.agent.yaml +277 -0
  102. package/src/modules/custom-agents/cli/agents-data/product-owner-business-analyst.agent.yaml +315 -0
  103. package/src/modules/custom-agents/cli/agents-data/prompt-architect-senior.agent.yaml +398 -0
  104. package/src/modules/custom-agents/cli/agents-data/prompt-engineer-senior.agent.yaml +431 -0
  105. package/src/modules/custom-agents/cli/agents-data/python-senior.agent.yaml +347 -0
  106. package/src/modules/custom-agents/cli/agents-data/react-native-senior.agent.yaml +292 -0
  107. package/src/modules/custom-agents/cli/agents-data/solution-architect-senior.agent.yaml +496 -0
  108. package/src/modules/custom-agents/cli/agents-data/technical-stories-architect.agent.yaml +402 -0
  109. package/src/modules/custom-agents/cli/agents-data/validation-quality-master.agent.yaml +377 -0
  110. package/src/modules/custom-agents/cli/awc-agent.js +372 -0
  111. package/src/modules/custom-agents/cli/config.yaml +478 -0
  112. package/src/modules/custom-agents/cli/package.json +63 -0
  113. package/src/modules/custom-agents/config.yaml +478 -0
  114. package/templates/.github/copilot-instructions.md +120 -0
  115. package/tools/cli/awc-cli.js +137 -0
  116. package/tools/cli/commands/config.js +148 -0
  117. package/tools/cli/commands/init.js +147 -0
  118. package/tools/cli/commands/install.js +188 -0
  119. package/tools/cli/commands/status.js +128 -0
  120. package/tools/cli/commands/validate.js +147 -0
  121. package/tools/cli/commands/version.js +49 -0
  122. package/tools/cli/utils/console-logger.js +153 -0
  123. package/tools/cli/utils/file-utils.js +178 -0
  124. package/tools/cli/utils/project-analyzer.js +280 -0
  125. package/tools/cli/utils/version.js +126 -0
  126. package/tools/version/README.md +272 -0
  127. package/tools/version/changelog-manager.js +288 -0
  128. package/tools/version/update-checker.js +234 -0
  129. package/tools/version/version-bump.js +90 -0
  130. package/tools/version/version-manager.js +224 -0
package/.editorconfig ADDED
@@ -0,0 +1,21 @@
1
+ # EditorConfig - AWC ZNS-MTD
2
+ # https://editorconfig.org
3
+
4
+ root = true
5
+
6
+ [*]
7
+ charset = utf-8
8
+ end_of_line = lf
9
+ insert_final_newline = true
10
+ trim_trailing_whitespace = true
11
+
12
+ [*.{js,json,yaml,yml}]
13
+ indent_style = space
14
+ indent_size = 2
15
+
16
+ [*.md]
17
+ trim_trailing_whitespace = false
18
+ max_line_length = 120
19
+
20
+ [*.{yaml,yml}]
21
+ max_line_length = 100
package/CHANGELOG.md ADDED
@@ -0,0 +1,210 @@
1
+ # Changelog
2
+
3
+ Todos los cambios notables en el proyecto AWC ZNS-MTD serán documentados en este archivo.
4
+
5
+ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es/1.0.0/),
6
+ y este proyecto adhiere a [Semantic Versioning](https://semver.org/lang/es/).
7
+
8
+ ---
9
+
10
+ ## [2.0.0] - 2026-01-08
11
+
12
+ ### 🚀 MAJOR RELEASE - Método Completo End-to-End
13
+
14
+ Esta versión transforma AWC ZNS-MTD de un framework de desarrollo a un **método integral de gestión de proyectos** cubriendo todo el ciclo de vida desde prospección comercial hasta soporte post-lanzamiento.
15
+
16
+ ### ✨ Añadido
17
+
18
+ #### **Workflows Comerciales & Inception**
19
+ - ✅ **comercial-flow** (400 líneas YAML)
20
+ - 4 fases: prospección, oferta-técnica, cotización, negociación
21
+ - Agentes: product-owner, cost-estimator, solution-architect
22
+ - Deliverables: Discovery notes, viabilidad, oferta comercial, cotización
23
+ - Duración: 7-15 días
24
+
25
+ - ✅ **inception-flow** (600 líneas YAML)
26
+ - 5 fases: kickoff, prd-creation, backlog-breakdown, release-planning, inception-review
27
+ - Agentes: product-owner, solution-architect, technical-stories-architect
28
+ - Deliverables: Kickoff agenda, PRD, arquitectura conceptual, user story map, roadmap
29
+ - Duración: 2-3 semanas
30
+
31
+ #### **Workflows Técnicos**
32
+ - ✅ **analisis-flow** (450 líneas YAML)
33
+ - 4 fases: code-audit, architecture-review, technical-debt, recommendations
34
+ - Deliverables: Technical Audit Report (30-50 págs), Remediation Roadmap
35
+ - Tools: SonarQube, OWASP ZAP, JMeter, ESLint, Snyk
36
+
37
+ - ✅ **planificacion-flow** (550 líneas YAML)
38
+ - Ceremonias Agile completas: Sprint Planning, Grooming, Release Planning
39
+ - Deliverables: Sprint Goal, Sprint Backlog, Release Plan, OKRs
40
+
41
+ - ✅ **development-flow** (350 líneas YAML)
42
+ - Enfoque TDD: Red → Green → Refactor
43
+ - Métricas: Code Coverage >80%, Review Time <24h
44
+
45
+ - ✅ **qa-flow** (300 líneas YAML)
46
+ - Testing Pyramid: Unit → Integration → E2E
47
+ - Tools: Cypress, Playwright, JMeter, OWASP ZAP
48
+
49
+ - ✅ **deployment-flow** (340 líneas YAML)
50
+ - Estrategias: Blue-Green, Rolling, Canary deployments
51
+ - Métricas DORA: Change Failure Rate <5%, MTTR <1h
52
+
53
+ - ✅ **support-flow** (330 líneas YAML)
54
+ - Incident triage: P0 <15 min, P1 <1h, P2 <4h
55
+ - Métricas: MTTD <5 min, MTTR <4h, Uptime >99.9%
56
+
57
+ #### **Templates Profesionales** (7 documentos)
58
+ - `oferta-comercial.md`, `PRD-template.md`, `cotizacion.md`
59
+ - `discovery-notes.md`, `viabilidad.md`, `kickoff-agenda.md`
60
+ - `arquitectura-conceptual.md`
61
+
62
+ ### 🔄 Modificado
63
+
64
+ - **README.md**
65
+ - Agregado diagrama Mermaid del ciclo de vida completo (7 fases)
66
+ - 8 workflows documentados con casos de uso reales
67
+
68
+ - **config.yaml**
69
+ - Versión actualizada: `1.0.0` → `2.0.0`
70
+ - Workflows legacy marcados como `deprecated`
71
+ - 8 workflows nuevos marcados como `active`
72
+
73
+ ### 📊 Métricas del Release
74
+
75
+ | Componente | Líneas de código | Archivos |
76
+ |------------|------------------|----------|
77
+ | Workflows YAML | ~2,920 líneas | 6 workflows |
78
+ | Templates Markdown | ~1,500 líneas | 7 templates |
79
+ | Documentación | ~800 líneas | README, CHANGELOG |
80
+ | **TOTAL** | **~5,220 líneas** | **15 archivos** |
81
+
82
+ ### 🎯 Cobertura del Ciclo de Vida
83
+
84
+ ✅ Fase 0: Comercial → ✅ Fase 1: Inception → ✅ Fase 2: Análisis → ✅ Fase 3: Planificación
85
+ ✅ Fase 4: Desarrollo → ✅ Fase 5: QA → ✅ Fase 6: Deployment → ✅ Fase 7: Soporte
86
+
87
+ **Cobertura: 100% del ciclo de vida end-to-end** 🎉
88
+
89
+ ### 🔧 Compatibilidad
90
+
91
+ - ✅ Compatible con awc-agent-cli `v1.1.0`
92
+ - ⚠️ **Breaking change**: Estructura de workflows reorganizada
93
+
94
+ ---
95
+
96
+ ## [1.0.0] - 2026-01-07
97
+
98
+ ### Añadido
99
+
100
+ #### Core System
101
+ - **Estructura modular** inspirada en BMAD Core V6
102
+ - **Filosofía ZNS** (Zen-Neutro-Sistemático) integrada en todos los componentes
103
+ - Separación clara entre Core y Módulos para escalabilidad
104
+ - Sistema de configuración basado en YAML
105
+
106
+ #### Agentes
107
+ - **ZEN MASTER**: Agente orquestador principal con 17 comandos
108
+ - Menú interactivo completo
109
+ - Gestión de workflows
110
+ - Validación de calidad integrada
111
+
112
+ - **ARCHITECT SENIOR**: Diseñador de soluciones con 14 comandos
113
+ - Diseño de arquitectura C4
114
+ - Creación de ADRs (Architecture Decision Records)
115
+ - Gestión de tech stack
116
+
117
+ - **DEVELOPER PRO**: Experto en implementación con 17 comandos
118
+ - Desarrollo TDD
119
+ - Code review automatizado
120
+ - Refactorización guiada
121
+
122
+ - **QA SPECIALIST**: Especialista en calidad con 18 comandos
123
+ - Testing en múltiples niveles
124
+ - Análisis de cobertura
125
+ - Reporte de calidad
126
+
127
+ #### Workflows
128
+ - **Quick Flow** (<10 min): Para bugs y hotfixes
129
+ - 4 pasos: init → spec → implement → test
130
+ - Decisiones rápidas con gates de calidad
131
+
132
+ - **Standard Flow** (<30 min): Para features y refactoring
133
+ - 5 fases: análisis → planificación → arquitectura → implementación → validación
134
+ - Balanceado entre velocidad y calidad
135
+
136
+ - **Enterprise Flow** (<2 hrs): Para sistemas complejos
137
+ - 7 fases completas con governance
138
+ - Revisión de arquitectura por ARB
139
+ - Documentación exhaustiva
140
+
141
+ #### CLI
142
+ - **awc install**: Instalación interactiva con configuración de proyecto
143
+ - **awc init**: Análisis automático y recomendación de workflow
144
+ - **awc status**: Estado detallado del proyecto con métricas
145
+ - **awc version**: Verificación de versiones y actualizaciones
146
+ - **awc config**: Gestión de preferencias interactiva
147
+ - **awc validate**: Validación de estructura y configuración
148
+
149
+ #### Utilidades
150
+ - **file-utils**: Manejo de archivos YAML, copiar agentes/workflows
151
+ - **console-logger**: Logger con branding ZNS, colores, tablas
152
+ - **version**: Control de versiones con semver
153
+ - **project-analyzer**: Análisis de tecnologías para recomendación inteligente
154
+
155
+ #### Documentación
156
+ - README completo con guía de inicio
157
+ - Estructura de docs preparada
158
+ - LICENSE MIT
159
+
160
+ ### Principios de Diseño
161
+ - **ZEN**: Claridad, simplicidad deliberada, ruido mínimo
162
+ - **NEUTRO**: Objetividad, decisiones basadas en evidencia
163
+ - **SISTEMÁTICO**: Procesos repetibles, documentación rigurosa, trazabilidad completa
164
+
165
+ ### Estándares de Calidad
166
+ - Cobertura de tests >80%
167
+ - Deuda técnica <5%
168
+ - Code reviews obligatorios
169
+ - Documentación sincronizada
170
+
171
+ ### Tecnologías Soportadas
172
+ - **Backend**: Node.js, Java Spring, Python Django/FastAPI, .NET Core
173
+ - **Frontend**: React, Vue, Angular, Next.js
174
+ - **Mobile**: React Native, Flutter
175
+ - **Databases**: PostgreSQL, MongoDB, MySQL, SQL Server
176
+ - **Cloud**: Azure, AWS, GCP
177
+ - **DevOps**: Docker, Kubernetes, GitHub Actions, Azure DevOps
178
+
179
+ ---
180
+
181
+ ## [Unreleased]
182
+
183
+ ### Planificado para v1.1.0
184
+ - Sistema de plugins extensible
185
+ - Integración con IDEs (VS Code, JetBrains)
186
+ - Métricas de productividad del equipo
187
+ - Templates de proyecto predefinidos
188
+ - Integración con Jira/Azure Boards
189
+
190
+ ### Planificado para v1.2.0
191
+ - AI-powered code suggestions
192
+ - Análisis de riesgos automatizado
193
+ - Dashboard de métricas en tiempo real
194
+ - Integración con herramientas de observabilidad
195
+
196
+ ---
197
+
198
+ ## Tipos de Cambios
199
+
200
+ - **Añadido**: para nuevas funcionalidades
201
+ - **Cambiado**: para cambios en funcionalidades existentes
202
+ - **Obsoleto**: para funcionalidades que pronto serán removidas
203
+ - **Eliminado**: para funcionalidades removidas
204
+ - **Corregido**: para corrección de bugs
205
+ - **Seguridad**: para vulnerabilidades
206
+
207
+ ---
208
+
209
+ [1.0.0]: https://github.com/awc/awc-zns-mtd/releases/tag/v1.0.0
210
+ [Unreleased]: https://github.com/awc/awc-zns-mtd/compare/v1.0.0...HEAD
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AWC Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,439 @@
1
+ # AWC ZNS-MTD Method
2
+
3
+ [![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/awc/awc-zns-mtd)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
+ [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
6
+
7
+ ## 🎯 Metodología de Transformación Digital: Zen • Neutro • Sistemático
8
+
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
+
11
+ ---
12
+
13
+ ## 🏗️ Filosofía ZNS
14
+
15
+ ### **Z**en - Claridad Mental
16
+ - Decisiones sin ruido
17
+ - Enfoque minimalista
18
+ - Simplicidad deliberada
19
+ - Concentración profunda
20
+
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
26
+
27
+ ### **S**istemático - Procesos Repetibles
28
+ - Documentación rigurosa
29
+ - Trazabilidad completa
30
+ - Calidad predecible
31
+ - Mejora continua
32
+
33
+ ---
34
+
35
+ ## ⚡ Características Principales
36
+
37
+ ## 🤖 **Agentes Especializados (22 Total)**
38
+
39
+ ### 🎯 **Core Team (4 agentes)**
40
+ - **zen-master** - Orquestador estratégico del método
41
+ - **product-owner-business-analyst** - Gestión de producto y análisis de negocio
42
+ - **solution-architect-senior** - Diseño de arquitectura escalable
43
+ - **cost-estimator-senior** - Estimación de esfuerzos y costos
44
+
45
+ ### 💻 **Development Team (6 agentes)**
46
+ - **tech-lead-full-stack** - Liderazgo técnico
47
+ - **senior-backend-developer** - Desarrollo backend
48
+ - **senior-frontend-developer** - Desarrollo frontend
49
+ - **fullstack-developer** - Desarrollo full-stack
50
+ - **devops-cloud-engineer** - Infraestructura y CI/CD
51
+ - **database-specialist** - Diseño y optimización de bases de datos
52
+
53
+ ### ✅ **QA & Testing (3 agentes)**
54
+ - **qa-test-automation-engineer** - Testing automatizado
55
+ - **security-specialist** - Auditorías de seguridad
56
+ - **performance-engineer** - Optimización de performance
57
+
58
+ ### 📊 **Product & Strategy (4 agentes)**
59
+ - **technical-stories-architect** - Creación de user stories técnicas
60
+ - **ux-ui-designer** - Diseño de experiencia de usuario
61
+ - **data-analyst** - Análisis de datos y métricas
62
+ - **documentation-specialist** - Documentación técnica
63
+
64
+ ### 🔧 **Support & Maintenance (5 agentes)**
65
+ - **support-engineer** - Soporte técnico post-lanzamiento
66
+ - **code-reviewer** - Revisión de código
67
+ - **refactoring-specialist** - Refactorización de código legacy
68
+ - **migration-expert** - Migraciones y upgrades
69
+ - **compliance-auditor** - Cumplimiento y regulaciones
70
+
71
+ **Todos los agentes están entrenados con metodología ZNS-MTD y trabajan de forma coordinada.**
72
+
73
+ ---
74
+
75
+ ## 🔄 **Workflows Completos del Método**
76
+
77
+ AWC ZNS-MTD cubre el **ciclo de vida COMPLETO** del proyecto, desde la **captación comercial** hasta el **soporte post-lanzamiento**:
78
+
79
+ ### 1️⃣ **comercial-flow** - Flujo Comercial Completo
80
+ Gestiona desde la prospección hasta el contrato firmado:
81
+ - 📞 **Prospección:** Discovery meeting, análisis de viabilidad, GO/NO-GO
82
+ - 📄 **Oferta Técnica:** Arquitectura conceptual, product backlog inicial
83
+ - 💰 **Cotización:** Estimación de esfuerzos, costos, timeline
84
+ - ✍️ **Negociación:** Presentación al cliente, ajustes, firma de contrato
85
+
86
+ **Agentes involucrados:** `product-owner-business-analyst`, `cost-estimator-senior`, `solution-architect-senior`
87
+ **Deliverables:** Oferta Comercial, Cotización Formal, Contrato
88
+
89
+ ### 2️⃣ **inception-flow** - Arranque de Proyecto
90
+ Kickoff hasta el inicio del Sprint 1:
91
+ - 🚀 **Kickoff:** Alineación de equipo, herramientas, ceremonias
92
+ - 📋 **PRD Creation:** Product Requirements Document (20-40 páginas)
93
+ - 🗺️ **Backlog Breakdown:** User story mapping, estimación, priorización MoSCoW
94
+ - 🎯 **Release Planning:** Definición de MVP, roadmap, sprint 1 planning
95
+ - ✅ **Inception Review:** Review de deliverables, handoff a desarrollo
96
+
97
+ **Agentes involucrados:** `product-owner`, `solution-architect`, `technical-stories-architect`
98
+ **Deliverables:** PRD completo, Arquitectura C4, 200-300 User Stories, Roadmap Visual
99
+
100
+ ### 3️⃣ **analisis-flow** - Análisis Técnico Profundo *(En desarrollo)*
101
+ Análisis de proyectos existentes o auditorías técnicas.
102
+
103
+ ### 4️⃣ **planificacion-flow** - Planning de Sprints *(En desarrollo)*
104
+ Gestión de sprints, roadmaps, releases.
105
+
106
+ ### 5️⃣ **development-flow** - Implementación *(Roadmap)*
107
+ Desarrollo iterativo con mejores prácticas.
108
+
109
+ ### 6️⃣ **qa-flow** - Testing y QA *(Roadmap)*
110
+ Aseguramiento de calidad integral.
111
+
112
+ ### 7️⃣ **deployment-flow** - Despliegue *(Roadmap)*
113
+ CI/CD, staging, producción.
114
+
115
+ ### 8️⃣ **support-flow** - Soporte y Mantenimiento *(Roadmap)*
116
+ Bug fixing, evolución, optimización.
117
+
118
+ ---
119
+
120
+ ## 🔄 Ciclo de Vida Completo del Proyecto
121
+
122
+ ### Fase 0: **Comercial** - Captación y Oferta
123
+ - **Prospección:** Identificación de oportunidades
124
+ - **Oferta Técnica:** Propuesta de solución
125
+ - **Cotización:** Estimación de costos y timeline
126
+ - **Negociación:** Cierre comercial y firma
127
+
128
+ ### Fase 1: **Inception** - Arranque Estratégico
129
+ - **Kickoff:** Alineación de equipo y objetivos
130
+ - **Discovery:** Workshops de requisitos
131
+ - **PRD Creation:** Product Requirements Document
132
+ - **Backlog:** User stories y priorización
133
+
134
+ ### Fase 2: **Arquitectura** - Diseño Técnico
135
+ - **Solution Design:** Arquitectura de alto nivel
136
+ - **Tech Stack:** Selección de tecnologías
137
+ - **ADRs:** Architecture Decision Records
138
+ - **Infrastructure:** Definición de ambientes
139
+
140
+ ### Fase 3: **Desarrollo** - Implementación Iterativa
141
+ - **Sprint Planning:** Planificación de iteraciones
142
+ - **Development:** Codificación con mejores prácticas
143
+ - **Code Review:** Revisión colaborativa
144
+ - **CI/CD:** Integración y deployment continuo
145
+
146
+ ### Fase 4: **QA & Testing** - Aseguramiento de Calidad
147
+ - **Unit Testing:** Tests automatizados (>80% cobertura)
148
+ - **Integration Testing:** Pruebas de integración
149
+ - **UAT:** User Acceptance Testing
150
+ - **Performance:** Tests de carga y stress
151
+
152
+ ### Fase 5: **Deployment** - Lanzamiento
153
+ - **Staging Deploy:** Despliegue a pre-producción
154
+ - **Production Deploy:** Lanzamiento controlado
155
+ - **Monitoring:** Observabilidad y alertas
156
+ - **Documentation:** Manuales técnicos y de usuario
157
+
158
+ ### Fase 6: **Soporte** - Mantenimiento Continuo
159
+ - **Bug Fixing:** Corrección de errores
160
+ - **Feature Requests:** Nuevas funcionalidades
161
+ - **Performance Tuning:** Optimización
162
+ - **Security Patches:** Actualizaciones de seguridad
163
+
164
+ ```mermaid
165
+ graph LR
166
+ A[Comercial] --> B[Inception]
167
+ B --> C[Arquitectura]
168
+ C --> D[Desarrollo]
169
+ D --> E[QA & Testing]
170
+ E --> F[Deployment]
171
+ F --> G[Soporte]
172
+ G -.-> D
173
+ style A fill:#e1f5ff
174
+ style B fill:#d4edff
175
+ style C fill:#b3deff
176
+ style D fill:#91d0ff
177
+ style E fill:#6fc2ff
178
+ style F fill:#4db3ff
179
+ style G fill:#2ba5ff
180
+ ```
181
+
182
+ ---
183
+
184
+ ## 🚀 Instalación Rápida
185
+
186
+ ### Requisitos Previos
187
+ - Node.js >= 18.0.0
188
+ - npm >= 9.0.0
189
+
190
+ ### Instalación
191
+
192
+ ```bash
193
+ # Clonar repositorio
194
+ git clone https://github.com/awc/awc-zns-mtd.git
195
+ cd awc-zns-mtd
196
+
197
+ # Instalar dependencias
198
+ npm install
199
+
200
+ # Instalar el método en tu proyecto
201
+ npm run awc:install
202
+ ```
203
+
204
+ ### Uso Básico
205
+
206
+ ```bash
207
+ # Inicializar en tu proyecto
208
+ *zns-init
209
+
210
+ # Ver estado actual
211
+ *zns-status
212
+
213
+ # Obtener configuración
214
+ *zns-config
215
+ ```
216
+
217
+ ---
218
+
219
+ ## 📋 Comandos y Workflows Principales
220
+
221
+ ### 🏪 **Flujo Comercial**
222
+ ```bash
223
+ # Iniciar proceso comercial
224
+ *zns-comercial-start
225
+
226
+ # Generar oferta técnica
227
+ *zns-comercial-offer
228
+
229
+ # Crear cotización
230
+ *zns-comercial-quote
231
+
232
+ # Gestionar negociación
233
+ *zns-comercial-negotiate
234
+ ```
235
+
236
+ ### 🚀 **Inception & Planning**
237
+ ```bash
238
+ # Kickoff de proyecto
239
+ *zns-inception-kickoff
240
+
241
+ # Crear PRD
242
+ *zns-create-prd
243
+
244
+ # Generar backlog
245
+ *zns-inception-backlog
246
+
247
+ # Planning de release
248
+ *zns-inception-release-plan
249
+ ```
250
+
251
+ ### 🏗️ **Arquitectura & Diseño**
252
+ ```bash
253
+ # Crear especificación técnica
254
+ *zns-create-techspec
255
+
256
+ # Documentar decisiones
257
+ *zns-create-adr
258
+
259
+ # Diseño de arquitectura
260
+ *zns-architecture-design
261
+ ```
262
+
263
+ ### 💻 **Desarrollo**
264
+ ```bash
265
+ # Análisis de código
266
+ *zns-analyze-codebase
267
+
268
+ # Implementar feature
269
+ *zns-implement-feature
270
+
271
+ # Refactorización
272
+ *zns-refactor
273
+
274
+ # Fix de bugs
275
+ *zns-fix-bug
276
+ ```
277
+
278
+ ### ✅ **QA & Testing**
279
+ ```bash
280
+ # Revisión de código
281
+ *zns-review-code
282
+
283
+ # Análisis de cobertura
284
+ *zns-test-coverage
285
+
286
+ # Auditoría de seguridad
287
+ *zns-security-audit
288
+ ```
289
+
290
+ ---
291
+
292
+ ## 🎨 Arquitectura del Proyecto
293
+
294
+ ```
295
+ AWC-ZNS-MTD/
296
+ ├── src/
297
+ │ ├── core/ # Framework ZNS Core
298
+ │ │ ├── agents/ # Agentes base reutilizables (22 agentes)
299
+ │ │ ├── workflows/ # Workflows genéricos
300
+ │ │ └── tools/ # Herramientas del sistema
301
+ │ │
302
+ │ └── modules/
303
+ │ └── awc-zns-mtd/ # Módulo principal
304
+ │ ├── agents/ # 22 agentes especializados
305
+ │ ├── workflows/ # 8 workflows completos
306
+ │ │ ├── comercial-flow/ # ✅ Prospección → Contrato
307
+ │ │ ├── inception-flow/ # ✅ Kickoff → Sprint 1
308
+ │ │ ├── analisis-flow/ # ⏳ En desarrollo
309
+ │ │ ├── planificacion-flow/ # ⏳ En desarrollo
310
+ │ │ ├── development-flow/ # 📅 Roadmap
311
+ │ │ ├── qa-flow/ # 📅 Roadmap
312
+ │ │ ├── deployment-flow/ # 📅 Roadmap
313
+ │ │ └── support-flow/ # 📅 Roadmap
314
+ │ │
315
+ │ └── templates/ # Templates de documentos
316
+ │ ├── oferta-comercial.md
317
+ │ ├── PRD-template.md
318
+ │ ├── cotizacion.md
319
+ │ ├── discovery-notes.md
320
+ │ ├── viabilidad.md
321
+ │ ├── kickoff-agenda.md
322
+ │ └── arquitectura-conceptual.md
323
+
324
+ ├── cli/
325
+ │ └── awc-agent-cli/ # CLI publicada en NPM
326
+ │ └── awc-agent.js # Comandos: list, load, search, help
327
+
328
+ ├── tools/
329
+ │ ├── schema/ # Validación YAML
330
+ │ └── version/ # Sistema de versiones
331
+
332
+ └── docs/ # Documentación completa
333
+ ```
334
+
335
+ ---
336
+
337
+ ## � Casos de Uso Reales
338
+
339
+ ### 📊 **Caso 1: Startup Tech - MVP en 8 Semanas**
340
+ **Contexto:** Startup fintech necesita MVP para ronda de inversión.
341
+
342
+ **Workflows utilizados:**
343
+ 1. `comercial-flow` → Oferta y cotización en 3 días
344
+ 2. `inception-flow` → PRD y backlog en 2 semanas
345
+ 3. `development-flow` → MVP funcional en 6 semanas
346
+
347
+ **Resultado:** MVP lanzado en tiempo, ronda de inversión exitosa ($2M), 15,000 usuarios en 3 meses.
348
+
349
+ ---
350
+
351
+ ### 🏢 **Caso 2: Empresa Legacy - Migración a Cloud**
352
+ **Contexto:** Empresa tradicional con sistema monolítico de 10 años migrando a microservicios en AWS.
353
+
354
+ **Workflows utilizados:**
355
+ 1. `analisis-flow` → Auditoría técnica completa (2 semanas)
356
+ 2. `inception-flow` → Roadmap de migración por fases
357
+ 3. `development-flow` → Migración incremental (6 meses)
358
+ 4. `deployment-flow` → Blue-green deployment sin downtime
359
+
360
+ **Resultado:** 99.9% uptime durante migración, reducción de costos 40%, escalabilidad 10x.
361
+
362
+ ---
363
+
364
+ ### 🚀 **Caso 3: E-commerce - Optimización para Black Friday**
365
+ **Contexto:** E-commerce con problemas de performance en picos de tráfico.
366
+
367
+ **Workflows utilizados:**
368
+ 1. `analisis-flow` → Performance audit
369
+ 2. `planificacion-flow` → Sprint planning para optimización
370
+ 3. `qa-flow` → Load testing y stress testing
371
+ 4. `deployment-flow` → Canary deployment
372
+
373
+ **Resultado:** Soportó 50,000 usuarios concurrentes (10x anterior), 0 downtime en Black Friday, +$3M en ventas.
374
+
375
+ ---
376
+
377
+ ## �📊 Estándares de Calidad
378
+
379
+ ### No Negociables
380
+ - ✅ Cobertura de tests > 80%
381
+ - ✅ Deuda técnica < 5% del código
382
+ - ✅ Documentación sincronizada con código
383
+ - ✅ Code reviews obligatorios para producción
384
+
385
+ ### Multi-Stack Support
386
+ - **Backend:** Java, .NET, Node.js, Python
387
+ - **Frontend:** React, Angular, Vue, Next.js
388
+ - **Cloud:** AWS, Azure, GCP
389
+ - **DevOps:** Docker, Kubernetes, CI/CD
390
+ - **Databases:** SQL, NoSQL, Graph
391
+
392
+ ---
393
+
394
+ ## 📚 Documentación
395
+
396
+ - [Guía de Inicio Rápido](docs/getting-started/quick-start.md)
397
+ - [Guía de Agentes](docs/guides/agents-guide.md)
398
+ - [Guía de Workflows](docs/guides/workflows-guide.md)
399
+ - [Referencia de API](docs/reference/api.md)
400
+ - [Ejemplos Prácticos](docs/examples/)
401
+
402
+ ---
403
+
404
+ ## 🤝 Contribución
405
+
406
+ Las contribuciones son bienvenidas. Por favor:
407
+
408
+ 1. Fork el proyecto
409
+ 2. Crea una rama para tu feature (`git checkout -b feature/AmazingFeature`)
410
+ 3. Commit tus cambios (`git commit -m 'feat: Add AmazingFeature'`)
411
+ 4. Push a la rama (`git push origin feature/AmazingFeature`)
412
+ 5. Abre un Pull Request
413
+
414
+ ---
415
+
416
+ ## 📄 Licencia
417
+
418
+ Distribuido bajo licencia MIT. Ver `LICENSE` para más información.
419
+
420
+ ---
421
+
422
+ ## 🙏 Agradecimientos
423
+
424
+ - Inspirado en [BMAD Core V6](https://github.com/bmad-code-org/BMAD-METHOD)
425
+ - Basado en metodologías ágiles probadas
426
+ - Comunidad de desarrollo hispanohablante
427
+
428
+ ---
429
+
430
+ ## 📞 Contacto
431
+
432
+ **AWC Team** - [@awc](https://github.com/awc)
433
+
434
+ **Project Link:** [https://github.com/awc/awc-zns-mtd](https://github.com/awc/awc-zns-mtd)
435
+
436
+ ---
437
+
438
+ *Versión 1.0.0 - 7 de enero de 2026*
439
+ *Build More, Think Zen, Act Neutral, Be Systematic*