# PROMPT: ARCHITECTURE-ANALYST - FASE 1 **Fase:** 1 - Control Plane **Agente:** Architecture-Analyst **Version:** 1.0.0 --- ## PROMPT DE INICIALIZACION ```markdown Seras Architecture-Analyst trabajando en la migracion del workspace para realizar: Crear la estructura del Control Plane (Fase 1) ## CONTEXTO Estamos migrando el workspace actual ubicado en: /home/adrian/Documentos/workspace Hacia una nueva arquitectura de 3 capas en: /home/adrian/Documentos/workspace-v1 Tu tarea es crear la estructura base del "Control Plane" que funcionara como el meta-repositorio de gobernanza. ## ARQUITECTURA OBJETIVO El Control Plane debe contener: ``` workspace-v1/control-plane/ | +-- orchestration/ # Sistema SIMCO/NEXUS (migrado) | +-- agents/perfiles/ | +-- directivas/simco/ | +-- directivas/principios/ | +-- templates/ | +-- checklists/ | +-- patrones/ | +-- referencias/ | +-- registries/ # NUEVO: Registros centralizados | +-- ports.registry.yml | +-- domains.registry.yml | +-- databases.registry.yml | +-- services.registry.yml | +-- manifests/ # NUEVO: Manifiestos | +-- repos.manifest.yml | +-- environments.manifest.yml | +-- ci/ # Templates CI/CD | +-- jenkins/ | +-- github-actions/ | +-- devtools/ # Herramientas +-- scripts/ +-- docker/ ``` ## TUS TAREAS ESPECIFICAS 1. **Crear estructura de carpetas** - Ejecutar comandos mkdir para crear toda la estructura - Verificar que se creo correctamente 2. **Crear archivos README.md** - Un README.md en control-plane/ explicando el proposito - Un README.md en registries/ explicando cada registry - Un README.md en manifests/ explicando cada manifest 3. **Crear manifests basicos** - repos.manifest.yml con la lista de repos del workspace - environments.manifest.yml con los ambientes (local, dev, prod) ## REFERENCIAS DEL WORKSPACE ACTUAL Consultar estos archivos para extraer informacion: - /home/adrian/Documentos/workspace/orchestration/referencias/PROYECTOS-ACTIVOS.yml - /home/adrian/Documentos/workspace/README.md - /home/adrian/Documentos/workspace/docker-compose.yml ## RESTRICCIONES - NO modificar el workspace actual (/home/adrian/Documentos/workspace) - TODO se crea en /home/adrian/Documentos/workspace-v1 - Los registries se crean con estructura pero datos placeholder (se llenaran en Fase 3) - Seguir convenciones YAML existentes del workspace actual ## VALIDACION Al terminar, verificar: ```bash # Estructura existe ls -la /home/adrian/Documentos/workspace-v1/control-plane/ # Archivos YAML son validos yamllint /home/adrian/Documentos/workspace-v1/control-plane/**/*.yml ``` ## ENTREGABLES 1. Estructura de carpetas completa 2. README.md en carpetas principales 3. repos.manifest.yml 4. environments.manifest.yml 5. Reporte de lo creado en IMPLEMENTACION/00-EJECUCION.md ## PROTOCOLO Antes de actuar: 1. Lee el plan en PLANEACION/00-TAREAS.md 2. Revisa las dependencias 3. Ejecuta las tareas en orden 4. Documenta cada accion en IMPLEMENTACION/00-EJECUCION.md 5. Marca tareas completadas ``` --- ## EJEMPLO DE EJECUCION ### Paso 1: Crear estructura ```bash # Crear estructura principal mkdir -p /home/adrian/Documentos/workspace-v1/control-plane/{orchestration,registries,manifests,ci,devtools,docs} # Crear subestructura orchestration mkdir -p /home/adrian/Documentos/workspace-v1/control-plane/orchestration/{agents/{perfiles,legacy},directivas/{simco,principios,legacy},templates,checklists,patrones,referencias,impactos} # Crear subestructura ci mkdir -p /home/adrian/Documentos/workspace-v1/control-plane/ci/{jenkins/{Jenkinsfile.templates,shared-library},github-actions/workflows} # Crear subestructura devtools mkdir -p /home/adrian/Documentos/workspace-v1/control-plane/devtools/{scripts/{validation,bootstrap},docker,configs} # Crear docs mkdir -p /home/adrian/Documentos/workspace-v1/control-plane/docs/{governance,onboarding,adr} ``` ### Paso 2: Verificar ```bash tree /home/adrian/Documentos/workspace-v1/control-plane/ -L 3 ``` ### Paso 3: Crear README principal ```bash cat > /home/adrian/Documentos/workspace-v1/control-plane/README.md << 'EOF' # Control Plane - Workspace v1 ## Proposito Este repositorio es el "Control Plane" de la fabrica de software. Contiene la gobernanza, registros y herramientas compartidas. ## Estructura - `orchestration/` - Sistema de agentes SIMCO/NEXUS - `registries/` - Registros de puertos, dominios, BDs - `manifests/` - Manifiestos de repos y ambientes - `ci/` - Templates de CI/CD - `devtools/` - Herramientas de desarrollo - `docs/` - Documentacion de gobernanza ## Uso Este repo NO contiene codigo de producto. Los productos viven en repos separados listados en `manifests/repos.manifest.yml` EOF ``` --- ## NOTAS PARA EL AGENTE - Este es el primer paso de la migracion - La calidad de esta estructura afecta todas las fases siguientes - Priorizar claridad y consistencia sobre velocidad - Documentar TODA decision tomada