# FASE 2 - TAREAS DE IMPLEMENTACION

**Fase:** 2 - Core Orchestration
**Estado:** Planificado
**Responsable:** Tech-Leader

---

## RESUMEN DE TAREAS

| Grupo | Tareas | Esfuerzo Total |
|-------|--------|----------------|
| T2.1 Directivas Nuevas | 3 | 11 horas |
| T2.2 Actualizacion Directivas | 7 | 8 horas |
| T2.3 Perfiles | 6 | 14 horas |
| T2.4 Templates | 3 | 5 horas |
| T2.5 Integraciones | 4 | 8 horas |
| **TOTAL** | **23** | **46 horas** |

---

## T2.1 DIRECTIVAS NUEVAS

### T2.1.1 Crear SIMCO-DEVOPS.md

**Prioridad:** P0 - Critico
**Esfuerzo:** 4 horas
**Dependencias:** Ninguna
**Responsable:** Tech-Leader

**Descripcion:**
Crear directiva que define como los agentes interactuan con infraestructura, CI/CD y registries.

**Contenido requerido:**
```markdown
1. PROPOSITO
   - Enforcement de registries
   - Gestion de CI/CD
   - Configuracion de ambientes

2. VALIDACIONES PRE-DEPLOYMENT
   - Verificar ports.registry.yml
   - Verificar domains.registry.yml
   - Verificar databases.registry.yml
   - Validar service.descriptor.yml

3. PIPELINES
   - Leer configuracion de service.descriptor.yml
   - Ejecutar segun ci.* flags
   - Build de Docker images

4. AMBIENTES
   - local: Desarrollo individual
   - development: Integracion
   - staging: Pre-produccion
   - production: Produccion

5. ENFORCEMENT
   - Bloquear deployment si validacion falla
   - Reportar violaciones
   - Proceso de excepcion
```

**Criterios de aceptacion:**
- [ ] Archivo creado en control-plane/orchestration/directivas/simco/
- [ ] Cubre todos los puntos del contenido requerido
- [ ] Revisado por Tech-Leader

---

### T2.1.2 Crear SIMCO-SERVICE-DESCRIPTOR.md

**Prioridad:** P0 - Critico
**Esfuerzo:** 3 horas
**Dependencias:** SERVICE-DESCRIPTOR-STANDARD.md (ya creado)
**Responsable:** Tech-Leader

**Descripcion:**
Crear directiva que define el uso del service.descriptor.yml.

**Contenido requerido:**
```markdown
1. PROPOSITO
   - Contrato universal de servicios
   - Conexion con registries
   - Configuracion de CI/CD

2. UBICACION
   - Raiz de cada servicio
   - Ejemplo: apps/backend/service.descriptor.yml

3. CAMPOS OBLIGATORIOS
   - service.name, type, runtime, owner_agent
   - repository.name, path
   - ports.internal, registry_ref
   - environments.deployed_to

4. CAMPOS OPCIONALES
   - domains, database, healthcheck, dependencies
   - ci, observability, resources, metadata

5. VALIDACION
   - YAML valido
   - Referencias a registries existen
   - Campos obligatorios presentes

6. WORKFLOW
   - Crear al crear servicio
   - Actualizar al cambiar configuracion
   - Validar en CI
```

**Criterios de aceptacion:**
- [ ] Archivo creado en control-plane/orchestration/directivas/simco/
- [ ] Referencia a SERVICE-DESCRIPTOR-STANDARD.md
- [ ] Incluye ejemplos practicos

---

### T2.1.3 Crear SIMCO-MULTI-REPO.md

**Prioridad:** P2 - Menor
**Esfuerzo:** 4 horas
**Dependencias:** T2.1.1, T2.1.2
**Responsable:** Tech-Leader

**Descripcion:**
Crear directiva para trabajo en arquitectura multi-repositorio.

