workspace-v1/orchestration/analisis/PLAN-EJECUCION-DOCUMENTACION-2026-01-07.md

# PLAN DE EJECUCION - ESTANDARIZACION DOCUMENTACION WORKSPACE

**Fecha:** 2026-01-07
**Sistema:** NEXUS v4.0 + SIMCO v2.5
**Responsable:** Agente Orquestador Workspace
**Estado:** SPRINT 2 COMPLETADO - Listo para Sprint 3

---

## 1. RESUMEN DEL PLAN

### Alcance Total

| Metrica | Valor |
|---------|-------|
| Proyectos a intervenir | 7 |
| Archivos a crear | ~340+ |
| Horas totales | ~928h |
| Sprints estimados | 12 sprints (2 semanas c/u) |
| Equipo recomendado | 2-3 agentes paralelos |

### Objetivos del Plan

1. **Corto Plazo (Sprint 1-2):** Completar estructura basica de proyectos P0
2. **Mediano Plazo (Sprint 3-6):** Documentar modulos y epicas
3. **Largo Plazo (Sprint 7-12):** User Stories para ERP verticales

---

## 2. ESTRUCTURA DE SPRINTS

### SPRINT 1: Estructura Base P0 (Semana 1-2)

**Objetivo:** Desbloquear proyectos criticos con estructura SIMCO basica

**Horas:** 32h | **Archivos:** 16

| ID | Tarea | Proyecto | Archivo | Perfil | Horas | Dependencia |
|----|-------|----------|---------|--------|-------|-------------|
| S1-01 | Crear CONTEXT-MAP.yml | clinica-dental | orchestration/CONTEXT-MAP.yml | ORQUESTADOR | 3 | - |
| S1-02 | Crear PROXIMA-ACCION.md | clinica-dental | orchestration/PROXIMA-ACCION.md | ORQUESTADOR | 2 | S1-01 |
| S1-03 | Crear _MAP.md orchestration | clinica-dental | orchestration/_MAP.md | ORQUESTADOR | 1 | S1-02 |
| S1-04 | Crear CONTEXT-MAP.yml | clinica-veterinaria | orchestration/CONTEXT-MAP.yml | ORQUESTADOR | 3 | - |
| S1-05 | Crear PROXIMA-ACCION.md | clinica-veterinaria | orchestration/PROXIMA-ACCION.md | ORQUESTADOR | 2 | S1-04 |
| S1-06 | Crear PROJECT-STATUS.md | clinica-veterinaria | orchestration/PROJECT-STATUS.md | ORQUESTADOR | 1 | S1-05 |
| S1-07 | Crear _MAP.md orchestration | clinica-veterinaria | orchestration/_MAP.md | ORQUESTADOR | 1 | S1-05 |
| S1-08 | Crear PROXIMA-ACCION.md | michangarrito | orchestration/PROXIMA-ACCION.md | ORQUESTADOR | 1.5 | - |
| S1-09 | Crear docs/_MAP.md | michangarrito | docs/_MAP.md | REQUIREMENTS | 0.5 | S1-08 |
| S1-10 | Crear CONTEXT-MAP.yml | template-saas | orchestration/CONTEXT-MAP.yml | ORQUESTADOR | 2 | - |
| S1-11 | Crear docs/_MAP.md | template-saas | docs/_MAP.md | REQUIREMENTS | 1 | S1-10 |
| S1-12 | Crear 01-modulos/_MAP.md | template-saas | docs/01-modulos/_MAP.md | REQUIREMENTS | 1 | S1-11 |
| S1-13 | Validar estructura SIMCO | clinica-dental | N/A | TECH-LEADER | 2 | S1-03 |
| S1-14 | Validar estructura SIMCO | clinica-veterinaria | N/A | TECH-LEADER | 2 | S1-07 |
| S1-15 | Validar estructura SIMCO | michangarrito | N/A | TECH-LEADER | 2 | S1-09 |
| S1-16 | Validar estructura SIMCO | template-saas | N/A | TECH-LEADER | 2 | S1-12 |

