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>
798 lines
20 KiB
Markdown
798 lines
20 KiB
Markdown
# INDICE Y GUIA DE ASIGNACION DE PERFILES DE AGENTES
|
|
|
|
**Version:** 2.0.0
|
|
**Fecha:** 2026-01-04
|
|
**Sistema:** NEXUS v3.4 + SIMCO
|
|
**Proposito:** Guia para asignacion correcta de tareas a perfiles especializados
|
|
|
|
---
|
|
|
|
## DIRECTIVA DE USO
|
|
|
|
> **OBLIGATORIO PARA AGENTES ORQUESTADORES**
|
|
>
|
|
> Antes de delegar una tarea a un subagente, el agente orquestador DEBE:
|
|
> 1. Consultar este mapa para identificar el perfil mas adecuado
|
|
> 2. Verificar que la tarea coincide con el dominio del perfil
|
|
> 3. Incluir el alias del perfil en la delegacion
|
|
> 4. Proporcionar contexto minimo requerido por el perfil
|
|
|
|
---
|
|
|
|
## MAPEO RAPIDO: TAREA → PERFIL
|
|
|
|
### Por Palabra Clave en la Tarea
|
|
|
|
| Si la tarea menciona... | Asignar a | Alias |
|
|
|-------------------------|-----------|-------|
|
|
| "crear tabla", "DDL", "migracion", "schema", "indice", "constraint" | Database | @PERFIL_DATABASE |
|
|
| "endpoint", "API", "controller", "service", "NestJS", "DTO" | Backend | @PERFIL_BACKEND |
|
|
| "Express", "middleware", "router" | Backend-Express | @PERFIL_BACKEND_EXPRESS |
|
|
| "componente", "React", "Vue", "CSS", "UI", "formulario", "pagina" | Frontend | @PERFIL_FRONTEND |
|
|
| "mobile", "app", "iOS", "Android", "React Native", "Flutter" | Mobile | @PERFIL_MOBILE |
|
|
| "modelo ML", "prediccion", "entrenamiento", "features", "dataset" | ML-Specialist | @PERFIL_ML_SPEC |
|
|
| "LLM", "ChatGPT", "Claude", "prompt", "embeddings", "RAG" | LLM-Agent | @PERFIL_LLM |
|
|
| "Docker", "CI/CD basico", "deploy simple", "nginx" | DevOps | @PERFIL_DEVOPS |
|
|
| "pipeline avanzado", "Jenkins", "GitHub Actions", "quality gates" | CICD-Specialist | @PERFIL_CICD_SPECIALIST |
|
|
| "produccion", "rollback", "ambiente prod", "deploy produccion" | Production-Manager | @PERFIL_PRODUCTION_MANAGER |
|
|
| "secretos", "credenciales", ".env", "API keys", "rotacion" | Secrets-Manager | @PERFIL_SECRETS_MANAGER |
|
|
| "Prometheus", "Grafana", "alertas", "metricas", "monitoreo" | Monitoring-Agent | @PERFIL_MONITORING_AGENT |
|
|
| "puertos", "entorno local", "conflictos de puertos" | DevEnv | @PERFIL_DEVENV |
|
|
| "test", "jest", "pytest", "cobertura", "e2e", "integracion" | Testing | @PERFIL_TESTING |
|
|
| "code review", "PR review", "revision de codigo" | Code-Reviewer | @PERFIL_REVIEWER |
|
|
| "bug", "fix", "corregir error", "debug" | Bug-Fixer | @PERFIL_BUGFIX |
|
|
| "seguridad", "vulnerabilidad", "OWASP", "auditoria seguridad" | Security-Auditor | @PERFIL_SEC_AUDITOR |
|
|
| "RLS", "policies", "auditoria BD" | Database-Auditor | @PERFIL_DB_AUDITOR |
|
|
| "documentar", "README", "JSDoc", "comentarios" | Documentation | @PERFIL_DOCS |
|
|
| "propagar", "sincronizar", "KB", "knowledge base", "catalogo" | KB-Manager | @PERFIL_KB_MANAGER |
|
|
| "tracking propagacion", "estado propagacion", "SLA" | Propagation-Tracker | @PERFIL_PROPAGATION_TRACKER |
|
|
| "arquitectura", "patron", "decision tecnica", "trade-off" | Architecture-Analyst | @PERFIL_ARCHITECT |
|
|
| "coordinar", "delegar", "multiples agentes" | Orquestador | @PERFIL_ORQUESTADOR |
|
|
| "requerimientos", "historia usuario", "criterios aceptacion" | Requirements-Analyst | @PERFIL_REQUIREMENTS |
|
|
| "XP", "logros", "gamificacion", "recompensas", "rangos" | Gamification-Specialist | (proyecto gamilit) |
|
|
| "trading ML", "backtesting", "estrategia trading" | Trading-ML-Specialist | (proyecto trading) |
|
|
|
|
---
|
|
|
|
## CATALOGO DE PERFILES
|
|
|
|
### 1. COORDINACION Y LIDERAZGO
|
|
|
|
#### PERFIL-ORQUESTADOR
|
|
```yaml
|
|
alias: "@PERFIL_ORQUESTADOR"
|
|
archivo: "PERFIL-ORQUESTADOR.md"
|
|
dominio: "Coordinacion general de tareas y agentes"
|
|
|
|
descripcion_breve: |
|
|
Agente maestro que recibe tareas complejas, las descompone en subtareas
|
|
y las delega a agentes especializados. Mantiene vision global del proyecto.
|
|
|
|
tipos_tarea:
|
|
- "Implementar feature completa (multi-capa)"
|
|
- "Coordinar refactorizacion grande"
|
|
- "Gestionar sprint/milestone"
|
|
- "Resolver tarea que requiere multiples especialidades"
|
|
|
|
directivas:
|
|
- "@SIMCO/SIMCO-DELEGACION.md"
|
|
- "@SIMCO/SIMCO-TAREA.md"
|
|
- "@TPL_DELEGACION"
|
|
|
|
no_asignar_si:
|
|
- "Tarea es especifica de una sola capa (DB, Backend, Frontend)"
|
|
- "Tarea es simple y no requiere coordinacion"
|
|
```
|
|
|
|
#### PERFIL-TECH-LEADER
|
|
```yaml
|
|
alias: "@PERFIL_TECH_LEADER"
|
|
archivo: "PERFIL-TECH-LEADER.md"
|
|
dominio: "Decisiones tecnicas y escalaciones"
|
|
|
|
descripcion_breve: |
|
|
Toma decisiones tecnicas criticas, resuelve conflictos entre enfoques,
|
|
aprueba cambios arquitecturales. Punto de escalacion para bloqueos.
|
|
|
|
tipos_tarea:
|
|
- "Decidir entre tecnologias/librerias"
|
|
- "Aprobar cambio breaking"
|
|
- "Resolver conflicto tecnico"
|
|
- "Escalar bloqueo critico"
|
|
|
|
directivas:
|
|
- "@SIMCO/SIMCO-ESCALAMIENTO.md"
|
|
- "@PRINCIPIOS/PRINCIPIO-CAPVED.md"
|
|
|
|
no_asignar_si:
|
|
- "Tarea es implementacion directa"
|
|
- "No hay decision tecnica que tomar"
|
|
```
|
|
|
|
#### PERFIL-ARCHITECTURE-ANALYST
|
|
```yaml
|
|
alias: "@PERFIL_ARCHITECT"
|
|
archivo: "PERFIL-ARCHITECTURE-ANALYST.md"
|
|
dominio: "Analisis arquitectonico y patrones"
|
|
|
|
descripcion_breve: |
|
|
Analiza y diseña arquitectura de sistemas. Identifica patrones,
|
|
evalua trade-offs, propone estructuras escalables.
|
|
|
|
tipos_tarea:
|
|
- "Diseñar arquitectura de nuevo modulo"
|
|
- "Evaluar patron a implementar"
|
|
- "Analizar impacto de cambio estructural"
|
|
- "Documentar decisiones arquitectonicas (ADR)"
|
|
|
|
directivas:
|
|
- "@SIMCO/SIMCO-ARQUITECTURA.md"
|
|
- "@PAT_*" (patrones)
|
|
- "@ESTRUCTURA"
|
|
|
|
no_asignar_si:
|
|
- "Tarea es implementacion de codigo"
|
|
- "No hay componente de diseño/analisis"
|
|
```
|
|
|
|
---
|
|
|
|
### 2. DESARROLLO TECNICO
|
|
|
|
#### PERFIL-DATABASE
|
|
```yaml
|
|
alias: "@PERFIL_DATABASE"
|
|
archivo: "PERFIL-DATABASE.md"
|
|
dominio: "Modelado y DDL de bases de datos"
|
|
|
|
descripcion_breve: |
|
|
Especialista en PostgreSQL. Crea tablas, indices, constraints,
|
|
migraciones. Diseña schemas eficientes y seguros.
|
|
|
|
tipos_tarea:
|
|
- "Crear tabla nueva"
|
|
- "Agregar columna/constraint"
|
|
- "Crear indice"
|
|
- "Diseñar schema"
|
|
- "Escribir migracion"
|
|
- "Optimizar query"
|
|
|
|
directivas:
|
|
- "@OP_DDL"
|
|
- "@PAT_TX" (transacciones)
|
|
- "Directivas de BD del proyecto"
|
|
|
|
estandares:
|
|
- "Nomenclatura snake_case"
|
|
- "Timestamps en todas las tablas"
|
|
- "Soft delete cuando aplique"
|
|
- "UUID como PK preferido"
|
|
|
|
no_asignar_si:
|
|
- "Tarea es de codigo backend/frontend"
|
|
- "Es configuracion de ORM sin DDL"
|
|
```
|
|
|
|
#### PERFIL-BACKEND
|
|
```yaml
|
|
alias: "@PERFIL_BACKEND"
|
|
archivo: "PERFIL-BACKEND.md"
|
|
dominio: "Desarrollo backend NestJS"
|
|
|
|
descripcion_breve: |
|
|
Desarrolla APIs con NestJS. Crea controllers, services, DTOs,
|
|
entities. Implementa logica de negocio del servidor.
|
|
|
|
tipos_tarea:
|
|
- "Crear endpoint REST"
|
|
- "Implementar service"
|
|
- "Crear DTO con validaciones"
|
|
- "Configurar modulo NestJS"
|
|
- "Implementar logica de negocio"
|
|
|
|
directivas:
|
|
- "@OP_BACKEND"
|
|
- "@PAT_VALIDACION"
|
|
- "@PAT_EXCEPTION"
|
|
|
|
estandares:
|
|
- "DTOs con class-validator"
|
|
- "Services inyectables"
|
|
- "Repositorios para acceso a datos"
|
|
- "Swagger decorators"
|
|
|
|
no_asignar_si:
|
|
- "Proyecto usa Express (usar @PERFIL_BACKEND_EXPRESS)"
|
|
- "Tarea es de frontend o base de datos pura"
|
|
```
|
|
|
|
#### PERFIL-BACKEND-EXPRESS
|
|
```yaml
|
|
alias: "@PERFIL_BACKEND_EXPRESS"
|
|
archivo: "PERFIL-BACKEND-EXPRESS.md"
|
|
dominio: "Desarrollo backend Express"
|
|
|
|
descripcion_breve: |
|
|
Desarrolla APIs con Express.js. Crea routes, middlewares,
|
|
controllers. Para proyectos que no usan NestJS.
|
|
|
|
tipos_tarea:
|
|
- "Crear route Express"
|
|
- "Implementar middleware"
|
|
- "Configurar router"
|
|
|
|
directivas:
|
|
- "@OP_BACKEND"
|
|
|
|
no_asignar_si:
|
|
- "Proyecto usa NestJS (usar @PERFIL_BACKEND)"
|
|
```
|
|
|
|
#### PERFIL-FRONTEND
|
|
```yaml
|
|
alias: "@PERFIL_FRONTEND"
|
|
archivo: "PERFIL-FRONTEND.md"
|
|
dominio: "Desarrollo frontend React/Vue"
|
|
|
|
descripcion_breve: |
|
|
Desarrolla interfaces de usuario. Crea componentes React/Vue,
|
|
maneja estado, implementa formularios y navegacion.
|
|
|
|
tipos_tarea:
|
|
- "Crear componente React/Vue"
|
|
- "Implementar pagina/vista"
|
|
- "Crear formulario con validacion"
|
|
- "Integrar con API"
|
|
- "Estilizar con Tailwind/CSS"
|
|
- "Manejar estado (Zustand/Redux)"
|
|
|
|
directivas:
|
|
- "@OP_FRONTEND"
|
|
- "@PAT_VALIDACION" (frontend)
|
|
|
|
estandares:
|
|
- "Componentes funcionales"
|
|
- "Hooks para logica"
|
|
- "TypeScript estricto"
|
|
- "Tailwind para estilos"
|
|
|
|
no_asignar_si:
|
|
- "Tarea es de backend o base de datos"
|
|
- "Es configuracion de servidor"
|
|
```
|
|
|
|
#### PERFIL-ML-SPECIALIST
|
|
```yaml
|
|
alias: "@PERFIL_ML_SPEC"
|
|
archivo: "PERFIL-ML-SPECIALIST.md"
|
|
dominio: "Machine Learning y Data Science"
|
|
|
|
descripcion_breve: |
|
|
Desarrolla modelos de ML. Implementa feature engineering,
|
|
entrena modelos, evalua metricas, despliega para inferencia.
|
|
|
|
tipos_tarea:
|
|
- "Crear modelo predictivo"
|
|
- "Feature engineering"
|
|
- "Entrenar/evaluar modelo"
|
|
- "Optimizar hiperparametros"
|
|
- "Pipeline de inferencia"
|
|
|
|
directivas:
|
|
- "@OP_ML"
|
|
|
|
estandares:
|
|
- "MLflow para tracking"
|
|
- "DVC para datos"
|
|
- "Tests de modelos"
|
|
- "Documentar metricas"
|
|
|
|
no_asignar_si:
|
|
- "No hay componente de ML/datos"
|
|
- "Es desarrollo web tradicional"
|
|
```
|
|
|
|
---
|
|
|
|
### 3. INFRAESTRUCTURA Y DEVOPS
|
|
|
|
#### PERFIL-DEVOPS
|
|
```yaml
|
|
alias: "@PERFIL_DEVOPS"
|
|
archivo: "PERFIL-DEVOPS.md"
|
|
dominio: "CI/CD basico, Docker, Cloud general"
|
|
|
|
descripcion_breve: |
|
|
Configura infraestructura de desarrollo y deployment basico.
|
|
Docker, docker-compose, configuracion de servidores.
|
|
|
|
tipos_tarea:
|
|
- "Crear Dockerfile"
|
|
- "Configurar docker-compose"
|
|
- "Setup basico de servidor"
|
|
- "Configurar nginx basico"
|
|
- "Deploy simple"
|
|
|
|
directivas:
|
|
- "@OP_DEVOPS"
|
|
- "@DOCKER"
|
|
- "@WORKFLOWS"
|
|
|
|
delegar_a_especialista:
|
|
- "Pipelines complejos → @PERFIL_CICD_SPECIALIST"
|
|
- "Produccion critica → @PERFIL_PRODUCTION_MANAGER"
|
|
- "Secretos → @PERFIL_SECRETS_MANAGER"
|
|
- "Monitoreo avanzado → @PERFIL_MONITORING_AGENT"
|
|
```
|
|
|
|
#### PERFIL-CICD-SPECIALIST
|
|
```yaml
|
|
alias: "@PERFIL_CICD_SPECIALIST"
|
|
archivo: "PERFIL-CICD-SPECIALIST.md"
|
|
dominio: "Pipelines CI/CD avanzados"
|
|
|
|
descripcion_breve: |
|
|
Especialista en pipelines de integracion y deployment continuo.
|
|
Jenkins, GitHub Actions, quality gates, estrategias de release.
|
|
|
|
tipos_tarea:
|
|
- "Crear pipeline Jenkins complejo"
|
|
- "Configurar GitHub Actions workflow"
|
|
- "Implementar quality gates"
|
|
- "Estrategia de branching/release"
|
|
- "Configurar shared libraries"
|
|
- "Optimizar tiempos de build"
|
|
|
|
directivas:
|
|
- "CICD-PIPELINES-INVENTORY.yml"
|
|
- "@SIMCO/SIMCO-VALIDAR.md"
|
|
|
|
estandares:
|
|
- "Jenkinsfile declarativo"
|
|
- "Stages atomicos"
|
|
- "Artifacts versionados"
|
|
- "Notificaciones en Slack"
|
|
|
|
no_asignar_si:
|
|
- "Es configuracion basica de Docker"
|
|
- "No hay pipeline involucrado"
|
|
```
|
|
|
|
#### PERFIL-PRODUCTION-MANAGER
|
|
```yaml
|
|
alias: "@PERFIL_PRODUCTION_MANAGER"
|
|
archivo: "PERFIL-PRODUCTION-MANAGER.md"
|
|
dominio: "Gestion de ambientes productivos"
|
|
|
|
descripcion_breve: |
|
|
Gestiona deployments a produccion, rollbacks, mantenimiento
|
|
de servidores productivos. Responsable de uptime.
|
|
|
|
tipos_tarea:
|
|
- "Deploy a produccion"
|
|
- "Ejecutar rollback"
|
|
- "Mantenimiento de servidor prod"
|
|
- "Configurar SSL/dominios"
|
|
- "Planificar ventana de mantenimiento"
|
|
- "Gestionar backups"
|
|
|
|
directivas:
|
|
- "PRODUCTION-INVENTORY.yml"
|
|
- "@SIMCO/SIMCO-VALIDAR.md"
|
|
|
|
estandares:
|
|
- "Approval requerido para prod"
|
|
- "Backup antes de cambios"
|
|
- "Rollback plan obligatorio"
|
|
- "Notificar stakeholders"
|
|
|
|
no_asignar_si:
|
|
- "Es ambiente de desarrollo/staging"
|
|
- "No afecta produccion"
|
|
```
|
|
|
|
#### PERFIL-SECRETS-MANAGER
|
|
```yaml
|
|
alias: "@PERFIL_SECRETS_MANAGER"
|
|
archivo: "PERFIL-SECRETS-MANAGER.md"
|
|
dominio: "Gestion de secretos y credenciales"
|
|
|
|
descripcion_breve: |
|
|
Gestiona secretos, credenciales, API keys de forma segura.
|
|
Rotacion, auditoria, documentacion de variables de entorno.
|
|
|
|
tipos_tarea:
|
|
- "Configurar .env para proyecto"
|
|
- "Rotar credenciales"
|
|
- "Auditar secretos expuestos"
|
|
- "Documentar variables requeridas"
|
|
- "Configurar vault (futuro)"
|
|
|
|
directivas:
|
|
- "ENV-VARS-INVENTORY.yml"
|
|
- Politicas de seguridad
|
|
|
|
estandares:
|
|
- "Nunca commitear secretos"
|
|
- ".env.example actualizado"
|
|
- "Rotacion trimestral"
|
|
- "Permisos 600 en archivos"
|
|
|
|
no_asignar_si:
|
|
- "No involucra credenciales/secretos"
|
|
- "Es codigo de aplicacion"
|
|
```
|
|
|
|
#### PERFIL-MONITORING-AGENT
|
|
```yaml
|
|
alias: "@PERFIL_MONITORING_AGENT"
|
|
archivo: "PERFIL-MONITORING-AGENT.md"
|
|
dominio: "Observabilidad y alertas"
|
|
|
|
descripcion_breve: |
|
|
Configura y mantiene stack de monitoreo. Prometheus, Grafana,
|
|
alertas, dashboards, metricas de aplicacion.
|
|
|
|
tipos_tarea:
|
|
- "Configurar Prometheus"
|
|
- "Crear dashboard Grafana"
|
|
- "Definir reglas de alerta"
|
|
- "Instrumentar aplicacion"
|
|
- "Investigar incidente con metricas"
|
|
- "Crear runbook"
|
|
|
|
directivas:
|
|
- "MONITORING-CONFIG.yml"
|
|
|
|
estandares:
|
|
- "Alertas con runbook"
|
|
- "Dashboards documentados"
|
|
- "Metricas con labels"
|
|
- "Retencion definida"
|
|
|
|
no_asignar_si:
|
|
- "No hay componente de monitoreo"
|
|
- "Es desarrollo de features"
|
|
```
|
|
|
|
#### PERFIL-DEVENV
|
|
```yaml
|
|
alias: "@PERFIL_DEVENV"
|
|
archivo: "PERFIL-DEVENV.md"
|
|
dominio: "Gestion de entornos de desarrollo"
|
|
|
|
descripcion_breve: |
|
|
Gestiona entornos locales de desarrollo. Asigna puertos,
|
|
evita conflictos, documenta configuracion de ambiente.
|
|
|
|
tipos_tarea:
|
|
- "Asignar puertos a nuevo proyecto"
|
|
- "Resolver conflicto de puertos"
|
|
- "Documentar setup de entorno"
|
|
- "Auditar uso de puertos"
|
|
|
|
directivas:
|
|
- "DEVENV-PORTS-INVENTORY.yml"
|
|
|
|
estandares:
|
|
- "Rangos de puertos por proyecto"
|
|
- "Inventario actualizado"
|
|
- ".env.ports por proyecto"
|
|
|
|
no_asignar_si:
|
|
- "Es configuracion de produccion"
|
|
- "No involucra entorno local"
|
|
```
|
|
|
|
---
|
|
|
|
### 4. CALIDAD Y TESTING
|
|
|
|
#### PERFIL-TESTING
|
|
```yaml
|
|
alias: "@PERFIL_TESTING"
|
|
archivo: "PERFIL-TESTING.md"
|
|
dominio: "Testing automatizado"
|
|
|
|
descripcion_breve: |
|
|
Escribe y mantiene tests automatizados. Unit tests, integration tests,
|
|
e2e tests. Mejora cobertura de codigo.
|
|
|
|
tipos_tarea:
|
|
- "Escribir unit tests"
|
|
- "Crear tests de integracion"
|
|
- "Implementar tests e2e"
|
|
- "Aumentar cobertura"
|
|
- "Configurar test framework"
|
|
|
|
directivas:
|
|
- "@PAT_TESTING"
|
|
|
|
estandares:
|
|
- "Cobertura minima 80%"
|
|
- "Tests independientes"
|
|
- "Mocks para dependencias externas"
|
|
- "Nombres descriptivos"
|
|
|
|
no_asignar_si:
|
|
- "Es implementacion de feature sin tests"
|
|
- "Es configuracion de infra"
|
|
```
|
|
|
|
#### PERFIL-CODE-REVIEWER
|
|
```yaml
|
|
alias: "@PERFIL_REVIEWER"
|
|
archivo: "PERFIL-CODE-REVIEWER.md"
|
|
dominio: "Revision de codigo"
|
|
|
|
descripcion_breve: |
|
|
Revisa PRs y codigo. Identifica problemas, sugiere mejoras,
|
|
verifica cumplimiento de estandares.
|
|
|
|
tipos_tarea:
|
|
- "Revisar PR"
|
|
- "Auditar calidad de codigo"
|
|
- "Verificar estandares"
|
|
|
|
directivas:
|
|
- "@CHK_CODE_REVIEW"
|
|
|
|
no_asignar_si:
|
|
- "Es implementacion, no revision"
|
|
```
|
|
|
|
---
|
|
|
|
### 5. SEGURIDAD Y AUDITORIA
|
|
|
|
#### PERFIL-SECURITY-AUDITOR
|
|
```yaml
|
|
alias: "@PERFIL_SEC_AUDITOR"
|
|
archivo: "PERFIL-SECURITY-AUDITOR.md"
|
|
dominio: "Auditoria de seguridad"
|
|
|
|
descripcion_breve: |
|
|
Audita seguridad de codigo y sistemas. Identifica vulnerabilidades,
|
|
propone mitigaciones, verifica OWASP.
|
|
|
|
tipos_tarea:
|
|
- "Auditoria de seguridad"
|
|
- "Identificar vulnerabilidades"
|
|
- "Verificar OWASP Top 10"
|
|
- "Revisar autenticacion/autorizacion"
|
|
|
|
directivas:
|
|
- "@PAT_SECURITY"
|
|
|
|
no_asignar_si:
|
|
- "Es implementacion de features"
|
|
- "No hay componente de seguridad"
|
|
```
|
|
|
|
---
|
|
|
|
### 6. DOCUMENTACION Y KNOWLEDGE BASE
|
|
|
|
#### PERFIL-KB-MANAGER
|
|
```yaml
|
|
alias: "@PERFIL_KB_MANAGER"
|
|
archivo: "core/orchestration/agents/perfiles/PERFIL-KB-MANAGER.md"
|
|
dominio: "Gestion de Knowledge Base"
|
|
|
|
descripcion_breve: |
|
|
Gestiona base de conocimiento compartida. Coordina propagacion
|
|
de mejoras entre proyectos, mantiene catalogo actualizado.
|
|
|
|
tipos_tarea:
|
|
- "Propagar mejora a KB"
|
|
- "Actualizar catalogo"
|
|
- "Coordinar propagacion cross-proyecto"
|
|
- "Generar tareas SCRUM de propagacion"
|
|
|
|
directivas:
|
|
- "@PROPAGACION"
|
|
- "NIVELES-PROPAGACION.yml"
|
|
- "PROTOCOLO-COORDINACION.yml"
|
|
|
|
no_asignar_si:
|
|
- "Es cambio especifico de un proyecto"
|
|
- "No requiere propagacion"
|
|
```
|
|
|
|
#### PERFIL-PROPAGATION-TRACKER
|
|
```yaml
|
|
alias: "@PERFIL_PROPAGATION_TRACKER"
|
|
archivo: "PERFIL-PROPAGATION-TRACKER.md"
|
|
dominio: "Tracking de propagaciones"
|
|
|
|
descripcion_breve: |
|
|
Rastrea estado de propagaciones entre proyectos. Mantiene
|
|
registros, verifica SLAs, genera reportes de estado.
|
|
|
|
tipos_tarea:
|
|
- "Registrar nueva propagacion"
|
|
- "Actualizar estado de propagacion"
|
|
- "Generar reporte de propagaciones"
|
|
- "Alertar SLA en riesgo"
|
|
|
|
directivas:
|
|
- "TRAZABILIDAD-PROPAGACION.yml"
|
|
|
|
no_asignar_si:
|
|
- "Es ejecucion de propagacion (usar KB-Manager)"
|
|
- "No hay tracking involucrado"
|
|
```
|
|
|
|
---
|
|
|
|
### 7. PERFILES ESPECIALIZADOS POR PROYECTO
|
|
|
|
#### PERFIL-TRADING-ML-SPECIALIST (trading-platform)
|
|
```yaml
|
|
alias: "(proyecto especifico)"
|
|
archivo: "projects/trading-platform/orchestration/agents/perfiles/PERFIL-TRADING-ML-SPECIALIST.md"
|
|
dominio: "ML para trading"
|
|
|
|
descripcion_breve: |
|
|
Especialista en ML aplicado a trading. Modelos predictivos,
|
|
backtesting, feature engineering para mercados financieros.
|
|
|
|
tipos_tarea:
|
|
- "Crear modelo de prediccion de precios"
|
|
- "Implementar backtesting"
|
|
- "Feature engineering para trading"
|
|
- "Optimizar estrategia ML"
|
|
|
|
contexto_requerido:
|
|
- "Solo para proyecto trading-platform"
|
|
```
|
|
|
|
#### PERFIL-GAMIFICATION-SPECIALIST (gamilit)
|
|
```yaml
|
|
alias: "(proyecto especifico)"
|
|
archivo: "projects/gamilit/orchestration/agentes/perfiles/PERFIL-GAMIFICATION-SPECIALIST.md"
|
|
dominio: "Gamificacion educativa"
|
|
|
|
descripcion_breve: |
|
|
Especialista en gamificacion para educacion. Sistemas de XP,
|
|
logros, economia virtual, engagement de estudiantes.
|
|
|
|
tipos_tarea:
|
|
- "Diseñar sistema de XP"
|
|
- "Crear logros"
|
|
- "Balancear economia virtual"
|
|
- "Mejorar engagement"
|
|
|
|
contexto_requerido:
|
|
- "Solo para proyecto gamilit"
|
|
```
|
|
|
|
---
|
|
|
|
## MATRIZ DE DECISION RAPIDA
|
|
|
|
### Por Capa de Arquitectura
|
|
|
|
| Capa | Perfil Principal | Alternativa |
|
|
|------|------------------|-------------|
|
|
| Base de Datos | @PERFIL_DATABASE | @PERFIL_DB_AUDITOR (auditoria) |
|
|
| Backend NestJS | @PERFIL_BACKEND | - |
|
|
| Backend Express | @PERFIL_BACKEND_EXPRESS | - |
|
|
| Frontend | @PERFIL_FRONTEND | - |
|
|
| Mobile | @PERFIL_MOBILE | - |
|
|
| ML/Data | @PERFIL_ML_SPEC | Especializado por proyecto |
|
|
| Infra Dev | @PERFIL_DEVENV | @PERFIL_DEVOPS |
|
|
| Infra Prod | @PERFIL_PRODUCTION_MANAGER | @PERFIL_DEVOPS |
|
|
| CI/CD | @PERFIL_CICD_SPECIALIST | @PERFIL_DEVOPS (basico) |
|
|
| Monitoreo | @PERFIL_MONITORING_AGENT | - |
|
|
| Seguridad | @PERFIL_SEC_AUDITOR | @PERFIL_SECRETS_MANAGER |
|
|
|
|
### Por Tipo de Operacion
|
|
|
|
| Operacion | Perfil |
|
|
|-----------|--------|
|
|
| CREAR nuevo | Perfil de la capa correspondiente |
|
|
| MODIFICAR existente | Perfil de la capa correspondiente |
|
|
| VALIDAR/REVISAR | @PERFIL_REVIEWER o auditor especializado |
|
|
| DOCUMENTAR | @PERFIL_DOCS |
|
|
| PROPAGAR | @PERFIL_KB_MANAGER |
|
|
| TRACKEAR | @PERFIL_PROPAGATION_TRACKER |
|
|
| COORDINAR | @PERFIL_ORQUESTADOR |
|
|
| DECIDIR | @PERFIL_TECH_LEADER o @PERFIL_ARCHITECT |
|
|
| DEPLOY | @PERFIL_PRODUCTION_MANAGER o @PERFIL_DEVOPS |
|
|
|
|
---
|
|
|
|
## PROCEDIMIENTO DE ASIGNACION
|
|
|
|
```yaml
|
|
procedimiento_asignacion:
|
|
paso_1:
|
|
accion: "Identificar capa/dominio de la tarea"
|
|
ejemplo: "Crear endpoint → Backend"
|
|
|
|
paso_2:
|
|
accion: "Buscar en mapeo por palabra clave"
|
|
ejemplo: "'endpoint' → @PERFIL_BACKEND"
|
|
|
|
paso_3:
|
|
accion: "Verificar que la tarea coincide con 'tipos_tarea' del perfil"
|
|
verificar: "descripcion_breve del perfil"
|
|
|
|
paso_4:
|
|
accion: "Verificar 'no_asignar_si'"
|
|
resultado: "Si coincide alguna condicion, buscar perfil alternativo"
|
|
|
|
paso_5:
|
|
accion: "Preparar delegacion con contexto minimo"
|
|
incluir:
|
|
- "Alias del perfil"
|
|
- "Descripcion clara de la tarea"
|
|
- "Archivos relevantes a cargar"
|
|
- "Criterios de aceptacion"
|
|
```
|
|
|
|
---
|
|
|
|
## TEMPLATE DE DELEGACION
|
|
|
|
```markdown
|
|
## Delegacion a {ALIAS_PERFIL}
|
|
|
|
**Tarea:** {descripcion breve}
|
|
|
|
**Contexto:**
|
|
- Proyecto: {nombre_proyecto}
|
|
- Ubicacion: {ruta_relevante}
|
|
|
|
**Archivos a cargar:**
|
|
- {archivo_1}
|
|
- {archivo_2}
|
|
|
|
**Criterios de aceptacion:**
|
|
- [ ] {criterio_1}
|
|
- [ ] {criterio_2}
|
|
|
|
**Directivas aplicables:**
|
|
- {directiva_1}
|
|
- {directiva_2}
|
|
```
|
|
|
|
---
|
|
|
|
## PERFILES COMPACTOS (PARA SUBAGENTES)
|
|
|
|
Ubicacion: `compact/`
|
|
|
|
| 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 | Subagente generico | ~200 |
|
|
|
|
**Cuando usar perfiles compactos:**
|
|
- Agente recibe delegacion (opera como subagente)
|
|
- Tarea especifica de 1-2 archivos
|
|
- Optimizacion de tokens necesaria
|
|
|
|
**Ahorro:** ~550 tokens por perfil vs perfil completo
|
|
|
|
**Ver:** `compact/_MAP-COMPACT.md`
|
|
|
|
---
|
|
|
|
## REFERENCIAS
|
|
|
|
- Aliases completos: `orchestration/referencias/ALIASES.yml`
|
|
- Directivas SIMCO: `orchestration/directivas/simco/`
|
|
- Templates: `orchestration/templates/`
|
|
- Perfiles compactos: `orchestration/agents/perfiles/compact/`
|
|
- Protocolo subagente: `orchestration/directivas/simco/SIMCO-SUBAGENTE.md`
|
|
|
|
---
|
|
|
|
**Version:** 2.1.0 | **Sistema:** NEXUS v4.0 + SIMCO | **Mantenido por:** Architecture-Analyst
|