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>
242 lines
5.6 KiB
Markdown
242 lines
5.6 KiB
Markdown
---
|
|
version: "1.0.0"
|
|
fecha: "2026-01-07"
|
|
tipo: directiva
|
|
sistema: "SIMCO - NEXUS v4.0"
|
|
proposito: "Protocolo optimizado para agentes operando como subagentes"
|
|
aplica_a: "Agentes que reciben delegacion de un orquestador"
|
|
---
|
|
|
|
# SIMCO: PROTOCOLO PARA SUBAGENTES
|
|
|
|
## PRINCIPIO FUNDAMENTAL
|
|
|
|
> **Subagente = Agente con contexto heredado + Tarea especifica + CCA ligero**
|
|
>
|
|
> Un subagente NO debe cargar el mismo contexto que ya tiene el orquestador.
|
|
> Un subagente DEBE usar versiones compactas de perfiles y directivas.
|
|
|
|
---
|
|
|
|
## 1. DIFERENCIA: AGENTE vs SUBAGENTE
|
|
|
|
| Aspecto | Agente Principal | Subagente |
|
|
|---------|------------------|-----------|
|
|
| Inicia sesion | Nueva | Delegada |
|
|
| Carga contexto | CCA completo (4 fases) | CCA-SUBAGENTE (2 fases) |
|
|
| Perfil | PERFIL-*.md (~800 tokens) | PERFIL-*-COMPACT.md (~250 tokens) |
|
|
| SIMCO cargados | 2-3 | 1 especifico |
|
|
| Contexto proyecto | Lee CONTEXTO-PROYECTO.md | Heredado del orquestador |
|
|
| Recovery | Ejecuta @TPL_RECOVERY_CTX | Escala a orquestador |
|
|
| Delega tareas | Si (si es orquestador) | NO |
|
|
| Tokens totales | ~10,000 | ~1,500 |
|
|
|
|
---
|
|
|
|
## 2. PROTOCOLO DE INICIALIZACION (CCA-SUBAGENTE)
|
|
|
|
```yaml
|
|
# Al recibir delegacion del orquestador
|
|
|
|
PASO_1_VERIFICAR_HERENCIA:
|
|
verificar_presente:
|
|
- variables_proyecto: "resueltas (sin placeholders)"
|
|
- aliases: "resueltos (rutas completas)"
|
|
- tarea: "especifica (1-2 archivos max)"
|
|
si_falta_algo: "ESCALAR a orquestador - NO asumir"
|
|
|
|
PASO_2_CARGAR_PERFIL_COMPACT:
|
|
leer: "orchestration/agents/perfiles/compact/PERFIL-{TIPO}-COMPACT.md"
|
|
tokens: ~250
|
|
|
|
PASO_3_CARGAR_SIMCO_ESPECIFICO:
|
|
segun_operacion:
|
|
crear: "SIMCO-CREAR.md"
|
|
modificar: "SIMCO-MODIFICAR.md"
|
|
validar: "SIMCO-VALIDAR.md"
|
|
tokens: ~800
|
|
|
|
PASO_4_CONFIRMAR:
|
|
responder: "READY_TO_EXECUTE como subagente"
|
|
tokens_totales: ~1,050
|
|
```
|
|
|
|
Ver detalles: `SIMCO-CCA-SUBAGENTE.md`
|
|
|
|
---
|
|
|
|
## 3. RESTRICCIONES DE SUBAGENTE
|
|
|
|
### NO HACER
|
|
|
|
```yaml
|
|
prohibido:
|
|
- NO cargar CCA completo (4 fases)
|
|
- NO leer CONTEXTO-PROYECTO.md (ya heredado)
|
|
- NO leer 6 principios completos (resumen en perfil compact)
|
|
- NO delegar a otros subagentes
|
|
- NO ejecutar recovery completo
|
|
- NO crear archivos fuera del alcance
|
|
- NO modificar codigo no relacionado
|
|
```
|
|
|
|
### SI HACER
|
|
|
|
```yaml
|
|
obligatorio:
|
|
- Usar contexto heredado del orquestador
|
|
- Cargar solo PERFIL-*-COMPACT.md
|
|
- Cargar solo 1 SIMCO especifico
|
|
- Ejecutar tarea delimitada (1-2 archivos)
|
|
- Reportar resultado en formato compacto
|
|
- Escalar si hay dudas o falta contexto
|
|
- Validar build/lint antes de reportar
|
|
```
|
|
|
|
---
|
|
|
|
## 4. CONTEXTO HEREDADO
|
|
|
|
### Lo que VIENE del Orquestador
|
|
|
|
```yaml
|
|
HEREDADO_OBLIGATORIO:
|
|
variables_proyecto:
|
|
- DB_NAME, DB_DDL_PATH
|
|
- BACKEND_ROOT, BACKEND_SRC
|
|
- FRONTEND_ROOT, FRONTEND_SRC
|
|
- Otras relevantes para la tarea
|
|
|
|
aliases_resueltos:
|
|
- @DDL, @BACKEND, @FRONTEND
|
|
- @INV_DB, @INV_BE, @INV_FE
|
|
|
|
estado_actual:
|
|
- tablas_existentes
|
|
- entities_existentes
|
|
- endpoints_existentes
|
|
|
|
tarea_especifica:
|
|
- Descripcion clara
|
|
- Archivos a crear/modificar
|
|
- Criterios de aceptacion
|
|
- Codigo de referencia (file:line)
|
|
```
|
|
|
|
### Lo que NO se Hereda
|
|
|
|
```yaml
|
|
NO_HEREDADO:
|
|
- Historial de conversacion del orquestador
|
|
- Documentacion completa del proyecto
|
|
- Codigo no relacionado con la tarea
|
|
- Inventarios completos (solo extracto relevante)
|
|
```
|
|
|
|
---
|
|
|
|
## 5. FORMATO DE REPORTE (COMPACTO)
|
|
|
|
Al completar la tarea, reportar en maximo 500 tokens:
|
|
|
|
```yaml
|
|
REPORTE_SUBAGENTE:
|
|
subtarea_id: "ST-XXX"
|
|
estado: "COMPLETADO | FALLIDO | BLOQUEADO"
|
|
|
|
archivos:
|
|
creados:
|
|
- "ruta/archivo1.ext"
|
|
modificados:
|
|
- "ruta/archivo2.ext"
|
|
|
|
validaciones:
|
|
build: "PASS | FAIL | SKIP"
|
|
lint: "PASS | FAIL | SKIP"
|
|
|
|
siguiente_paso: "Descripcion breve de que sigue"
|
|
|
|
# Solo si hay problemas
|
|
problemas:
|
|
- "Descripcion del problema 1"
|
|
```
|
|
|
|
---
|
|
|
|
## 6. RECOVERY DE SUBAGENTE
|
|
|
|
### Deteccion de Perdida de Contexto
|
|
|
|
```yaml
|
|
SENALES:
|
|
- "No recuerdo que tarea debo hacer"
|
|
- "No tengo variables resueltas"
|
|
- "No se que archivo crear"
|
|
- "No tengo codigo de referencia"
|
|
```
|
|
|
|
### Accion
|
|
|
|
```yaml
|
|
ACCION: "ESCALAR A ORQUESTADOR"
|
|
|
|
FORMATO_ESCALAMIENTO:
|
|
tipo: "RECOVERY_SUBAGENTE"
|
|
problema: "Perdi contexto de {especificar que}"
|
|
necesito: "Re-delegacion con contexto completo"
|
|
|
|
NO_HACER:
|
|
- NO intentar recovery completo
|
|
- NO asumir valores de variables
|
|
- NO crear archivos sin especificacion
|
|
```
|
|
|
|
---
|
|
|
|
## 7. INTEGRACION CON CAPVED
|
|
|
|
```yaml
|
|
SUBAGENTE_EN_CAPVED:
|
|
# Solo ejecuta la fase E
|
|
ejecuta:
|
|
- E (Ejecutar): "Unica fase del subagente"
|
|
|
|
# Las demas fases son del orquestador
|
|
no_ejecuta:
|
|
- C (Contexto): "Heredado del orquestador"
|
|
- A (Analisis): "Ya hecho por orquestador"
|
|
- P (Plan): "Ya definido por orquestador"
|
|
- V (Validar plan): "El orquestador valido"
|
|
- D (Documentar): "El orquestador documenta"
|
|
```
|
|
|
|
---
|
|
|
|
## 8. PERFILES COMPACTOS DISPONIBLES
|
|
|
|
| Perfil | Uso | Tokens |
|
|
|--------|-----|--------|
|
|
| PERFIL-BACKEND-COMPACT.md | Subagente Backend | ~250 |
|
|
| PERFIL-FRONTEND-COMPACT.md | Subagente Frontend | ~250 |
|
|
| PERFIL-DATABASE-COMPACT.md | Subagente Database | ~250 |
|
|
| PERFIL-DEVOPS-COMPACT.md | Subagente DevOps | ~250 |
|
|
| PERFIL-ML-COMPACT.md | Subagente ML | ~250 |
|
|
| PERFIL-GENERIC-SUBAGENT.md | Cualquier tarea | ~200 |
|
|
|
|
Ubicacion: `orchestration/agents/perfiles/compact/`
|
|
|
|
---
|
|
|
|
## 9. REFERENCIAS
|
|
|
|
| Documento | Proposito |
|
|
|-----------|-----------|
|
|
| `SIMCO-CCA-SUBAGENTE.md` | Protocolo CCA ligero |
|
|
| `agents/perfiles/compact/` | Perfiles compactos |
|
|
| `SIMCO-DELEGACION.md` | Como recibir delegacion |
|
|
| `CHECKLIST-PRE-DELEGACION.md` | Validacion del orquestador |
|
|
|
|
---
|
|
|
|
**Version:** 1.0.0 | **Sistema:** SIMCO-NEXUS v4.0 | **Tipo:** Directiva de Subagente
|