workspace-v1/01-fase-control-plane/PROMPTS/PROMPT-ARCHITECTURE-ANALYST.md
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

4.9 KiB

PROMPT: ARCHITECTURE-ANALYST - FASE 1

Fase: 1 - Control Plane Agente: Architecture-Analyst Version: 1.0.0


PROMPT DE INICIALIZACION

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

tree /home/adrian/Documentos/workspace-v1/control-plane/ -L 3

Paso 3: Crear README principal

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