**Contenido requerido:**
```markdown
1. ARQUITECTURA DE 3 CAPAS
   - Control Plane: Governance
   - Product Repos: Codigo de productos
   - Shared Repos: Librerias compartidas

2. ORDEN DE CAMBIOS
   - Cambios de configuracion: Control Plane primero
   - Cambios de libs: shared-libs primero
   - Cambios de producto: Product repo

3. VERSIONADO
   - Control Plane: SemVer
   - Shared libs: SemVer con changelog
   - Products: SemVer independiente

4. SINCRONIZACION
   - Como propagar cambios
   - Notificaciones entre repos
   - Validacion de compatibilidad
```

---

## T2.2 ACTUALIZACION DE DIRECTIVAS

### T2.2.1 Actualizar SIMCO-INICIALIZACION.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

**Cambios:**
```markdown
AGREGAR AL PASO 2 DE CCA:
- Cargar ports.registry.yml
- Cargar domains.registry.yml
- Cargar databases.registry.yml
- Identificar service.descriptor.yml del servicio actual (si existe)
```

---

### T2.2.2 Actualizar SIMCO-CREAR.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

**Cambios:**
```markdown
AGREGAR PASO 0 (PRE-CREACION):
- Si es servicio nuevo: Verificar puerto disponible en ports.registry
- Si usa BD: Verificar conexion en databases.registry
- Si expone dominio: Verificar en domains.registry
- Crear service.descriptor.yml con referencias a registries
```

---

### T2.2.3 Actualizar SIMCO-VALIDAR.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

**Cambios:**
```markdown
AGREGAR VALIDACIONES DE REGISTRY:
- Puertos usados estan en ports.registry
- Dominios usados estan en domains.registry
- Conexiones BD estan en databases.registry
- service.descriptor.yml es valido y referencias existen
```

---

### T2.2.4 Actualizar SIMCO-BACKEND.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Cambios:**
```markdown
AGREGAR SECCION: SERVICE DESCRIPTOR
- Todo servicio backend DEBE tener service.descriptor.yml
- El descriptor debe referenciar ports.registry
- El descriptor debe referenciar databases.registry
- Actualizar descriptor al cambiar puertos o BD

AGREGAR SECCION: REGISTRY AWARENESS
- Pre-condiciones de verificacion
- Post-condiciones de actualizacion
```

---

### T2.2.5 Actualizar SIMCO-DDL.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

**Cambios:**
```markdown
AGREGAR VERIFICACIONES:
- Antes de crear BD: Verificar databases.registry
- Usar roles definidos (owner, runtime, migrator)
- Seguir convencion de nombres del registry
- Actualizar registry al crear nueva BD
```

---

### T2.2.6 Actualizar SIMCO-NIVELES.md

**Prioridad:** P2 - Menor
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

**Cambios:**
```markdown
ACTUALIZAR NIVELES:
Antes:
- Nivel 0: Workspace
- Nivel 1: Proyecto
- Nivel 2: Modulo

Despues:
- Nivel 0: Control Plane
- Nivel 1: Product Repo
- Nivel 2: Service (app)
- Nivel 3: Module
```

---

### T2.2.7 Actualizar SIMCO-PROPAGACION.md

**Prioridad:** P2 - Menor
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

**Cambios:**
```markdown
AGREGAR:
- Propagacion a Control Plane (registries)
- Propagacion a shared-libs (si aplica)
- Notificacion a otros repos afectados
- Orden de propagacion multi-repo
```

---

## T2.3 PERFILES DE AGENTES

### T2.3.1 Crear PERFIL-DEVOPS.md

**Prioridad:** P0 - Critico
**Esfuerzo:** 4 horas
**Responsable:** Tech-Leader

**Template:**
```markdown
# PERFIL: DEVOPS-AGENT

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

## RESPONSABILIDADES
1. Gestion de registries
2. Enforcement de politicas
3. Configuracion de CI/CD
4. Gestion de ambientes
5. Infraestructura Docker/K8s

## HERRAMIENTAS
- Scripts de validacion
- Docker compose
- Traefik configuration
- GitHub Actions / Jenkins

## DIRECTIVAS
- SIMCO-DEVOPS.md
- SIMCO-SERVICE-DESCRIPTOR.md

## INTERACCIONES
- Recibe requests de deployment
- Valida contra registries
- Reporta a Tech-Leader
```