**Entregables Sprint 1:**
- 4 proyectos con CONTEXT-MAP.yml
- 4 proyectos con PROXIMA-ACCION.md
- 4 proyectos con docs/_MAP.md
- Validacion de estructura SIMCO

---

### SPRINT 2: Vision y Modulos Clinicas (Semana 3-4)

**Objetivo:** Completar documentacion de vision y modulos para clinicas

**Horas:** 40h | **Archivos:** 18

| ID | Tarea | Proyecto | Archivo | Perfil | Horas | Dependencia |
|----|-------|----------|---------|--------|-------|-------------|
| S2-01 | Crear VISION.md | clinica-dental | docs/00-vision-general/VISION.md | REQUIREMENTS | 3 | S1-01 |
| S2-02 | Crear _MAP.md vision | clinica-dental | docs/00-vision-general/_MAP.md | REQUIREMENTS | 1 | S2-01 |
| S2-03 | Crear _MAP.md modulos | clinica-dental | docs/02-definicion-modulos/_MAP.md | REQUIREMENTS | 2 | S2-02 |
| S2-04 | Crear modulo-odontograma.md | clinica-dental | docs/02-definicion-modulos/modulo-odontograma.md | DATABASE + REQUIREMENTS | 3 | S2-03 |
| S2-05 | Crear modulo-tratamientos.md | clinica-dental | docs/02-definicion-modulos/modulo-tratamientos.md | DATABASE + REQUIREMENTS | 2 | S2-04 |
| S2-06 | Crear modulo-ortodoncia.md | clinica-dental | docs/02-definicion-modulos/modulo-ortodoncia.md | DATABASE + REQUIREMENTS | 2 | S2-05 |
| S2-07 | Crear modulo-protesis.md | clinica-dental | docs/02-definicion-modulos/modulo-protesis.md | DATABASE + REQUIREMENTS | 2 | S2-06 |
| S2-08 | Crear VISION.md | clinica-veterinaria | docs/00-vision-general/VISION.md | REQUIREMENTS | 3 | S1-04 |
| S2-09 | Crear _MAP.md vision | clinica-veterinaria | docs/00-vision-general/_MAP.md | REQUIREMENTS | 1 | S2-08 |
| S2-10 | Crear _MAP.md modulos | clinica-veterinaria | docs/02-definicion-modulos/_MAP.md | REQUIREMENTS | 2 | S2-09 |
| S2-11 | Crear modulo-mascotas.md | clinica-veterinaria | docs/02-definicion-modulos/modulo-mascotas.md | DATABASE + REQUIREMENTS | 3 | S2-10 |
| S2-12 | Crear modulo-propietarios.md | clinica-veterinaria | docs/02-definicion-modulos/modulo-propietarios.md | DATABASE + REQUIREMENTS | 2 | S2-11 |
| S2-13 | Crear modulo-vacunacion.md | clinica-veterinaria | docs/02-definicion-modulos/modulo-vacunacion.md | DATABASE + REQUIREMENTS | 2.5 | S2-12 |
| S2-14 | Crear modulo-hospitalizacion.md | clinica-veterinaria | docs/02-definicion-modulos/modulo-hospitalizacion.md | DATABASE + REQUIREMENTS | 2 | S2-13 |
| S2-15 | Crear modulo-farmacia.md | clinica-veterinaria | docs/02-definicion-modulos/modulo-farmacia.md | DATABASE + REQUIREMENTS | 3 | S2-14 |
| S2-16 | Validar modulos dental | clinica-dental | N/A | TECH-LEADER | 2 | S2-07 |
| S2-17 | Validar modulos veterinaria | clinica-veterinaria | N/A | TECH-LEADER | 2 | S2-15 |
| S2-18 | Actualizar MASTER_INVENTORY | ambas clinicas | orchestration/inventarios/ | DATABASE | 2 | S2-17 |

**Entregables Sprint 2:**
- VISION.md para ambas clinicas
- 9 documentos de modulos especificos
- Inventarios actualizados

---

### SPRINT 3: Inventarios y Epicas MiChangarrito (Semana 5-6)

**Objetivo:** Completar inventarios especializados y primeras 14 epicas

