e56e927a4d
Cambios incluidos: - INDICE-DIRECTIVAS-WORKSPACE.yml actualizado - Perfiles de agentes: PERFIL-ML.md, PERFIL-SECURITY.md - Directivas SIMCO actualizadas: - SIMCO-ASIGNACION-PERFILES.md - SIMCO-CCA-SUBAGENTE.md - SIMCO-CONTEXT-ENGINEERING.md - SIMCO-CONTEXT-RESOLUTION.md - SIMCO-DELEGACION-PARALELA.md - Inventarios actualizados: DEVENV-MASTER, DEVENV-PORTS - Documentos de analisis agregados: - Analisis y planes de fix student portal - Analisis scripts BD - Analisis achievements, duplicados, gamification - Auditoria documentacion gamilit - Backlog discrepancias NEXUS - Planes maestros de resolucion - Reportes de ejecucion agregados - Knowledge base gamilit README actualizado - Referencia submodulo gamilit actualizada (commit beb94f7) Validaciones: - Plan validado contra directivas SIMCO-GIT - Dependencias verificadas - Build gamilit: EXITOSO
250 lines
6.5 KiB
Markdown
250 lines
6.5 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) |
|
|
|
|
---
|
|
|
|
## 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
|