ff3038f183
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>
303 lines
8.8 KiB
Markdown
303 lines
8.8 KiB
Markdown
# CHECKLIST DE PROPAGACION
|
|
|
|
**Version:** 1.0.0
|
|
**Sistema:** SIMCO v2.2.0
|
|
**Proposito:** Verificar propagacion completa de documentacion entre niveles
|
|
|
|
---
|
|
|
|
## CUANDO USAR ESTE CHECKLIST
|
|
|
|
Ejecutar este checklist DESPUES de completar cualquier tarea que:
|
|
- Crea archivos nuevos (DDL, Entity, Component)
|
|
- Modifica estructura existente
|
|
- Documenta especificaciones
|
|
- Completa una HU
|
|
|
|
---
|
|
|
|
## CHECKLIST POR NIVEL
|
|
|
|
### Nivel 2A: Proyecto Standalone
|
|
|
|
```markdown
|
|
## Propagacion - Proyecto Standalone
|
|
|
|
### Nivel Local (Obligatorio)
|
|
- [ ] Inventario actualizado
|
|
- [ ] MASTER_INVENTORY.yml con nuevo artefacto
|
|
- [ ] {CAPA}_INVENTORY.yml actualizado (DATABASE/BACKEND/FRONTEND)
|
|
- [ ] Traza registrada
|
|
- [ ] TRAZA-TAREAS-{CAPA}.md con entrada de hoy
|
|
- [ ] PROXIMA-ACCION.md actualizado (si aplica)
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Seccion del proyecto actualizada
|
|
- [ ] Fecha de ultima actividad correcta
|
|
- [ ] workspace/orchestration/referencias/PROYECTOS-ACTIVOS.yml
|
|
- [ ] ultima_actividad actualizada (si cambio significativo)
|
|
|
|
### Validacion
|
|
- [ ] Todas las rutas verificadas (archivos existen)
|
|
- [ ] Fechas consistentes entre archivos
|
|
- [ ] Build pasa (si aplica)
|
|
- [ ] No hay referencias rotas
|
|
```
|
|
|
|
---
|
|
|
|
### Nivel 2B.2: Vertical (en Suite)
|
|
|
|
```markdown
|
|
## Propagacion - Vertical en Suite
|
|
|
|
### Nivel Local - Vertical (Obligatorio)
|
|
- [ ] Inventario actualizado
|
|
- [ ] MASTER_INVENTORY.yml con nuevo artefacto
|
|
- [ ] {CAPA}_INVENTORY.yml actualizado
|
|
- [ ] Traza registrada
|
|
- [ ] TRAZA-TAREAS-{CAPA}.md con entrada de hoy
|
|
|
|
### Nivel Suite (Obligatorio)
|
|
- [ ] projects/{suite}/orchestration/inventarios/
|
|
- [ ] SUITE_MASTER_INVENTORY.yml actualizado
|
|
- [ ] STATUS.yml con estado del vertical
|
|
- [ ] REFERENCIAS.yml con puntero al artefacto
|
|
- [ ] projects/{suite}/orchestration/trazas/
|
|
- [ ] TRAZA-SUITE.md con entrada de propagacion
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Seccion de suite actualizada
|
|
- [ ] Metricas de vertical actualizadas
|
|
|
|
### Validacion
|
|
- [ ] Ruta completa verificada (vertical → suite → workspace)
|
|
- [ ] No hay duplicacion de contenido (solo referencias)
|
|
- [ ] Fechas consistentes
|
|
```
|
|
|
|
---
|
|
|
|
### Nivel 2B.1: Suite Core
|
|
|
|
```markdown
|
|
## Propagacion - Suite Core
|
|
|
|
### Nivel Local - Core (Obligatorio)
|
|
- [ ] Inventario actualizado
|
|
- [ ] MASTER_INVENTORY.yml con artefacto
|
|
- [ ] CORE_{CAPA}_INVENTORY.yml actualizado
|
|
- [ ] Traza registrada
|
|
- [ ] TRAZA-CORE.md con entrada
|
|
|
|
### Nivel Suite (Obligatorio)
|
|
- [ ] projects/{suite}/orchestration/inventarios/
|
|
- [ ] SUITE_MASTER_INVENTORY.yml seccion core actualizada
|
|
- [ ] STATUS.yml con estado del core
|
|
- [ ] projects/{suite}/orchestration/trazas/
|
|
- [ ] TRAZA-SUITE.md con entrada
|
|
|
|
### Notificar Verticales (Si aplica)
|
|
- [ ] Si el cambio afecta a verticales:
|
|
- [ ] Notificar en SUITE_MASTER_INVENTORY.yml
|
|
- [ ] Marcar como "NUEVO - Revisar herencia"
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md actualizado
|
|
|
|
### Validacion
|
|
- [ ] Verticales pueden encontrar el nuevo artefacto
|
|
- [ ] Referencias no estan rotas
|
|
```
|
|
|
|
---
|
|
|
|
### Nivel 3: Catalogo
|
|
|
|
```markdown
|
|
## Propagacion - Catalogo de Funcionalidades
|
|
|
|
### Nivel Local - Catalogo (Obligatorio)
|
|
- [ ] shared/catalog/{funcionalidad}/ actualizado
|
|
- [ ] CATALOG-INDEX.yml actualizado
|
|
- [ ] README.md de funcionalidad actualizado
|
|
|
|
### Nivel Core (Obligatorio)
|
|
- [ ] core/orchestration/inventarios/ actualizado
|
|
- [ ] Entrada en CATALOG-USAGE-TRACKING.yml
|
|
|
|
### Notificar Consumidores (Si aplica)
|
|
- [ ] Si hay proyectos usando esta funcionalidad:
|
|
- [ ] Notificar cambio en CATALOG-USAGE-TRACKING.yml
|
|
- [ ] Marcar version nueva
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Seccion de catalogo actualizada
|
|
|
|
### Validacion
|
|
- [ ] Funcionalidad es accesible via @CATALOG
|
|
- [ ] Consumidores pueden encontrar nueva version
|
|
```
|
|
|
|
---
|
|
|
|
## FORMATO DE REGISTRO EN TRAZAS
|
|
|
|
### Entrada de Traza Local
|
|
|
|
```markdown
|
|
## [{fecha}] {codigo_tarea}: {descripcion_breve}
|
|
|
|
**Agente:** {nombre_agente}
|
|
**Tipo:** {CREAR|MODIFICAR|DOCUMENTAR}
|
|
**Prioridad:** {P0|P1|P2}
|
|
|
|
### Objetivo
|
|
{descripcion_de_lo_que_se_hizo}
|
|
|
|
### Archivos Afectados
|
|
- {ruta_archivo_1}
|
|
- {ruta_archivo_2}
|
|
|
|
### Impacto
|
|
- {impacto_1}
|
|
- {impacto_2}
|
|
|
|
### Propagado a
|
|
- [ ] Nivel superior: {si/no}
|
|
- [ ] Archivo: {ruta_si_aplica}
|
|
```
|
|
|
|
### Entrada de Traza de Suite
|
|
|
|
```markdown
|
|
## [{fecha}] {origen}: {descripcion}
|
|
|
|
**Nivel:** {2B.1|2B.2}
|
|
**Vertical/Core:** {nombre}
|
|
**Capa:** {DATABASE|BACKEND|FRONTEND}
|
|
|
|
### Propagacion
|
|
- **Origen:** {ruta_completa_archivo_original}
|
|
- **Tipo:** {Nuevo|Actualizado|Eliminado}
|
|
- **Impacto en suite:** {descripcion}
|
|
|
|
### Accion Requerida
|
|
- [ ] Ninguna (informativo)
|
|
- [ ] Verticales deben revisar herencia
|
|
- [ ] Actualizar dependencias
|
|
```
|
|
|
|
---
|
|
|
|
## ERRORES COMUNES
|
|
|
|
### Error 1: Inventario no actualizado
|
|
|
|
```yaml
|
|
Sintoma: Artefacto creado pero no aparece en busquedas
|
|
Causa: MASTER_INVENTORY.yml no incluye el nuevo artefacto
|
|
Solucion: Siempre actualizar inventario INMEDIATAMENTE despues de crear
|
|
```
|
|
|
|
### Error 2: Traza sin entrada
|
|
|
|
```yaml
|
|
Sintoma: No hay registro de cuando se creo algo
|
|
Causa: Olvidar registrar en TRAZA-TAREAS-*.md
|
|
Solucion: Agregar entrada antes de marcar tarea como Done
|
|
```
|
|
|
|
### Error 3: Propagacion parcial
|
|
|
|
```yaml
|
|
Sintoma: Nivel local OK pero nivel superior no sabe del cambio
|
|
Causa: Solo actualizar nivel local
|
|
Solucion: SIEMPRE propagar a TODOS los niveles en PROPAGATE_TO
|
|
```
|
|
|
|
### Error 4: Duplicacion de contenido
|
|
|
|
```yaml
|
|
Sintoma: Mismo contenido en multiples archivos
|
|
Causa: Copiar en lugar de referenciar
|
|
Solucion: Usar REFERENCIAS.yml con punteros, no copiar contenido
|
|
```
|
|
|
|
### Error 5: Fechas inconsistentes
|
|
|
|
```yaml
|
|
Sintoma: Archivo dice 2025-12-07 pero traza dice 2025-12-08
|
|
Causa: No sincronizar fechas
|
|
Solucion: Usar misma fecha en todos los archivos relacionados
|
|
```
|
|
|
|
---
|
|
|
|
## VALIDACION AUTOMATICA (Conceptual)
|
|
|
|
```bash
|
|
# Script futuro para validar propagacion
|
|
./validate-propagation.sh
|
|
|
|
Verifica:
|
|
✓ Inventarios tienen artefactos recientes
|
|
✓ Trazas tienen entradas de hoy
|
|
✓ Referencias apuntan a archivos existentes
|
|
✓ Fechas son consistentes
|
|
✓ No hay duplicacion de contenido
|
|
✓ Niveles superiores tienen referencias
|
|
|
|
Output:
|
|
PASS: Propagacion completa
|
|
FAIL: Lista de gaps encontrados
|
|
```
|
|
|
|
---
|
|
|
|
## QUICK REFERENCE
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
│ PROPAGACION OBLIGATORIA │
|
|
├─────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ DESPUES de crear/modificar artefacto: │
|
|
│ │
|
|
│ 1. NIVEL LOCAL: │
|
|
│ - [ ] Actualizar MASTER_INVENTORY.yml │
|
|
│ - [ ] Registrar en TRAZA-TAREAS-{CAPA}.md │
|
|
│ │
|
|
│ 2. NIVEL SUPERIOR (para cada nivel en PROPAGATE_TO): │
|
|
│ - [ ] Agregar referencia (NO copiar contenido) │
|
|
│ - [ ] Actualizar STATUS.yml │
|
|
│ - [ ] Registrar en traza superior │
|
|
│ │
|
|
│ 3. VALIDAR: │
|
|
│ - [ ] Rutas existen │
|
|
│ - [ ] Fechas consistentes │
|
|
│ - [ ] No hay duplicacion │
|
|
│ - [ ] Build pasa │
|
|
│ │
|
|
│ REGLA DE ORO: │
|
|
│ "Si no esta en inventario, no existe para otros agentes" │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## REFERENCIAS
|
|
|
|
- `SIMCO-PROPAGACION.md` - Protocolo completo de propagacion
|
|
- `SIMCO-NIVELES.md` - Definicion de niveles jerarquicos
|
|
- `SIMCO-DOCUMENTAR.md` - Directivas de documentacion
|
|
|
|
---
|
|
|
|
*Sistema SIMCO v2.2.0*
|
|
*Creado: 2025-12-08*
|