**Horas:** 40h | **Archivos:** 20

| ID | Tarea | Proyecto | Archivo | Perfil | Horas | Dependencia |
|----|-------|----------|---------|--------|-------|-------------|
| S3-01 | Crear DATABASE_INVENTORY.yml | michangarrito | orchestration/inventarios/DATABASE_INVENTORY.yml | DATABASE | 1.5 | S1-09 |
| S3-02 | Crear BACKEND_INVENTORY.yml | michangarrito | orchestration/inventarios/BACKEND_INVENTORY.yml | BACKEND | 1.5 | S3-01 |
| S3-03 | Crear FRONTEND_INVENTORY.yml | michangarrito | orchestration/inventarios/FRONTEND_INVENTORY.yml | FRONTEND | 1 | S3-02 |
| S3-04 | Crear DEPENDENCIAS.yml | michangarrito | orchestration/referencias/DEPENDENCIAS.yml | ARCHITECTURE | 1 | S3-03 |
| S3-05 | Crear TRAZA-DATABASE.md | michangarrito | orchestration/trazas/TRAZA-TAREAS-DATABASE.md | DATABASE | 1 | S3-04 |
| S3-06 | Crear TRAZA-FRONTEND.md | michangarrito | orchestration/trazas/TRAZA-TAREAS-FRONTEND.md | FRONTEND | 1 | S3-05 |
| S3-07 | Crear MCH-001.md | michangarrito | docs/01-epicas/MCH-001-infraestructura-base.md | REQUIREMENTS | 1.5 | S3-06 |
| S3-08 | Crear MCH-002.md | michangarrito | docs/01-epicas/MCH-002-autenticacion.md | REQUIREMENTS | 1.5 | S3-07 |
| S3-09 | Crear MCH-003.md | michangarrito | docs/01-epicas/MCH-003-catalogo-productos.md | REQUIREMENTS | 1.5 | S3-08 |
| S3-10 | Crear MCH-004.md | michangarrito | docs/01-epicas/MCH-004-punto-venta.md | REQUIREMENTS | 1.5 | S3-09 |
| S3-11 | Crear MCH-005.md | michangarrito | docs/01-epicas/MCH-005-pagos.md | REQUIREMENTS | 1.5 | S3-10 |
| S3-12 | Crear MCH-006.md | michangarrito | docs/01-epicas/MCH-006-onboarding.md | REQUIREMENTS | 1.5 | S3-11 |
| S3-13 | Crear MCH-007.md | michangarrito | docs/01-epicas/MCH-007-templates.md | REQUIREMENTS | 1.5 | S3-12 |
| S3-14 | Crear MCH-008.md | michangarrito | docs/01-epicas/MCH-008-fiados.md | REQUIREMENTS | 1.5 | S3-13 |
| S3-15 | Crear MCH-009.md | michangarrito | docs/01-epicas/MCH-009-prediccion.md | REQUIREMENTS | 1.5 | S3-14 |
| S3-16 | Crear MCH-010.md | michangarrito | docs/01-epicas/MCH-010-mcp-server.md | REQUIREMENTS | 1.5 | S3-15 |
| S3-17 | Crear MCH-011.md | michangarrito | docs/01-epicas/MCH-011-whatsapp.md | REQUIREMENTS | 1.5 | S3-16 |
| S3-18 | Crear MCH-012.md | michangarrito | docs/01-epicas/MCH-012-chat-dueno.md | REQUIREMENTS | 1.5 | S3-17 |
| S3-19 | Crear MCH-013.md | michangarrito | docs/01-epicas/MCH-013-chat-cliente.md | REQUIREMENTS | 1.5 | S3-18 |
| S3-20 | Crear MCH-014.md | michangarrito | docs/01-epicas/MCH-014-gestion-clientes.md | REQUIREMENTS | 1.5 | S3-19 |

**Entregables Sprint 3:**
- 6 inventarios y trazas
- 14 epicas documentadas (MCH-001 a MCH-014)

---

### SPRINT 4: Epicas MiChangarrito + Template-SaaS Base (Semana 7-8)

**Objetivo:** Completar epicas restantes y base de modulos template