---

### T2.3.2 Actualizar PERFIL-BACKEND.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Agregar secciones:**
- REGISTRY AWARENESS
- SERVICE DESCRIPTOR WORKFLOW
- PRE/POST CONDICIONES

---

### T2.3.3 Actualizar PERFIL-FRONTEND.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Agregar secciones:**
- DOMAIN REGISTRY AWARENESS
- ENVIRONMENT CONFIGURATION
- API URL MANAGEMENT

---

### T2.3.4 Actualizar PERFIL-DATABASE.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Agregar secciones:**
- DATABASE REGISTRY ENFORCEMENT
- ROLE CONVENTIONS
- CREDENTIAL MANAGEMENT

---

### T2.3.5 Actualizar PERFIL-TECH-LEADER.md

**Prioridad:** P1 - Importante
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Agregar secciones:**
- ARQUITECTURA MULTI-REPO
- GOVERNANCE DE CONTROL PLANE
- DECISION MAKING PARA REGISTRIES

---

### T2.3.6 Actualizar ALIASES.yml

**Prioridad:** P1 - Importante
**Esfuerzo:** 0.5 horas
**Responsable:** Tech-Leader

**Agregar:**
```yaml
NEXUS-DEVOPS:
  profile: "PERFIL-DEVOPS.md"
  aliases: ["devops-agent", "infra-agent", "ci-agent"]
```

---

## T2.4 TEMPLATES

### T2.4.1 Crear SERVICE-DESCRIPTOR-TEMPLATE.yml

**Prioridad:** P1 - Importante
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Ubicacion:** control-plane/orchestration/templates/service-descriptor/

---

### T2.4.2 Actualizar Templates de Backend

**Prioridad:** P2 - Menor
**Esfuerzo:** 2 horas
**Responsable:** Tech-Leader

**Cambios:**
- Agregar service.descriptor.yml a templates
- Pre-llenar con placeholders

---

### T2.4.3 Crear Template de Frontend

**Prioridad:** P2 - Menor
**Esfuerzo:** 1 hora
**Responsable:** Tech-Leader

---

## T2.5 INTEGRACIONES

### T2.5.1 Crear validate-service-descriptors.sh

**Prioridad:** P1 - Importante
**Esfuerzo:** 3 horas
**Responsable:** DevOps-Agent

**Funcionalidad:**
- Validar YAML valido
- Validar campos obligatorios
- Validar referencias a registries existen

---

### T2.5.2 Actualizar validate-all.sh

**Prioridad:** P1 - Importante
**Esfuerzo:** 1 hora
**Responsable:** DevOps-Agent

**Cambios:**
- Incluir validate-service-descriptors.sh

---

### T2.5.3 Crear pre-commit hooks

**Prioridad:** P2 - Menor
**Esfuerzo:** 2 horas
**Responsable:** DevOps-Agent

**Hooks:**
- validate-ports
- validate-service-descriptors

---

### T2.5.4 Documentar integracion CI

**Prioridad:** P2 - Menor
**Esfuerzo:** 2 horas
**Responsable:** DevOps-Agent

**Contenido:**
- Como CI lee service.descriptor.yml
- Variables de entorno
- Build de Docker images

---

## CRONOGRAMA SUGERIDO

```
DIA 1:
- T2.1.1 Crear SIMCO-DEVOPS.md
- T2.1.2 Crear SIMCO-SERVICE-DESCRIPTOR.md

DIA 2:
- T2.3.1 Crear PERFIL-DEVOPS.md
- T2.2.1-T2.2.3 Actualizar directivas core

DIA 3:
- T2.2.4-T2.2.7 Completar actualizacion directivas
- T2.3.2-T2.3.4 Actualizar perfiles desarrollo

DIA 4:
- T2.3.5-T2.3.6 Completar perfiles
- T2.4.1-T2.4.3 Templates

DIA 5:
- T2.5.1-T2.5.4 Integraciones
- T2.1.3 SIMCO-MULTI-REPO (si hay tiempo)
- Validacion final
```

---

**Documento generado por:** Tech-Leader