cb4c0681d3
New projects created: - michangarrito (marketplace mobile) - template-saas (SaaS template) - clinica-dental (dental ERP) - clinica-veterinaria (veterinary ERP) Architecture updates: - Move catalog from core/ to shared/ - Add MCP servers structure and templates - Add git management scripts - Update SUBREPOSITORIOS.md with 15 new repos - Update .gitignore for new projects Repository infrastructure: - 4 main repositories - 11 subrepositorios - Gitea remotes configured 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
128 lines
4.4 KiB
Markdown
128 lines
4.4 KiB
Markdown
# 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
|