**Horas:** 40h | **Archivos:** 18

| ID | Tarea | Proyecto | Archivo | Perfil | Horas | Dependencia |
|----|-------|----------|---------|--------|-------|-------------|
| S4-01-14 | Crear MCH-015 a MCH-028 | michangarrito | docs/01-epicas/MCH-0XX.md (14 archivos) | REQUIREMENTS | 21 | S3-20 |
| S4-15 | Validar epicas completas | michangarrito | N/A | TECH-LEADER | 2 | S4-14 |
| S4-16 | Crear SAAS-001-auth/README.md | template-saas | docs/01-modulos/SAAS-001-auth/README.md | REQUIREMENTS | 1 | S1-12 |
| S4-17 | Crear SAAS-002-tenants/README.md | template-saas | docs/01-modulos/SAAS-002-tenants/README.md | REQUIREMENTS | 1 | S4-16 |
| S4-18 | Crear SAAS-003 a SAAS-012 README | template-saas | 10 archivos README.md | REQUIREMENTS | 10 | S4-17 |

**Entregables Sprint 4:**
- 14 epicas adicionales MCH (28 total)
- 12 README de modulos template-saas

---

### SPRINT 5-6: Especificaciones Template-SaaS (Semana 9-12)

**Objetivo:** Documentar especificaciones de modulos template

**Horas:** 80h | **Archivos:** 36

Cada modulo SAAS-001 a SAAS-012 requiere:
- ESPECIFICACION.md (5h)
- FLUJOS.md (2h)
- IMPLEMENTACION.md (4h)

**Tareas paralelas por modulo:**

| Sprint | Modulos | Archivos | Horas |
|--------|---------|----------|-------|
| S5 | SAAS-001 a SAAS-006 | 18 | 40 |
| S6 | SAAS-007 a SAAS-012 | 18 | 40 |

---

### SPRINT 7-12: User Stories ERP Verticales (Semana 13-24)

**Objetivo:** Crear User Stories para ERP Retail, Vidrio, Clinicas

**Horas:** 550h | **Archivos:** 173+ US

| Sprint | Proyecto | Modulos | US | Horas |
|--------|----------|---------|-----|-------|
| S7 | erp-retail | RT-002, RT-003 | 15 | 72 |
| S8 | erp-retail | RT-004 a RT-010 | 15 | 108 |
| S9 | erp-vidrio | VT-002 a VT-004 | 14 | 64 |
| S10 | erp-vidrio | VT-005 a VT-008 | 14 | 66 |
| S11 | erp-clinicas | CL-002 a CL-006 | 25 | 120 |
| S12 | erp-clinicas | CL-007 a CL-012 | 20 | 120 |

---

## 3. ASIGNACION DE PERFILES POR TAREA

### Matriz de Responsabilidades

| Tipo Tarea | Perfil Principal | Perfil Soporte |
|------------|-----------------|----------------|
| CONTEXT-MAP.yml | ORQUESTADOR | - |
| PROXIMA-ACCION.md | ORQUESTADOR | REQUIREMENTS |
| VISION.md | REQUIREMENTS | ARCHITECTURE |
| _MAP.md | REQUIREMENTS | - |
| Modulos especificos | DATABASE + REQUIREMENTS | BACKEND |
| Inventarios | DATABASE/BACKEND/FRONTEND | - |
| Epicas | REQUIREMENTS | TECH-LEADER |
| Especificaciones | REQUIREMENTS + BACKEND | DATABASE |
| User Stories | REQUIREMENTS | TECH-LEADER |
| Validacion | TECH-LEADER | ARCHITECTURE |

### Capacidad por Sprint (40h disponible)

| Perfil | Horas/Sprint | Tareas Primarias |
|--------|--------------|------------------|
| ORQUESTADOR | 10h | CONTEXT-MAP, PROXIMA-ACCION |
| REQUIREMENTS | 20h | Documentacion tecnica |
| DATABASE | 5h | Inventarios DB, modulos |
| BACKEND | 3h | Inventarios BE |
| FRONTEND | 2h | Inventarios FE |
| TECH-LEADER | 5h | Validacion |
| ARCHITECTURE | 5h | Revision arquitectura |

