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)

• CONTEXT-MAP.yml para 4 proyectos P0 (clinica-dental, clinica-veterinaria, template-saas, michangarrito)
• PROXIMA-ACCION.md para clinica-dental, clinica-veterinaria, michangarrito
• docs/_MAP.md para 4 proyectos P0
• Validacion de estructura SIMCO
• 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