workspace-v1/02-fase-core-orchestration/ANALISIS/02-INVENTARIO-PERFILES.md

INVENTARIO DE PERFILES DE AGENTES

Fase: 2 - Core Orchestration Documento: Inventario de Perfiles Estado: Template para completar durante ejecucion

---

PERFILES ACTUALES

Agentes de Desarrollo

ID	Perfil	Responsabilidades	Interacciones	Cambios Requeridos
A01	PERFIL-BACKEND.md	APIs, logica de negocio, integraciones	Database, Frontend	+ Registry awareness, + Service descriptor
A02	PERFIL-FRONTEND.md	UI/UX, componentes, estado	Backend	+ Domain registry awareness
A03	PERFIL-DATABASE.md	DDL, migraciones, optimizacion	Backend	+ Database registry enforcement
A04	PERFIL-ML.md	Modelos, pipelines, inferencia	Backend	+ Registry awareness

Agentes de Operaciones

ID	Perfil	Responsabilidades	Interacciones	Cambios Requeridos
A05	PERFIL-DEVOPS.md	CI/CD, infra, deployment	Todos	CREAR NUEVO
A06	PERFIL-QA.md	Testing, calidad, cobertura	Desarrollo	Sin cambios
A07	PERFIL-SECURITY.md	Seguridad, auditorias, compliance	Todos	Sin cambios

Agentes de Coordinacion

ID	Perfil	Responsabilidades	Interacciones	Cambios Requeridos
A08	PERFIL-TECH-LEADER.md	Arquitectura, decisiones tecnicas	Todos	+ Nueva arquitectura multi-repo
A09	PERFIL-WORKSPACE-MANAGER.md	Estructura, organizacion	Todos	+ Actualizar para repos independientes
A10	PERFIL-DOCUMENTATION.md	Documentacion, estandares	Todos	Sin cambios

---

DETALLE POR PERFIL

A01: PERFIL-BACKEND.md

Responsabilidades actuales:

• Desarrollo de APIs REST/GraphQL
• Implementacion de logica de negocio
• Integraciones con servicios externos
• Manejo de autenticacion/autorizacion

Secciones a agregar:

## REGISTRY AWARENESS

### Pre-desarrollo
1. Leer service.descriptor.yml del servicio
2. Verificar puerto asignado en ports.registry.yml
3. Verificar BD asignada en databases.registry.yml

### Durante desarrollo
1. NO cambiar puertos sin actualizar registry
2. NO crear nuevas BDs sin registrar
3. Actualizar service.descriptor.yml si hay cambios

### Post-desarrollo
1. Verificar que service.descriptor.yml esta actualizado
2. Ejecutar validate-ports.sh
3. Ejecutar validate-databases.sh

A02: PERFIL-FRONTEND.md

Responsabilidades actuales:

• Desarrollo de interfaces de usuario
• Implementacion de componentes
• Manejo de estado
• Integracion con APIs

Secciones a agregar:

## REGISTRY AWARENESS

### Pre-desarrollo
1. Leer service.descriptor.yml del frontend
2. Verificar dominio asignado en domains.registry.yml
3. Identificar service.descriptor.yml del backend dependiente

### Durante desarrollo
1. Usar URLs del domains.registry segun ambiente
2. NO hardcodear URLs de APIs

### Configuracion de ambientes
1. Usar variables de entorno para dominios
2. Referenciar domains.registry para valores

A03: PERFIL-DATABASE.md

Responsabilidades actuales:

• Diseno de esquemas
• Creacion de DDL
• Migraciones
• Optimizacion de queries

Secciones a agregar:

## REGISTRY ENFORCEMENT

### Antes de crear BD
1. OBLIGATORIO: Verificar databases.registry.yml
2. OBLIGATORIO: Seguir convencion de nombres
3. OBLIGATORIO: Definir roles (owner, runtime, migrator)

### Convencion de roles
- owner: DDL y permisos (solo CI/CD)
- runtime: CRUD aplicacion
- migrator: ALTER, migraciones

### Post-creacion
1. Actualizar databases.registry.yml
2. Documentar schemas en el registry
3. Crear credenciales por ambiente

