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>
9.3 KiB
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:
- CONSULTAR el mapa de perfiles:
orchestration/agents/perfiles/_MAP.md- IDENTIFICAR el perfil adecuado usando el mapeo de palabras clave
- VERIFICAR que la tarea coincide con
tipos_tareadel perfil- CONFIRMAR que no aplica ninguna condicion de
no_asignar_si- 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.mdpara 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:
- Descomponer en subtareas mas especificas
- Asignar cada subtarea al perfil correspondiente
- Si sigue ambigua, escalar a @PERFIL_TECH_LEADER
Tarea Multi-Perfil
Si la tarea requiere multiples perfiles:
- Delegar a @PERFIL_ORQUESTADOR
- El orquestador descompondra y coordinara
Perfil No Existe
Si no existe perfil para la tarea:
- Documentar la necesidad
- Escalar a @PERFIL_ARCHITECT para evaluar creacion
- 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