# 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:**

```markdown
## 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:**

```markdown
## 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:**

```markdown
## 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:**

```markdown
# 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:**

```markdown
## 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

```yaml
# 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