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

9.3 KiB

SIMCO: DIRECTIVA DE ASIGNACION DE PERFILES

Version: 1.0.0 Fecha: 2026-01-04 Sistema: NEXUS v3.4 + SIMCO Aplica a: Todos los agentes que deleguen tareas


PROPOSITO

Esta directiva establece el procedimiento obligatorio para asignar tareas a perfiles especializados, garantizando que cada tarea sea ejecutada por el agente mas adecuado.


DIRECTIVA OBLIGATORIA

ANTES de delegar cualquier tarea a un subagente, el agente DEBE:

  1. CONSULTAR el mapa de perfiles: orchestration/agents/perfiles/_MAP.md
  2. IDENTIFICAR el perfil adecuado usando el mapeo de palabras clave
  3. VERIFICAR que la tarea coincide con tipos_tarea del perfil
  4. CONFIRMAR que no aplica ninguna condicion de no_asignar_si
  5. INCLUIR el alias del perfil y las directivas aplicables en la delegacion

FLUJO DE DECISION

┌─────────────────────────────────────────────────────────────────┐
│                    RECIBIR TAREA A DELEGAR                      │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  PASO 1: Leer _MAP.md                                           │
│  Ubicacion: orchestration/agents/perfiles/_MAP.md               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  PASO 2: Buscar palabras clave de la tarea                      │
│  Ejemplo: "crear endpoint" → buscar "endpoint" en mapeo         │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  PASO 3: Identificar perfil candidato                           │
│  Resultado: @PERFIL_BACKEND                                     │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  PASO 4: Verificar tipos_tarea del perfil                       │
│  ¿"Crear endpoint REST" esta en la lista? → SI                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  PASO 5: Verificar no_asignar_si                                │
│  ¿Proyecto usa Express? → NO (usa NestJS) → OK                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  PASO 6: Preparar delegacion con:                               │
│  - Alias del perfil (@PERFIL_BACKEND)                           │
│  - Directivas aplicables (@OP_BACKEND, @PAT_VALIDACION)         │
│  - Contexto minimo requerido                                    │
│  - Criterios de aceptacion                                      │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                       EJECUTAR DELEGACION                       │
└─────────────────────────────────────────────────────────────────┘

MAPEO RAPIDO DE REFERENCIA

Palabras Clave → Perfil

Palabra Clave Perfil Alias
tabla, DDL, migracion, schema Database @PERFIL_DATABASE
endpoint, API, controller, NestJS Backend @PERFIL_BACKEND
Express, middleware, router Backend-Express @PERFIL_BACKEND_EXPRESS
componente, React, Vue, UI Frontend @PERFIL_FRONTEND
modelo ML, prediccion, features ML-Specialist @PERFIL_ML_SPEC
Docker, nginx, deploy simple DevOps @PERFIL_DEVOPS
pipeline, Jenkins, GitHub Actions CICD-Specialist @PERFIL_CICD_SPECIALIST
produccion, rollback, deploy prod Production-Manager @PERFIL_PRODUCTION_MANAGER
secretos, credenciales, .env Secrets-Manager @PERFIL_SECRETS_MANAGER
Prometheus, Grafana, alertas Monitoring-Agent @PERFIL_MONITORING_AGENT
puertos, entorno local DevEnv @PERFIL_DEVENV
test, cobertura, e2e Testing @PERFIL_TESTING
propagar, KB, catalogo KB-Manager @PERFIL_KB_MANAGER

Referencia completa: Ver _MAP.md para lista exhaustiva


TEMPLATE DE DELEGACION

## Delegacion a {ALIAS_PERFIL}

**Tarea:** {descripcion clara y especifica}

**Proyecto:** {nombre_proyecto}
**Ubicacion:** {ruta del working directory}

**Archivos de contexto:**
- {archivo_1}
- {archivo_2}

**Directivas aplicables:**
- {directiva_1}
- {directiva_2}

**Criterios de aceptacion:**
- [ ] {criterio_1}
- [ ] {criterio_2}
- [ ] {criterio_3}

**Notas adicionales:**
{informacion relevante para el subagente}

ERRORES COMUNES A EVITAR

1. Asignar sin verificar el mapa

incorrecto: "Delegar tarea de endpoint a cualquier agente disponible"
correcto: "Consultar _MAP.md, identificar @PERFIL_BACKEND"

2. Ignorar condiciones no_asignar_si

incorrecto: "Asignar tarea de Express a @PERFIL_BACKEND"
correcto: "Verificar que proyecto usa NestJS, si usa Express → @PERFIL_BACKEND_EXPRESS"

3. No incluir directivas en delegacion

incorrecto: "Crea un endpoint de usuarios"
correcto: "Crea un endpoint de usuarios siguiendo @OP_BACKEND y @PAT_VALIDACION"

4. Delegar tarea multi-capa a perfil de una sola capa

incorrecto: "Implementar feature completa (DB + API + UI) → @PERFIL_BACKEND"
correcto: "Tarea multi-capa → @PERFIL_ORQUESTADOR para descomponer y delegar"

CASOS ESPECIALES

Tarea Ambigua

Si la tarea no coincide claramente con un perfil:

  1. Descomponer en subtareas mas especificas
  2. Asignar cada subtarea al perfil correspondiente
  3. Si sigue ambigua, escalar a @PERFIL_TECH_LEADER

Tarea Multi-Perfil

Si la tarea requiere multiples perfiles:

  1. Delegar a @PERFIL_ORQUESTADOR
  2. El orquestador descompondra y coordinara

Perfil No Existe

Si no existe perfil para la tarea:

  1. Documentar la necesidad
  2. Escalar a @PERFIL_ARCHITECT para evaluar creacion
  3. Temporalmente, usar perfil mas cercano

VALIDACION POST-ASIGNACION

Despues de delegar, verificar:

checklist_delegacion:
  - "[ ] Perfil asignado existe en _MAP.md"
  - "[ ] Tarea coincide con tipos_tarea del perfil"
  - "[ ] No aplica ninguna condicion no_asignar_si"
  - "[ ] Directivas incluidas en delegacion"
  - "[ ] Contexto minimo proporcionado"
  - "[ ] Criterios de aceptacion claros"

REFERENCIAS

  • Mapa de perfiles: orchestration/agents/perfiles/_MAP.md
  • Aliases: orchestration/referencias/ALIASES.yml
  • Directiva de delegacion: orchestration/directivas/simco/SIMCO-DELEGACION.md
  • Template de delegacion: orchestration/templates/TEMPLATE-DELEGACION-SUBAGENTE.md

Version: 1.0.0 | Sistema: NEXUS v3.4 + SIMCO | Tipo: Directiva SIMCO