---

## 4. CRITERIOS DE ACEPTACION POR TIPO

### CONTEXT-MAP.yml

- [ ] Variables del proyecto resueltas
- [ ] Nivel SIMCO correcto (STANDALONE/VERTICAL/SUITE)
- [ ] Aliases definidos
- [ ] Estimaciones de tokens por tarea
- [ ] Herencia correctamente configurada

### PROXIMA-ACCION.md

- [ ] Estado actual del proyecto
- [ ] Metricas de progreso
- [ ] Siguiente tarea priorizada
- [ ] Dependencias identificadas
- [ ] Riesgos documentados

### VISION.md

- [ ] Proposito del sistema
- [ ] Objetivos principales (3-5)
- [ ] Usuarios y roles clave
- [ ] Funcionalidades core
- [ ] Metricas de exito
- [ ] Fases de desarrollo

### Modulo-*.md

- [ ] ID del modulo
- [ ] Descripcion clara
- [ ] Entidades principales (tabla)
- [ ] Relaciones con otros modulos
- [ ] API Endpoints (pendientes)
- [ ] Validaciones
- [ ] Casos de uso
- [ ] Estado de implementacion

### User Story (US-*.md)

- [ ] Metadata completa (ID, Epic, Prioridad, SP)
- [ ] Formato "Como X, quiero Y para Z"
- [ ] Criterios de aceptacion (Gherkin)
- [ ] Tareas tecnicas desglosadas
- [ ] Dependencias
- [ ] Definition of Ready
- [ ] Definition of Done

---

## 5. DEPENDENCIAS CRITICAS

### Diagrama de Dependencias

```
SPRINT 1 (Estructura Base)
    ├── clinica-dental: CONTEXT-MAP → PROXIMA-ACCION → _MAP
    ├── clinica-veterinaria: CONTEXT-MAP → PROXIMA-ACCION → _MAP
    ├── michangarrito: PROXIMA-ACCION → docs/_MAP
    └── template-saas: CONTEXT-MAP → docs/_MAP → 01-modulos/_MAP

SPRINT 2 (Clinicas)
    ├── clinica-dental: VISION → modulos (4)
    └── clinica-veterinaria: VISION → modulos (5)

SPRINT 3-4 (MiChangarrito + Template)
    ├── michangarrito: Inventarios → Epicas (28)
    └── template-saas: README modulos (12)

SPRINT 5-6 (Template)
    └── template-saas: ESPECIFICACION → FLUJOS → IMPLEMENTACION

SPRINT 7-12 (ERP Verticales)
    ├── erp-retail: US (30+)
    ├── erp-vidrio: US (28+)
    └── erp-clinicas: US (45+)
```

### Bloqueos Identificados

| Tarea | Bloqueada Por | Impacto |
|-------|--------------|---------|
| Modulos clinicas | VISION.md | No se puede especificar sin vision |
| Epicas MCH | PROXIMA-ACCION.md | Falta contexto de estado |
| Especificaciones template | README modulos | Falta estructura base |
| US ERP verticales | Estructura docs | Falta organizacion |

---

## 6. METRICAS DE SEGUIMIENTO

### KPIs por Sprint

| KPI | Meta | Medicion |
|-----|------|----------|
| Archivos creados | 100% del plan | Conteo vs plan |
| Validacion pasada | 100% archivos | Checklist SIMCO |
| Horas reales vs plan | +/- 20% | Tracking tiempo |
| Dependencias resueltas | 0 bloqueantes | Conteo bloqueantes |

### Dashboard de Progreso (Actualizado 2026-01-07)

```
Proyecto          | Estructura | Vision | Modulos | Epicas | US | Total
------------------|------------|--------|---------|--------|-----|------
clinica-dental    | [x]        | [ ]    | [ ]     | N/A    | N/A | 30%
clinica-veterinaria| [x]       | [ ]    | [ ]     | N/A    | N/A | 30%
michangarrito     | [x]        | [x]    | N/A     | [ ]    | N/A | 40%
template-saas     | [x]        | [x]    | [ ]     | N/A    | N/A | 40%
erp-retail        | [x]        | [x]    | [x]     | [ ]    | [ ] | 30%
erp-vidrio        | [x]        | [x]    | [x]     | [ ]    | [ ] | 30%
erp-clinicas      | [x]        | [x]    | [x]     | [ ]    | [ ] | 30%
```

