workspace-v1/core/README.md

Core - Arquitectura del Workspace

Version: 2.0.0 Actualizado: 2026-01-04

Descripcion

El directorio core/ contiene la arquitectura central del workspace: sistema de orquestacion, MCP servers, y herramientas de ambiente. NO contiene codigo de aplicacion ni recursos compartidos (esos estan en shared/).

Estructura

core/
├── README.md                    # Este archivo
│
├── mcp-servers/                 # MCP Servers para el workspace
│   ├── internal/                # Servidores MCP internos
│   ├── external/                # Referencias a servidores externos
│   ├── templates/               # Templates para crear nuevos MCP servers
│   └── _registry.yml            # Registro de servidores disponibles
│
├── orchestration/               # Sistema NEXUS/SIMCO de orquestacion
│   ├── agents/                  # Perfiles de agentes
│   │   ├── perfiles/            # Perfiles ligeros SIMCO
│   │   └── legacy/              # Prompts legacy (referencia)
│   ├── directivas/              # Directivas por operacion
│   │   ├── simco/               # Sistema SIMCO
│   │   ├── legacy/              # Directivas legacy
│   │   └── _MAP.md
│   ├── referencias/             # ALIASES.yml y referencias
│   ├── templates/               # Templates de documentacion
│   ├── auditorias/              # Auditorias arquitectonicas
│   ├── impactos/                # Matrices de impacto
│   ├── inventarios/             # Inventarios de deployment
│   ├── procesos/                # Guias de procesos
│   ├── deployment/              # Arquitectura de deployment
│   ├── claude/                  # Configuraciones Claude
│   └── _historico/              # Documentos archivados
│
└── devtools/                    # Herramientas de ambiente
    └── environment/             # Configuracion de ambientes
        ├── scripts/             # Scripts de setup
        ├── templates/           # Templates .env
        └── DEV-ENVIRONMENT-REGISTRY.yml

Que NO esta en core/

Los siguientes elementos fueron movidos a shared/:

Elemento	Nueva ubicacion
catalog/	shared/catalog/
modules/	shared/modules/
constants/	shared/constants/
types/	shared/types/
standards/	shared/knowledge-base/standards/

Uso

MCP Servers

# Ver servidores disponibles
cat core/mcp-servers/_registry.yml

# Crear nuevo servidor MCP interno
cp -r core/mcp-servers/templates/TEMPLATE-MCP-INTERNO core/mcp-servers/internal/mi-servidor

Sistema de Orquestacion

Los agentes cargan automaticamente las directivas de core/orchestration/directivas/ al inicializar.

# Inicializacion de agente
1. Leer core/orchestration/directivas/simco/_INDEX.md
2. Leer core/orchestration/directivas/principios/*.md
3. Cargar perfil desde core/orchestration/agents/perfiles/
4. Leer ALIASES.yml para navegacion

Herramientas de Ambiente

# Validar ambiente de un proyecto
./core/devtools/environment/scripts/validate-environment.sh /path/to/project

# Setup de ambiente
./core/devtools/environment/scripts/setup-project-env.sh /path/to/project

Relacion con otras carpetas

workspace-v1/
├── core/               # ARQUITECTURA (este directorio)
│   └── orchestration/  # Sistema SIMCO/NEXUS
│
├── shared/             # RECURSOS COMPARTIDOS
│   ├── catalog/        # Funcionalidades reutilizables
│   ├── modules/        # Codigo ejecutable
│   ├── constants/      # Constantes globales
│   ├── types/          # Tipos TypeScript
│   └── knowledge-base/ # Documentacion
│
├── control-plane/      # GOVERNANCE
│   ├── registries/     # Puertos, dominios, BDs
│   ├── manifests/      # Configuraciones de repos
│   └── devtools/       # CI/CD, Docker
│
├── orchestration/      # DIRECTIVAS A NIVEL WORKSPACE (hereda de core/)
│
└── projects/           # PROYECTOS DE PRODUCTO

Ver Tambien

• Sistema de Orquestacion
• MCP Servers
• Recursos Compartidos
• Catalogo de Funcionalidades

---

Mantenido por: Tech-Leader Ultima actualizacion: 2026-01-04