Adrian Flores Cortes
967ab360bb
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>
183 lines
4.9 KiB
Markdown
183 lines
4.9 KiB
Markdown
# 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
|