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>
221 lines
4.7 KiB
Markdown
221 lines
4.7 KiB
Markdown
---
|
|
version: "1.0.0"
|
|
fecha: "2026-01-07"
|
|
tipo: directiva
|
|
sistema: "SIMCO - NEXUS v4.0"
|
|
proposito: "Carga de Contexto Automatica optimizada para subagentes"
|
|
aplica_a: "Agentes operando como subagentes (reciben delegacion)"
|
|
---
|
|
|
|
# SIMCO: CCA PARA SUBAGENTES (Version Ligera)
|
|
|
|
## PRINCIPIO
|
|
|
|
> **CCA-SUBAGENTE = Contexto minimo + Tarea especifica**
|
|
>
|
|
> El subagente NO necesita cargar todo el contexto del proyecto.
|
|
> El contexto del proyecto YA viene heredado del orquestador.
|
|
|
|
---
|
|
|
|
## 1. COMPARATIVA CCA
|
|
|
|
| Aspecto | CCA Completo | CCA-SUBAGENTE |
|
|
|---------|--------------|---------------|
|
|
| Fases | 4 | 2 |
|
|
| Archivos | ~15 | ~3 |
|
|
| Tokens | ~10,000 | ~1,500 |
|
|
| Proposito | Agente principal | Subagente con contexto heredado |
|
|
|
|
---
|
|
|
|
## 2. PROTOCOLO CCA-SUBAGENTE (2 Fases)
|
|
|
|
### FASE 1: Cargar Perfil Compacto
|
|
|
|
```yaml
|
|
FASE_1_PERFIL_COMPACTO:
|
|
leer: "orchestration/agents/perfiles/compact/PERFIL-{TIPO}-COMPACT.md"
|
|
tokens: ~250
|
|
|
|
contiene:
|
|
- Identidad minima
|
|
- Responsabilidades clave (5-7 items)
|
|
- Stack tecnologico
|
|
- Validaciones obligatorias
|
|
- Alias relevantes
|
|
- Referencia a perfil completo
|
|
|
|
segun_tipo:
|
|
database: "PERFIL-DATABASE-COMPACT.md"
|
|
backend: "PERFIL-BACKEND-COMPACT.md"
|
|
frontend: "PERFIL-FRONTEND-COMPACT.md"
|
|
devops: "PERFIL-DEVOPS-COMPACT.md"
|
|
ml: "PERFIL-ML-COMPACT.md"
|
|
otro: "PERFIL-GENERIC-SUBAGENT.md"
|
|
```
|
|
|
|
### FASE 2: Cargar SIMCO Unico
|
|
|
|
```yaml
|
|
FASE_2_SIMCO_UNICO:
|
|
determinar_segun_operacion:
|
|
si_crear: "SIMCO-CREAR.md"
|
|
si_modificar: "SIMCO-MODIFICAR.md"
|
|
si_validar: "SIMCO-VALIDAR.md"
|
|
tokens: ~800
|
|
|
|
NO_cargar:
|
|
- SIMCO-TAREA.md (solo para orquestadores)
|
|
- SIMCO-DELEGACION.md (solo para orquestadores)
|
|
- SIMCO-CAPVED-PLUS.md (solo para orquestadores)
|
|
- SIMCO-DELEGACION-PARALELA.md (solo para orquestadores)
|
|
```
|
|
|
|
### RESULTADO
|
|
|
|
```yaml
|
|
RESULTADO:
|
|
mensaje: "CCA-SUBAGENTE completado"
|
|
tokens_totales: ~1,050
|
|
ready: true
|
|
```
|
|
|
|
---
|
|
|
|
## 3. LO QUE NO SE CARGA
|
|
|
|
### Contexto que VIENE HEREDADO (no cargar)
|
|
|
|
```yaml
|
|
HEREDADO_DEL_ORQUESTADOR:
|
|
- Variables de proyecto (DB_NAME, BACKEND_ROOT, etc.)
|
|
- Aliases resueltos (@DDL, @BACKEND, etc.)
|
|
- Estado actual (tablas, entities existentes)
|
|
- Documentacion de referencia especifica
|
|
- Criterios de aceptacion
|
|
- Codigo de referencia (file:line)
|
|
```
|
|
|
|
### Contexto que NO APLICA a subagentes
|
|
|
|
```yaml
|
|
NO_APLICA:
|
|
- 6 Principios completos (resumen incluido en perfil compact)
|
|
- CONTEXTO-PROYECTO.md (ya heredado)
|
|
- PROXIMA-ACCION.md (responsabilidad del orquestador)
|
|
- SIMCO-TAREA.md (para ciclo CAPVED completo)
|
|
- Multiples inventarios (solo extracto relevante)
|
|
- SESSION-TRACKING.yml (responsabilidad del orquestador)
|
|
```
|
|
|
|
---
|
|
|
|
## 4. CHECKLIST POST-CCA
|
|
|
|
```yaml
|
|
CHECKLIST_SUBAGENTE:
|
|
- [ ] Lei PERFIL-{TIPO}-COMPACT.md
|
|
- [ ] Lei SIMCO de operacion (CREAR/MODIFICAR/VALIDAR)
|
|
- [ ] Tengo contexto heredado del orquestador:
|
|
- Variables resueltas (sin placeholders)
|
|
- Aliases resueltos (rutas completas)
|
|
- [ ] Entiendo la tarea especifica:
|
|
- Que archivo(s) crear/modificar
|
|
- Criterios de aceptacion
|
|
- [ ] Tengo referencia de codigo (file:line)
|
|
|
|
READY_TO_EXECUTE: "Si todos los checks pasan"
|
|
```
|
|
|
|
---
|
|
|
|
## 5. SI FALTA ALGO
|
|
|
|
```yaml
|
|
SI_FALTA_CONTEXTO:
|
|
accion: "ESCALAR a orquestador"
|
|
|
|
formato:
|
|
tipo: "CONTEXTO_INCOMPLETO"
|
|
falta:
|
|
- "{especificar que falta}"
|
|
necesito:
|
|
- "{especificar que necesito}"
|
|
|
|
NO_hacer:
|
|
- NO asumir valores
|
|
- NO inventar rutas
|
|
- NO crear sin especificacion
|
|
```
|
|
|
|
---
|
|
|
|
## 6. DIAGRAMA DE FLUJO
|
|
|
|
```
|
|
SUBAGENTE RECIBE DELEGACION
|
|
|
|
|
v
|
|
+------------------+
|
|
| VERIFICAR |
|
|
| CONTEXTO |
|
|
| HEREDADO |
|
|
+------------------+
|
|
|
|
|
+---------+
|
|
| Completo?|
|
|
+---------+
|
|
| |
|
|
SI NO --> ESCALAR A ORQUESTADOR
|
|
|
|
|
v
|
|
+------------------+
|
|
| FASE 1: |
|
|
| PERFIL-COMPACT |
|
|
| (~250 tokens) |
|
|
+------------------+
|
|
|
|
|
v
|
|
+------------------+
|
|
| FASE 2: |
|
|
| SIMCO UNICO |
|
|
| (~800 tokens) |
|
|
+------------------+
|
|
|
|
|
v
|
|
+------------------+
|
|
| CHECKLIST |
|
|
| POST-CCA |
|
|
+------------------+
|
|
|
|
|
+---------+
|
|
| Pasa? |
|
|
+---------+
|
|
| |
|
|
SI NO --> ESCALAR A ORQUESTADOR
|
|
|
|
|
v
|
|
+------------------+
|
|
| READY_TO_EXECUTE |
|
|
| (~1,050 tokens) |
|
|
+------------------+
|
|
|
|
|
v
|
|
EJECUTAR TAREA
|
|
```
|
|
|
|
---
|
|
|
|
## 7. REFERENCIAS
|
|
|
|
| Documento | Proposito |
|
|
|-----------|-----------|
|
|
| `SIMCO-SUBAGENTE.md` | Protocolo completo de subagente |
|
|
| `agents/perfiles/compact/` | Perfiles compactos |
|
|
| `SIMCO-INICIALIZACION.md` | CCA completo (para agentes principales) |
|
|
|
|
---
|
|
|
|
**Version:** 1.0.0 | **Sistema:** SIMCO-NEXUS v4.0 | **Tipo:** Directiva CCA Ligero
|