Adrian Flores Cortes 967ab360bb Initial commit: Workspace v1 with 3-layer architecture

Structure:
- control-plane/: Registries, SIMCO directives, CI/CD templates
- projects/: Gamilit, ERP-Suite, Trading-Platform, Betting-Analytics
- shared/: Libs catalog, knowledge-base

Key features:
- Centralized port, domain, database, and service registries
- 23 SIMCO directives + 6 fundamental principles
- NEXUS agent profiles with delegation rules
- Validation scripts for workspace integrity
- Dockerfiles for all services
- Path aliases for quick reference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-23 00:35:19 -06:00

9.9 KiB

Raw Blame History

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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

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

9.9 KiB Raw Blame History

FASE 2 - TAREAS DE IMPLEMENTACION

RESUMEN DE TAREAS

T2.1 DIRECTIVAS NUEVAS

T2.1.1 Crear SIMCO-DEVOPS.md

T2.1.2 Crear SIMCO-SERVICE-DESCRIPTOR.md

T2.1.3 Crear SIMCO-MULTI-REPO.md

T2.2 ACTUALIZACION DE DIRECTIVAS

T2.2.1 Actualizar SIMCO-INICIALIZACION.md

T2.2.2 Actualizar SIMCO-CREAR.md

T2.2.3 Actualizar SIMCO-VALIDAR.md

T2.2.4 Actualizar SIMCO-BACKEND.md

T2.2.5 Actualizar SIMCO-DDL.md

T2.2.6 Actualizar SIMCO-NIVELES.md

T2.2.7 Actualizar SIMCO-PROPAGACION.md

T2.3 PERFILES DE AGENTES

T2.3.1 Crear PERFIL-DEVOPS.md

T2.3.2 Actualizar PERFIL-BACKEND.md

T2.3.3 Actualizar PERFIL-FRONTEND.md

T2.3.4 Actualizar PERFIL-DATABASE.md

T2.3.5 Actualizar PERFIL-TECH-LEADER.md

T2.3.6 Actualizar ALIASES.yml

T2.4 TEMPLATES

T2.4.1 Crear SERVICE-DESCRIPTOR-TEMPLATE.yml

T2.4.2 Actualizar Templates de Backend

T2.4.3 Crear Template de Frontend

T2.5 INTEGRACIONES

T2.5.1 Crear validate-service-descriptors.sh

T2.5.2 Actualizar validate-all.sh

T2.5.3 Crear pre-commit hooks

T2.5.4 Documentar integracion CI

CRONOGRAMA SUGERIDO

9.9 KiB

Raw Blame History