# 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

```bash
# 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.

```markdown
# 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

```bash
# 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](orchestration/README.md)
- [MCP Servers](mcp-servers/README.md)
- [Recursos Compartidos](../shared/README.md)
- [Catalogo de Funcionalidades](../shared/catalog/README.md)

---

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