rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
41497a731f
workspace-v1/orchestration/analisis/PLAN-EJECUCION-DOCUMENTACION-2026-01-07.md
rckrdmrd ff3038f183 feat(orchestration): Add subagent token management system 
Sistema completo de gestión de tokens para subagentes NEXUS v4.0:

Nuevas directivas SIMCO:
- SIMCO-SUBAGENTE.md: Protocolo para agentes en modo subagente
- SIMCO-CCA-SUBAGENTE.md: CCA ligero para subagentes (~1,500 tokens)
- SIMCO-CONTROL-TOKENS.md: Gestión de límites de tokens
- SIMCO-DELEGACION-PARALELA.md: Delegación paralela

Perfiles compact (~250 tokens cada uno):
- PERFIL-BACKEND-COMPACT.md
- PERFIL-FRONTEND-COMPACT.md
- PERFIL-DATABASE-COMPACT.md
- PERFIL-DEVOPS-COMPACT.md
- PERFIL-ML-COMPACT.md
- PERFIL-GENERIC-SUBAGENT.md

Templates de delegación escalonados:
- TEMPLATE-DELEGACION-MINIMA.md (~250 tokens)
- TEMPLATE-DELEGACION-ESTANDAR.md (~600 tokens)
- TEMPLATE-DELEGACION-COMPLETA.md (~1,800 tokens)

Nuevos perfiles especializados:
- PERFIL-MCP-ARCHITECT.md
- PERFIL-MCP-DEVELOPER.md
- PERFIL-RAG-ENGINEER.md
- PERFIL-CICD-SPECIALIST.md
- PERFIL-PRODUCTION-MANAGER.md
- PERFIL-MONITORING-AGENT.md
- PERFIL-SECRETS-MANAGER.md
- PERFIL-PROPAGATION-TRACKER.md

Checklists y documentación:
- CHECKLIST-PRE-DELEGACION.md
- Análisis y planes de implementación

Métricas de mejora:
- ~59% reducción de tokens por delegación
- Perfiles compact: 69% más ligeros
- CCA subagente: 85% más ligero

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 04:43:01 -06:00

411 lines
16 KiB
Markdown
Raw Blame History

# PLAN DE EJECUCION - ESTANDARIZACION DOCUMENTACION WORKSPACE
**Fecha:** 2026-01-07
**Sistema:** NEXUS v4.0 + SIMCO v2.5
**Responsable:** Agente Orquestador Workspace
**Estado:** FASE 3 - PLANEACION
---
## 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
```
Proyecto | Estructura | Vision | Modulos | Epicas | US | Total
------------------|------------|--------|---------|--------|-----|------
clinica-dental | [ ] | [ ] | [ ] | N/A | N/A | 0%
clinica-veterinaria| [ ] | [ ] | [ ] | N/A | N/A | 0%
michangarrito | [ ] | [x] | N/A | [ ] | N/A | 0%
template-saas | [ ] | [x] | [ ] | N/A | N/A | 0%
erp-retail | [x] | [x] | [x] | [ ] | [ ] | 30%
erp-vidrio | [x] | [x] | [x] | [ ] | [ ] | 30%
erp-clinicas | [x] | [x] | [x] | [ ] | [ ] | 30%
```
---
## 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. PROXIMOS PASOS INMEDIATOS
### HOY (4 horas)
1. **Crear CONTEXT-MAP.yml** para clinica-dental (3h)
2. **Crear PROXIMA-ACCION.md** para michangarrito (1h)
### MANANA (4 horas)
1. **Crear CONTEXT-MAP.yml** para clinica-veterinaria (3h)
2. **Crear CONTEXT-MAP.yml** para template-saas (1h - basado en template)
### ESTA SEMANA (32 horas)
1. Completar Sprint 1 completo
2. Validar estructura de 4 proyectos
3. Iniciar Sprint 2 (Vision clinicas)
---
## 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
Reference in New Issue View Git Blame Copy Permalink