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>
429 lines
15 KiB
Markdown
429 lines
15 KiB
Markdown
# SIMCO: CAPVED++ (Ciclo Extendido con Validaciones)
|
|
|
|
**Versión:** 1.0.0
|
|
**Sistema:** SIMCO - NEXUS v4.0
|
|
**Propósito:** Extensión del ciclo CAPVED con gates de validación obligatorios
|
|
**Fecha:** 2026-01-04
|
|
|
|
---
|
|
|
|
## PRINCIPIO FUNDAMENTAL
|
|
|
|
> **CAPVED++ extiende el ciclo CAPVED con:**
|
|
> 1. **FASE 0**: Resolución automática de contexto (pre-ciclo)
|
|
> 2. **Gates de validación**: Checkpoints obligatorios entre fases
|
|
> 3. **Templates de salida**: Formato estándar por fase
|
|
> 4. **Validación post-ejecución**: Comparación plan vs real
|
|
> **Resultado:** Ejecución rigurosa con trazabilidad completa.
|
|
|
|
---
|
|
|
|
## DIAGRAMA DEL CICLO CAPVED++
|
|
|
|
```
|
|
TAREA RECIBIDA
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE 0: RESOLUCIÓN DE CONTEXTO (Pre-ciclo automático) │
|
|
│ - Analizar keywords de tarea │
|
|
│ - Cargar CONTEXT-MAP.yml del proyecto │
|
|
│ - Resolver archivos por nivel (L0→L3) │
|
|
│ - Verificar límite de tokens (<18000) │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-0: Contexto verificado, tokens dentro de límite
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE C: CONTEXTO (~5 min) │
|
|
│ - Identificar HU/épica vinculada │
|
|
│ - Clasificar tipo de tarea │
|
|
│ - Verificar catálogo anti-duplicación │
|
|
│ - Buscar tareas similares previas │
|
|
│ - Buscar errores previos en REGISTRO-ERRORES.yml │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-C: HU vinculada, tipo clasificado, catálogo verificado
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE A: ANÁLISIS (~15 min) │
|
|
│ - Mapear todos los objetos afectados │
|
|
│ - Identificar dependencias │
|
|
│ - Documentar riesgos │
|
|
│ - Verificar si es error repetido → Análisis profundo │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-A: Objetos mapeados, dependencias identificadas, riesgos documentados
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE P: PLANEACIÓN (~10 min) │
|
|
│ - Definir subtareas (máx 2 archivos c/u) │
|
|
│ - Asignar agentes por subtarea │
|
|
│ - Establecer orden de ejecución │
|
|
│ - Calcular tokens por subtarea │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-P: Subtareas definidas, agentes asignados, tokens verificados
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE V: VALIDACIÓN DE PLAN (~5 min) ⚠️ NO DELEGAR │
|
|
│ - Verificar cobertura A→P 100% │
|
|
│ - Validar dependencias resueltas │
|
|
│ - Capturar scope creep potencial │
|
|
│ - Confirmar viabilidad técnica │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-V: Plan aprobado, cobertura completa
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE E: EJECUCIÓN (variable) │
|
|
│ - Ejecutar subtareas según orden │
|
|
│ - Validar cada subtarea: build ✓, lint ✓, criterios ✓ │
|
|
│ - Tracking en SESSION-TRACKING.yml │
|
|
│ - Documentar cambios en tiempo real │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-E: Todas las subtareas completadas, validaciones pasadas
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ FASE D: DOCUMENTACIÓN (~10 min) │
|
|
│ - Actualizar inventarios afectados │
|
|
│ - Registrar en trazas por dominio │
|
|
│ - Ejecutar propagación si aplica │
|
|
│ - Generar HUs derivadas si scope creep │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼ GATE-D: Inventarios actualizados, trazas registradas
|
|
│
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ POST: VALIDACIÓN POST-EJECUCIÓN │
|
|
│ - Comparar plan vs real │
|
|
│ - Verificar consistencia entre capas │
|
|
│ - Registrar lecciones aprendidas │
|
|
│ - Actualizar PROXIMA-ACCION.md │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
TAREA COMPLETADA
|
|
```
|
|
|
|
---
|
|
|
|
## DETALLE DE GATES (Checkpoints Obligatorios)
|
|
|
|
### GATE-0: Pre-Contexto
|
|
|
|
```yaml
|
|
GATE_0:
|
|
nombre: "Verificación de Contexto Resuelto"
|
|
obligatorio: true
|
|
checklist:
|
|
- [ ] CONTEXT-MAP.yml del proyecto cargado
|
|
- [ ] Variables resueltas (sin placeholders)
|
|
- [ ] Archivos L0-L2 verificados que existen
|
|
- [ ] Tokens estimados < 18000
|
|
- [ ] Estado: READY_TO_EXECUTE
|
|
|
|
si_falla:
|
|
- Reducir contexto L3
|
|
- Desglosar tarea si excede límite
|
|
- Notificar si CONTEXT-MAP no existe
|
|
```
|
|
|
|
### GATE-C: Post-Contexto
|
|
|
|
```yaml
|
|
GATE_C:
|
|
nombre: "Verificación de Entendimiento"
|
|
obligatorio: true
|
|
checklist:
|
|
- [ ] HU/Épica identificada (ID asignado)
|
|
- [ ] Tipo clasificado: {CREAR | MODIFICAR | VALIDAR | REFACTORIZAR}
|
|
- [ ] Dominio identificado: {DDL | BACKEND | FRONTEND | MIXTO}
|
|
- [ ] Catálogo verificado (no duplicación)
|
|
- [ ] Historial buscado (tareas similares, errores previos)
|
|
|
|
si_falla:
|
|
- Solicitar HU si falta
|
|
- Crear HU derivada si es tarea nueva
|
|
- Preguntar al PO si hay ambigüedad
|
|
```
|
|
|
|
### GATE-A: Post-Análisis
|
|
|
|
```yaml
|
|
GATE_A:
|
|
nombre: "Verificación de Análisis Completo"
|
|
obligatorio: true
|
|
checklist:
|
|
- [ ] Todos los objetos afectados listados
|
|
- [ ] Dependencias mapeadas (hacia arriba y hacia abajo)
|
|
- [ ] Riesgos documentados con mitigación
|
|
- [ ] Si error repetido: causa raíz identificada
|
|
- [ ] Archivos de referencia identificados
|
|
|
|
si_falla:
|
|
- Completar mapeo antes de continuar
|
|
- Escalar al PO si riesgos son altos
|
|
- Análisis profundo si es error recurrente
|
|
```
|
|
|
|
### GATE-P: Post-Planeación
|
|
|
|
```yaml
|
|
GATE_P:
|
|
nombre: "Verificación de Plan Ejecutable"
|
|
obligatorio: true
|
|
checklist:
|
|
- [ ] Subtareas definidas (máx 2 archivos c/u)
|
|
- [ ] Cada subtarea tiene agente asignado
|
|
- [ ] Orden de ejecución establecido (dependencias)
|
|
- [ ] Tokens por subtarea < 3000
|
|
- [ ] Criterios de aceptación por subtarea
|
|
|
|
si_falla:
|
|
- Desglosar subtareas que excedan límites
|
|
- Reordenar si hay dependencias circulares
|
|
- Simplificar plan si es muy complejo
|
|
```
|
|
|
|
### GATE-V: Post-Validación de Plan
|
|
|
|
```yaml
|
|
GATE_V:
|
|
nombre: "Aprobación de Plan"
|
|
obligatorio: true
|
|
ejecutor: "SOLO agente principal (NO delegar)"
|
|
checklist:
|
|
- [ ] Cobertura A→P: 100% de objetos cubiertos
|
|
- [ ] Sin dependencias huérfanas
|
|
- [ ] Scope creep capturado como HU derivada
|
|
- [ ] Viabilidad técnica confirmada
|
|
- [ ] Plan aprobado (explícitamente)
|
|
|
|
si_falla:
|
|
- Ajustar plan hasta que cubra 100%
|
|
- Generar HUs derivadas para scope creep
|
|
- Escalar si viabilidad es cuestionable
|
|
```
|
|
|
|
### GATE-E: Post-Ejecución (por subtarea)
|
|
|
|
```yaml
|
|
GATE_E:
|
|
nombre: "Validación de Subtarea"
|
|
obligatorio: true
|
|
por_cada_subtarea: true
|
|
checklist:
|
|
- [ ] Código/DDL creado/modificado
|
|
- [ ] Build pasa sin errores
|
|
- [ ] Lint pasa sin warnings críticos
|
|
- [ ] Criterios de aceptación cumplidos
|
|
- [ ] Archivos registrados en SESSION-TRACKING
|
|
|
|
si_falla:
|
|
- Corregir antes de continuar
|
|
- NO proceder a siguiente subtarea
|
|
- Documentar problema si bloquea
|
|
```
|
|
|
|
### GATE-D: Post-Documentación
|
|
|
|
```yaml
|
|
GATE_D:
|
|
nombre: "Verificación de Documentación"
|
|
obligatorio: true
|
|
checklist:
|
|
- [ ] Inventarios actualizados (DATABASE, BACKEND, FRONTEND)
|
|
- [ ] Trazas registradas con ID de tarea
|
|
- [ ] Propagación evaluada y ejecutada si aplica
|
|
- [ ] HUs derivadas creadas si scope creep
|
|
- [ ] PROXIMA-ACCION.md actualizado
|
|
|
|
si_falla:
|
|
- Completar documentación antes de cerrar
|
|
- NO marcar tarea como completada
|
|
```
|
|
|
|
---
|
|
|
|
## TEMPLATES DE SALIDA POR FASE
|
|
|
|
Cada fase produce un output estandarizado:
|
|
|
|
| Fase | Template | Propósito |
|
|
|------|----------|-----------|
|
|
| C | `TEMPLATE-FASE-C-OUTPUT.yml` | Registro de entendimiento |
|
|
| A | `TEMPLATE-FASE-A-OUTPUT.yml` | Registro de análisis |
|
|
| P | `TEMPLATE-FASE-P-OUTPUT.yml` | Plan de ejecución |
|
|
| V | `TEMPLATE-FASE-V-OUTPUT.yml` | Aprobación de plan |
|
|
| E | `TEMPLATE-FASE-E-OUTPUT.yml` | Registro de ejecución |
|
|
| D | `TEMPLATE-FASE-D-OUTPUT.yml` | Documentación final |
|
|
| POST | `TEMPLATE-POST-VALIDACION.yml` | Validación post-ejecución |
|
|
|
|
**Ubicación:** `orchestration/templates/capved/`
|
|
|
|
---
|
|
|
|
## BÚSQUEDA DE HISTORIAL (Nuevo en CAPVED++)
|
|
|
|
### En Fase C: Buscar Tareas Similares
|
|
|
|
```yaml
|
|
BUSQUEDA_HISTORICO:
|
|
antes_de_analizar:
|
|
ubicaciones:
|
|
- "{proyecto}/orchestration/trazas/"
|
|
- "shared/knowledge-base/lessons-learned/"
|
|
- "orchestration/errores/REGISTRO-ERRORES.yml"
|
|
|
|
keywords: "{extraer de descripción de tarea}"
|
|
|
|
si_encuentra_similar:
|
|
- Analizar solución previa
|
|
- Verificar si aplica o requiere adaptación
|
|
- Agregar referencia a contexto L3
|
|
|
|
si_encuentra_error_previo:
|
|
- Marcar tarea como "REQUIERE_ANALISIS_PROFUNDO"
|
|
- Cargar historial completo del error
|
|
- Ejecutar protocolo SIMCO-ERROR-RECURRENTE.md
|
|
```
|
|
|
|
### En Fase A: Análisis Profundo de Errores
|
|
|
|
```yaml
|
|
SI_ERROR_REPETIDO:
|
|
1_analisis_causa_raiz:
|
|
- Identificar TODOS los objetos afectados
|
|
- Mapear dependencias completas
|
|
- Identificar por qué falló la solución anterior
|
|
|
|
2_solucion_definitiva:
|
|
- NO solo parchar el síntoma
|
|
- Actualizar TODAS las dependencias
|
|
- Actualizar documentación/definiciones
|
|
- Propagar cambios a proyectos afectados
|
|
|
|
3_prevencion:
|
|
- Agregar validación automática si posible
|
|
- Documentar en KB como antipatrón
|
|
- Actualizar ANTIPATRONES.md si aplica
|
|
|
|
4_registro:
|
|
- Actualizar REGISTRO-ERRORES.yml con solución definitiva
|
|
- Marcar ocurrencias previas como resueltas
|
|
```
|
|
|
|
---
|
|
|
|
## INTEGRACIÓN CON SIMCO EXISTENTES
|
|
|
|
CAPVED++ se integra con:
|
|
|
|
| SIMCO | Integración |
|
|
|-------|-------------|
|
|
| `SIMCO-CONTEXT-RESOLUTION.md` | Ejecuta FASE 0 automáticamente |
|
|
| `SIMCO-CONTROL-TOKENS.md` | Valida límites en GATE-0 y GATE-P |
|
|
| `SIMCO-DELEGACION.md` | Define formato de delegación en FASE E |
|
|
| `SIMCO-TAREA.md` | Referencia base del ciclo CAPVED |
|
|
| `SIMCO-ERROR-RECURRENTE.md` | Protocolo para errores repetidos |
|
|
|
|
---
|
|
|
|
## RESPONSABILIDADES
|
|
|
|
```yaml
|
|
AGENTE_PRINCIPAL:
|
|
ejecuta:
|
|
- FASE 0 (automático)
|
|
- FASE C
|
|
- FASE A
|
|
- FASE P
|
|
- FASE V (NO DELEGAR)
|
|
- FASE D
|
|
- POST
|
|
delega:
|
|
- Subtareas de FASE E (a subagentes)
|
|
|
|
SUBAGENTES:
|
|
ejecutan:
|
|
- Subtareas específicas de FASE E
|
|
- Validaciones de GATE-E por subtarea
|
|
reportan:
|
|
- A SESSION-TRACKING.yml
|
|
- Al agente principal
|
|
```
|
|
|
|
---
|
|
|
|
## CASOS ESPECIALES
|
|
|
|
### Tarea Simple (<3 archivos)
|
|
|
|
```yaml
|
|
SI_TAREA_SIMPLE:
|
|
- Ejecutar CAPVED++ completo pero condensado
|
|
- Fases C+A pueden combinarse
|
|
- No requiere delegación
|
|
- Documentación mínima pero completa
|
|
```
|
|
|
|
### Tarea Compleja (>5 archivos o multi-dominio)
|
|
|
|
```yaml
|
|
SI_TAREA_COMPLEJA:
|
|
- Desglosar en subtareas obligatorio
|
|
- Máximo 5 subtareas en paralelo
|
|
- Validación de dependencias estricta
|
|
- SESSION-TRACKING obligatorio
|
|
```
|
|
|
|
### Error Repetido (encontrado en historial)
|
|
|
|
```yaml
|
|
SI_ERROR_REPETIDO:
|
|
- GATE-C requiere: análisis profundo marcado
|
|
- FASE A extendida: causa raíz obligatoria
|
|
- Solución debe ser definitiva
|
|
- Propagación obligatoria si afecta otros proyectos
|
|
```
|
|
|
|
---
|
|
|
|
## MÉTRICAS DE ÉXITO
|
|
|
|
```yaml
|
|
METRICAS:
|
|
completitud:
|
|
- Gates pasados: 100%
|
|
- Cobertura A→P: 100%
|
|
- Documentación: Completa
|
|
|
|
calidad:
|
|
- Build: Pasa
|
|
- Lint: Sin warnings críticos
|
|
- Tests: Cubren cambios
|
|
|
|
proceso:
|
|
- Plan vs Real: <10% desviación
|
|
- Scope creep: Capturado en HUs
|
|
- Errores repetidos: 0 (objetivo)
|
|
```
|
|
|
|
---
|
|
|
|
## REFERENCIAS
|
|
|
|
| Documento | Propósito |
|
|
|-----------|-----------|
|
|
| `PRINCIPIO-CAPVED.md` | Ciclo base |
|
|
| `SIMCO-CONTEXT-RESOLUTION.md` | FASE 0 detalle |
|
|
| `SIMCO-CONTROL-TOKENS.md` | Límites de tokens |
|
|
| `SIMCO-ERROR-RECURRENTE.md` | Protocolo errores |
|
|
| `templates/capved/*.yml` | Templates de fases |
|
|
|
|
---
|
|
|
|
**Versión:** 1.0.0 | **Sistema:** SIMCO-NEXUS v4.0 | **Tipo:** Directiva de Ciclo Extendido
|