Skip to content

Commit 722770d

Browse files
claudeclaude
committed
docs(migracion): migrar contenido restante de docs_legacy (FASES 8-12)
Completa migracion de docs_legacy a docs con integracion en workflows y procesos. Total: 28 archivos nuevos migrados y integrados. FASE 8 - Metodologias (5 archivos): - docs/gobernanza/metodologias/README.md (nuevo) - METODOLOGIA_DESARROLLO_POR_LOTES.md - WORKFLOWS_COMPLETOS.md - agentes_automatizacion.md - arquitectura_agentes_especializados.md FASE 9 - Marco Integrado (8 archivos): - docs/gobernanza/marco_integrado/ completo - 00_resumen_ejecutivo_mejores_practicas.md - 01-06: marco conceptual, relaciones, matrices, metodologia, casos FASE 10 - Gobernanza Raiz (4 archivos): - docs/gobernanza/estandares_codigo.md - docs/gobernanza/shell_scripting_guide.md - docs/gobernanza/agentes/ (2 archivos) FASE 11 - QA (9 archivos): - docs/gobernanza/procesos/estrategia_qa.md - docs/gobernanza/procesos/actividades_garantia_documental.md - docs/gobernanza/procesos/checklists/checklist_auditoria_restricciones.md - docs/testing/registros/ (6 archivos de ejecuciones pytest) FASE 12 - Vision y Alcance (2 archivos): - docs/proyecto/vision_y_alcance.md - docs/proyecto/glossary.md INTEGRACION CON WORKFLOWS: - Actualizado .claude/workflow_template_mapping.json - test-pyramid workflow ahora referencia estrategia_qa.md y actividades_garantia_documental.md - Agregado checklist_auditoria_restricciones.md a test-pyramid - Agregado docs/testing/registros/ como registros de testing - Actualizado .github/CODEOWNERS - docs/gobernanza/metodologias/** -> @arquitecto-senior @Tech-lead - docs/gobernanza/marco_integrado/** -> @arquitecto-senior @Tech-lead - docs/gobernanza/agentes/** -> @arquitecto-senior @Tech-lead - docs/testing/** -> @qa-lead @arquitecto-senior - docs/proyecto/** -> @product-owner @arquitecto-senior ACTUALIZACION INDICE.md: - Version 1.2.0 -> 1.3.0 - Total archivos: 90 -> 118 (+28) - Lineas totales: 30,000 -> 35,000 - Agregadas secciones: - 1.2.7 Metodologias - 1.2.8 Marco Integrado IACT - 2. Proyecto (nueva seccion) - 2.1 Vision y Alcance - Actualizado seccion 1.2.3 QA con nuevos documentos - Renumeradas secciones (3. Requisitos, 4. Implementacion) RESULTADO: - 118 archivos de documentacion activa - Integracion completa con workflows CI/CD - Trazabilidad completa: Proceso -> Template -> Workflow - CODEOWNERS actualizado para code review - Limpieza de emojis aplicada a todos los archivos PENDIENTE: - docs_legacy/solicitudes/ (22 archivos - historico, baja prioridad) - docs_legacy/legacy_analysis/ (5 archivos - historico, baja prioridad)
1 parent b111c96 commit 722770d

31 files changed

Lines changed: 16821 additions & 109 deletions

‎.claude/workflow_template_mapping.json‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,13 +56,16 @@
5656
"docs/plantillas/plantilla_tdd.md"
5757
],
5858
"procedimientos": [
59-
"docs/gobernanza/procesos/procedimientos/procedimiento_qa.md"
59+
"docs/gobernanza/procesos/procedimientos/procedimiento_qa.md",
60+
"docs/gobernanza/procesos/estrategia_qa.md",
61+
"docs/gobernanza/procesos/actividades_garantia_documental.md"
6062
],
6163
"scripts": [
6264
"scripts/ci/test_pyramid_check.sh"
6365
],
6466
"checklists": [
65-
"docs/gobernanza/procesos/checklists/checklist_testing.md"
67+
"docs/gobernanza/procesos/checklists/checklist_testing.md",
68+
"docs/gobernanza/procesos/checklists/checklist_auditoria_restricciones.md"
6669
],
6770
"agentes": [
6871
"scripts/ai/agents/sdlc_testing.py"
@@ -192,6 +195,8 @@
192195
"procedimiento_desarrollo_local.md": ["backend-ci", "frontend-ci"],
193196
"guia_completa_desarrollo_features.md": ["backend-ci"],
194197
"procedimiento_qa.md": ["test-pyramid"],
198+
"estrategia_qa.md": ["test-pyramid"],
199+
"actividades_garantia_documental.md": ["test-pyramid"],
195200
"procedimiento_release.md": ["deploy"],
196201
"procedimiento_diseno_tecnico.md": ["migrations"],
197202
"procedimiento_instalacion_entorno.md": ["infrastructure-ci"],

‎.github/CODEOWNERS‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,9 @@ docs/vision_y_alcance/** @product-owner @arquitecto-senior
5151
# Gobernanza y Procesos
5252
# Owner: Arquitecto Senior + Tech Lead
5353
docs/gobernanza/** @arquitecto-senior @tech-lead
54+
docs/gobernanza/metodologias/** @arquitecto-senior @tech-lead
55+
docs/gobernanza/marco_integrado/** @arquitecto-senior @tech-lead
56+
docs/gobernanza/agentes/** @arquitecto-senior @tech-lead
5457

5558
# SDLC Outputs (issues, plans, reports auto-generados)
5659
# Owner: Arquitecto Senior
@@ -60,6 +63,14 @@ docs/sdlc_outputs/** @arquitecto-senior
6063
# Owner: Arquitecto Senior
6164
docs/plantillas/** @arquitecto-senior
6265

66+
# Testing y QA
67+
# Owner: QA Lead
68+
docs/testing/** @qa-lead @arquitecto-senior
69+
70+
# Proyecto y Vision
71+
# Owner: Product Owner + Arquitecto Senior
72+
docs/proyecto/** @product-owner @arquitecto-senior
73+
6374
# ============================================================================
6475
# DOCUMENTACIÓN AUTO-GENERADA
6576
# ============================================================================

‎docs/INDICE.md‎

Lines changed: 86 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,23 @@
22
id: DOC-INDICE-GENERAL
33
tipo: indice
44
categoria: documentacion
5-
version: 1.2.0
5+
version: 1.3.0
66
fecha_creacion: 2025-11-06
77
fecha_migracion: 2025-11-06
88
fecha_actualizacion: 2025-11-06
99
propietario: equipo-gobernanza
10-
archivos_totales: 90
11-
lineas_totales: 30000
12-
relacionados: ["docs_legacy/README.md", "gobernanza/procesos/MAPEO_PROCESOS_TEMPLATES.md"]
10+
archivos_totales: 118
11+
lineas_totales: 35000
12+
relacionados: ["docs_legacy/README.md", "gobernanza/procesos/MAPEO_PROCESOS_TEMPLATES.md", ".claude/workflow_template_mapping.json"]
1313
---
1414

1515
# INDICE GENERAL - Documentacion IACT
1616

17-
**VERSION:** 1.2.0
17+
**VERSION:** 1.3.0
1818
**FECHA MIGRACION:** 2025-11-06
1919
**FECHA ACTUALIZACION:** 2025-11-06
20-
**ARCHIVOS MIGRADOS:** 90
21-
**LINEAS MIGRADAS:** ~30,000
20+
**ARCHIVOS MIGRADOS:** 118
21+
**LINEAS MIGRADAS:** ~35,000
2222
**ESTRUCTURA:** BABOK v3 + PMBOK 7 + ISO/IEC/IEEE 29148:2018
2323

2424
---
@@ -101,20 +101,31 @@ Documentacion de estilos, estandares, procesos y lineamientos del proyecto.
101101

102102
#### 1.2.3 QA
103103

104-
**Ubicacion:** `docs/gobernanza/procesos/qa/`
104+
**Ubicacion:** `docs/gobernanza/procesos/`
105105

106106
| Archivo | Descripcion | Prioridad |
107107
|---------|-------------|-----------|
108-
| [ESTRATEGIA_QA.md](gobernanza/procesos/qa/ESTRATEGIA_QA.md) | Estrategia QA oficial (coverage 80%, TDD, metricas) | CRITICA |
109-
| [README.md](gobernanza/procesos/qa/README.md) | Indice de documentos QA | ALTA |
110-
| [actividades_garantia_documental.md](gobernanza/procesos/qa/actividades_garantia_documental.md) | Actividades de garantia documental | MEDIA |
111-
| [checklist_auditoria_restricciones.md](gobernanza/procesos/qa/checklist_auditoria_restricciones.md) | Auditoria de restricciones IACT (RNF-002, NO Redis) | ALTA |
108+
| [estrategia_qa.md](gobernanza/procesos/estrategia_qa.md) | Estrategia QA oficial (coverage 80%, TDD, metricas) | CRITICA |
109+
| [actividades_garantia_documental.md](gobernanza/procesos/actividades_garantia_documental.md) | Actividades de garantia documental | MEDIA |
110+
111+
**Checklists QA:**
112+
| Archivo | Descripcion | Prioridad |
113+
|---------|-------------|-----------|
114+
| [checklist_testing.md](gobernanza/procesos/checklists/checklist_testing.md) | Unit, integration, E2E, coverage | ALTA |
115+
| [checklist_auditoria_restricciones.md](gobernanza/procesos/checklists/checklist_auditoria_restricciones.md) | Auditoria de restricciones IACT (RNF-002, NO Redis) | ALTA |
116+
117+
**Registros de Testing:**
118+
**Ubicacion:** `docs/testing/registros/`
119+
120+
Historico de ejecuciones de pytest y validaciones QA.
112121

113122
**Metricas QA:**
114123
- Cobertura unitaria: >= 80%
115124
- Tiempo medio para corregir fallos criticos: <= 2 dias
116125
- Actividades de control documental: 100% por release
117126

127+
**Integracion:** Vinculado con workflow test-pyramid y procedimiento_qa.md
128+
118129
---
119130

120131
#### 1.2.4 CI/CD
@@ -184,6 +195,43 @@ Documentacion de estilos, estandares, procesos y lineamientos del proyecto.
184195

185196
---
186197

198+
#### 1.2.7 Metodologias
199+
200+
**Ubicacion:** `docs/gobernanza/metodologias/`
201+
202+
| Archivo | Descripcion | Prioridad |
203+
|---------|-------------|-----------|
204+
| [README.md](gobernanza/metodologias/README.md) | Indice de metodologias | ALTA |
205+
| [METODOLOGIA_DESARROLLO_POR_LOTES.md](gobernanza/metodologias/METODOLOGIA_DESARROLLO_POR_LOTES.md) | Metodologia de desarrollo incremental por lotes | ALTA |
206+
| [WORKFLOWS_COMPLETOS.md](gobernanza/metodologias/WORKFLOWS_COMPLETOS.md) | Documentacion completa de workflows CI/CD | ALTA |
207+
| [agentes_automatizacion.md](gobernanza/metodologias/agentes_automatizacion.md) | Vision general de agentes IA para automatizacion | MEDIA |
208+
| [arquitectura_agentes_especializados.md](gobernanza/metodologias/arquitectura_agentes_especializados.md) | Arquitectura detallada de agentes SDLC especializados | MEDIA |
209+
210+
**Uso:** Consultar antes de empezar desarrollo para entender metodologia de lotes y uso de agentes IA.
211+
212+
---
213+
214+
#### 1.2.8 Marco Integrado IACT
215+
216+
**Ubicacion:** `docs/gobernanza/marco_integrado/`
217+
218+
**Total:** 8 archivos | **Estandares:** BABOK v3, ISO/IEC/IEEE 29148:2018
219+
220+
| Archivo | Descripcion | Prioridad |
221+
|---------|-------------|-----------|
222+
| [00_resumen_ejecutivo_mejores_practicas.md](gobernanza/marco_integrado/00_resumen_ejecutivo_mejores_practicas.md) | Resumen ejecutivo del marco integrado | ALTA |
223+
| [01_marco_conceptual_iact.md](gobernanza/marco_integrado/01_marco_conceptual_iact.md) | Marco conceptual completo IACT | ALTA |
224+
| [02_relaciones_fundamentales_iact.md](gobernanza/marco_integrado/02_relaciones_fundamentales_iact.md) | Relaciones entre conceptos BA | ALTA |
225+
| [03_matrices_trazabilidad_iact.md](gobernanza/marco_integrado/03_matrices_trazabilidad_iact.md) | Matrices de trazabilidad completas | ALTA |
226+
| [04_metodologia_analisis_iact.md](gobernanza/marco_integrado/04_metodologia_analisis_iact.md) | Metodologia de analisis reproducible | ALTA |
227+
| [05a_casos_practicos_iact.md](gobernanza/marco_integrado/05a_casos_practicos_iact.md) | Casos practicos reales del proyecto | MEDIA |
228+
| [05b_caso_didactico_generico.md](gobernanza/marco_integrado/05b_caso_didactico_generico.md) | Caso didactico generico | MEDIA |
229+
| [06_plantillas_integradas_iact.md](gobernanza/marco_integrado/06_plantillas_integradas_iact.md) | Plantillas integradas | MEDIA |
230+
231+
**Proposito:** Framework completo de analisis de negocio con trazabilidad desde necesidades hasta implementacion.
232+
233+
---
234+
187235
### 1.3 Archivos Root de Gobernanza
188236

189237
**Ubicacion:** `docs/gobernanza/`
@@ -199,11 +247,28 @@ Documentacion de estilos, estandares, procesos y lineamientos del proyecto.
199247

200248
---
201249

202-
## 2. Requisitos
250+
## 2. Proyecto
251+
252+
Documentacion de vision, alcance y planificacion del proyecto.
253+
254+
### 2.1 Vision y Alcance
255+
256+
**Ubicacion:** `docs/proyecto/`
257+
258+
| Archivo | Descripcion | Prioridad |
259+
|---------|-------------|-----------|
260+
| [vision_y_alcance.md](proyecto/vision_y_alcance.md) | Vision y alcance del proyecto IACT | CRITICA |
261+
| [glossary.md](proyecto/glossary.md) | Glosario de terminos del proyecto | ALTA |
262+
263+
**Uso:** Consultar antes de empezar cualquier feature para entender vision y alcance del proyecto.
264+
265+
---
266+
267+
## 3. Requisitos
203268

204269
Documentacion de requisitos, analisis de negocio, y business needs.
205270

206-
### 2.1 Analisis de Negocio - Marco Integrado
271+
### 3.1 Analisis de Negocio - Marco Integrado
207272

208273
**Ubicacion:** `docs/requisitos/analisis_negocio/marco_integrado/`
209274

@@ -230,7 +295,7 @@ Documentacion de requisitos, analisis de negocio, y business needs.
230295

231296
---
232297

233-
### 2.2 Business Needs
298+
### 3.2 Business Needs
234299

235300
**Ubicacion:** `docs/requisitos/business_needs/`
236301

@@ -246,15 +311,15 @@ business_needs/
246311

247312
---
248313

249-
## 3. Implementacion
314+
## 4. Implementacion
250315

251316
Documentacion tecnica de implementacion, infrastructure, agentes, y runbooks operacionales.
252317

253-
### 3.1 Infrastructure
318+
### 4.1 Infrastructure
254319

255320
**Ubicacion:** `docs/implementacion/infrastructure/`
256321

257-
#### 3.1.1 Archivos Root
322+
#### 4.1.1 Archivos Root
258323

259324
| Archivo | Descripcion |
260325
|---------|-------------|
@@ -264,7 +329,7 @@ Documentacion tecnica de implementacion, infrastructure, agentes, y runbooks ope
264329

265330
---
266331

267-
#### 3.1.2 Runbooks
332+
#### 4.1.2 Runbooks
268333

269334
**Ubicacion:** `docs/implementacion/infrastructure/runbooks/`
270335

@@ -287,11 +352,11 @@ Documentacion tecnica de implementacion, infrastructure, agentes, y runbooks ope
287352

288353
---
289354

290-
### 3.2 Agentes
355+
### 4.2 Agentes
291356

292357
**Ubicacion:** `docs/implementacion/agentes/`
293358

294-
#### 3.2.1 Agentes SDLC (Activos)
359+
#### 4.2.1 Agentes SDLC (Activos)
295360

296361
**Ver:** [docs/gobernanza/procesos/AGENTES_SDLC.md](gobernanza/procesos/AGENTES_SDLC.md)
297362

0 commit comments

Comments
 (0)