workspace-v1/orchestration/directivas/simco/SIMCO-CCA-SUBAGENTE.md

version	fecha	tipo	sistema	proposito	aplica_a
1.0.0	2026-01-07	directiva	SIMCO - NEXUS v4.0	Carga de Contexto Automatica optimizada para subagentes	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

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

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

RESULTADO:
  mensaje: "CCA-SUBAGENTE completado"
  tokens_totales: ~1,050
  ready: true

---

3. LO QUE NO SE CARGA

Contexto que VIENE HEREDADO (no cargar)

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

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

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

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)

---

FLUJO DE DOCUMENTACIÓN - CONTEXT ENGINEERING

Este documento forma parte del sistema de Context Engineering del workspace:

┌──────────────────────────────────────────────────────────────────┐
│                    CONTEXT ENGINEERING                           │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  1. SIMCO-CONTEXT-ENGINEERING.md                                 │
│     └─ TEORÍA: Niveles L0-L3, presupuesto tokens, recovery       │
│                                                                  │
│  2. SIMCO-CONTEXT-RESOLUTION.md                                  │
│     └─ AUTOMÁTICO: Resolución por keywords y mapeo tarea→archivo │
│                                                                  │
│  3. SIMCO-CCA-SUBAGENTE.md (ESTE ARCHIVO)                        │
│     └─ LIGERO: CCA reducido para subagentes (2 fases, ~1050 tok) │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

Cuándo usar cada uno:

• CONTEXT-ENGINEERING → Para entender teoría de contexto, métricas, anti-patrones
• CONTEXT-RESOLUTION → Para automatizar qué archivos cargar según la tarea
• Este archivo → Para subagentes delegados (contexto heredado)

---

Version: 1.0.1 | Sistema: SIMCO-NEXUS v4.0 | Tipo: Directiva CCA Ligero Actualizado: 2026-01-10