workspace-v1/orchestration/directivas/simco/SIMCO-CCA-SUBAGENTE.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

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