### Archivos Sprint 1 Creados

| Archivo | Proyecto | Estado |
|---------|----------|--------|
| CONTEXT-MAP.yml | clinica-dental | CREADO |
| CONTEXT-MAP.yml | clinica-veterinaria | CREADO |
| CONTEXT-MAP.yml | template-saas | CREADO |
| CONTEXT-MAP.yml | michangarrito | CREADO |
| PROXIMA-ACCION.md | clinica-dental | CREADO |
| PROXIMA-ACCION.md | clinica-veterinaria | CREADO |
| PROXIMA-ACCION.md | michangarrito | CREADO |
| docs/_MAP.md | clinica-dental | CREADO |
| docs/_MAP.md | clinica-veterinaria | CREADO |
| docs/_MAP.md | template-saas | CREADO |
| docs/_MAP.md | michangarrito | CREADO |

**Total Sprint 1:** 11 archivos + 2 reportes de analisis

---

## 7. RIESGOS Y CONTINGENCIAS

| Riesgo | Probabilidad | Impacto | Contingencia |
|--------|-------------|---------|--------------|
| Retraso Sprint 1 | Media | Alto | Buffer 20% integrado |
| Falta expertise clinico | Media | Alto | Consultor medico externo |
| Cambio de prioridades | Media | Medio | Sprints flexibles |
| Recursos insuficientes | Baja | Alto | Paralelizacion de tareas |
| Inconsistencia de formato | Media | Medio | Templates estandar + validacion |

---

## 8. CHECKLIST DE VALIDACION

### Pre-Sprint

- [ ] Plan aprobado
- [ ] Recursos asignados
- [ ] Templates disponibles
- [ ] Dependencias resueltas

### Post-Sprint

- [ ] Todos los archivos creados
- [ ] Validacion SIMCO pasada
- [ ] Cross-references correctos
- [ ] Inventarios actualizados
- [ ] Reporte de sprint generado

---

## 9. PROGRESO Y PROXIMOS PASOS

### COMPLETADO HOY (2026-01-07)

- [x] **CONTEXT-MAP.yml** para 4 proyectos P0 (clinica-dental, clinica-veterinaria, template-saas, michangarrito)
- [x] **PROXIMA-ACCION.md** para clinica-dental, clinica-veterinaria, michangarrito
- [x] **docs/_MAP.md** para 4 proyectos P0
- [x] **Validacion de estructura SIMCO**
- [x] **Reporte de ejecucion Sprint 1**

### PROXIMOS (Sprint 2)

1. **Crear VISION.md** para clinica-dental y clinica-veterinaria
2. **Crear docs/02-definicion-modulos/_MAP.md** para clinicas
3. **Documentar modulos especificos**:
   - modulo-odontograma.md (dental)
   - modulo-mascotas.md (veterinaria)
   - modulo-vacunacion.md (veterinaria)
4. **Crear orchestration/_MAP.md** para 4 proyectos

### ESTA SEMANA RESTANTE

1. Iniciar Sprint 2 (Vision clinicas)
2. Documentar modulos core de clinicas
3. Actualizar PROJECT-STATUS.md de clinica-veterinaria

---

## 10. APROBACION DEL PLAN

### Validacion Requerida

- [ ] Plan revisado por TECH-LEADER
- [ ] Recursos confirmados
- [ ] Timeline aprobado
- [ ] Criterios de aceptacion acordados

### Firmas

| Rol | Nombre | Fecha |
|-----|--------|-------|
| Orquestador | Agente-Workspace | 2026-01-07 |
| Tech-Leader | Pendiente | - |
| Product Owner | Pendiente | - |

---

**Documento generado:** 2026-01-07
**Version:** 1.0
**Siguiente Paso:** FASE 4 - Validacion de Plan vs Analisis