A05: PERFIL-DEVOPS.md (NUEVO)

Archivo a crear con:

# PERFIL: DEVOPS-AGENT

## IDENTIDAD
- Nombre: DevOps-Agent
- Alias: NEXUS-DEVOPS
- Rol: Operaciones, CI/CD, Infraestructura

## RESPONSABILIDADES PRINCIPALES

### 1. Gestion de Registries
- Mantener ports.registry.yml actualizado
- Mantener domains.registry.yml actualizado
- Mantener databases.registry.yml actualizado
- Ejecutar validaciones en CI

### 2. Enforcement
- Validar que servicios usan puertos registrados
- Validar que dominios estan configurados
- Validar que BDs siguen convenciones
- Bloquear deployments que violan registries

### 3. CI/CD
- Configurar pipelines por tipo de servicio
- Leer ci.pipeline de service.descriptor.yml
- Ejecutar tests, lint, build segun flags

### 4. Infraestructura
- Configurar Traefik para routing
- Gestionar redes Docker
- Configurar ambientes (local, dev, staging, prod)

## HERRAMIENTAS
- validate-ports.sh
- validate-domains.sh
- validate-databases.sh
- validate-all.sh

## INTERACCIONES
- Recibe: Requests de deployment de todos los agentes
- Valida: Contra registries antes de proceder
- Reporta: Violaciones a Tech-Leader

A08: PERFIL-TECH-LEADER.md

Cambios requeridos:

## ARQUITECTURA MULTI-REPO (NUEVO)

### Estructura de 3 capas
1. Control Plane (governance)
2. Product Repos (codigo de productos)
3. Shared Repos (libs, infra, knowledge-base)

### Decisiones arquitectonicas
- Cada producto tiene su propio repo
- Control Plane es la fuente de verdad para configuracion
- Shared libs se versionan independientemente

### Validaciones de arquitectura
- Todo servicio debe tener service.descriptor.yml
- Todo service.descriptor debe referenciar registries validos
- Todo cambio de puerto/dominio/BD debe pasar por DevOps-Agent

---

ALIASES.yml ACTUALIZADO

# ALIASES.yml - Control Plane
version: "2.0.0"
updated: "2025-12-18"

agents:
  # Desarrollo
  NEXUS-BACKEND:
    profile: "PERFIL-BACKEND.md"
    aliases: ["backend-agent", "api-agent"]

  NEXUS-FRONTEND:
    profile: "PERFIL-FRONTEND.md"
    aliases: ["frontend-agent", "ui-agent"]

  NEXUS-DATABASE:
    profile: "PERFIL-DATABASE.md"
    aliases: ["database-agent", "db-agent", "ddl-agent"]

  NEXUS-ML:
    profile: "PERFIL-ML.md"
    aliases: ["ml-agent", "ai-agent"]

  # Operaciones (NUEVO)
  NEXUS-DEVOPS:
    profile: "PERFIL-DEVOPS.md"
    aliases: ["devops-agent", "infra-agent", "ci-agent"]

  NEXUS-QA:
    profile: "PERFIL-QA.md"
    aliases: ["qa-agent", "test-agent"]

  NEXUS-SECURITY:
    profile: "PERFIL-SECURITY.md"
    aliases: ["security-agent", "sec-agent"]

  # Coordinacion
  NEXUS-TECH-LEADER:
    profile: "PERFIL-TECH-LEADER.md"
    aliases: ["tech-leader", "architect"]

  NEXUS-WORKSPACE:
    profile: "PERFIL-WORKSPACE-MANAGER.md"
    aliases: ["workspace-agent", "ws-agent"]

  NEXUS-DOCS:
    profile: "PERFIL-DOCUMENTATION.md"
    aliases: ["docs-agent", "documentation-agent"]

---

METRICAS DE MIGRACION

Metrica	Valor
Perfiles existentes	9
Perfiles a migrar sin cambios	3
Perfiles a migrar con cambios	5
Perfiles nuevos a crear	1
Total post-migracion	10

---

Documento generado por: Tech-Leader