# Estrategia Multi-Repositorio > **ES** | [EN](../../architecture/multi-repo-strategy.md) | [PT](../../pt/architecture/multi-repo-strategy.md) --- **Versión:** 2.1.0 **Última actualización:** 2026-01-28 **Estado:** Documento de Arquitectura Oficial --- ## Tabla de Contenidos - [Descripción General](#descripción-general) - [Estructura de Repositorios](#estructura-de-repositorios) - [Repositorio Central (aiox-core)](#repositorio-central-aiox-core) - [Repositorios Squad](#repositorios-squad) - [Repositorio del Ecosistema MCP](#repositorio-del-ecosistema-mcp) - [Repositorios Privados](#repositorios-privados) - [Mecanismo de Sincronización](#mecanismo-de-sincronización) - [Distribución de Paquetes](#distribución-de-paquetes) - [Mejores Prácticas](#mejores-prácticas) --- ## Descripción General AIOX v4 adopta una **estrategia multi-repositorio** para permitir el desarrollo modular, las contribuciones de la comunidad y una clara separación entre el marco fundamental, las extensiones (squads) y los componentes propietarios. ### Objetivos de Diseño | Objetivo | Descripción | | ----------------------------- | ----------------------------------------------------- | | **Modularidad** | Los squads pueden desarrollarse y versionarse independientemente | | **Comunidad** | Los squads de código abierto fomentan las contribuciones comunitarias | | **Protección de IP** | Los componentes propietarios permanecen en repositorios privados | | **Escalabilidad** | Los equipos pueden trabajar en repositorios separados sin conflictos | | **Flexibilidad de Licencias** | Los diferentes componentes pueden tener diferentes licencias | --- ## Estructura de Repositorios ``` Organización SynkraAI ├── REPOSITORIOS PÚBLICOS │ ├── aiox-core # Marco fundamental (MIT) │ ├── aiox-squads # Squads comunitarios (MIT) │ └── mcp-ecosystem # Configuraciones MCP (Apache 2.0) │ └── REPOSITORIOS PRIVADOS ├── mmos # MMOS propietario (NDA) └── certified-partners # Recursos de socios (Propietario) ``` ### Arquitectura Visual ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ ORGANIZACIÓN SYNKRA │ │ │ │ REPOSITORIOS PÚBLICOS │ │ ═══════════════════════ │ │ │ │ ┌────────────────────┐ ┌────────────────────┐ │ │ │ SynkraAI/ │ │ SynkraAI/ │ │ │ │ aiox-core │ │ aiox-squads │ │ │ │ (MIT) │◄────│ (MIT) │ │ │ │ │ │ │ │ │ │ - Marco │ │ - Squad ETL │ │ │ │ Fundamental │ │ - Squad Creator │ │ │ │ - 11 Agentes Base │ │ - Squad MMOS │ │ │ │ - Puertas de │ │ - Squads │ │ │ │ Calidad │ │ Comunitarios │ │ │ │ - Hub de │ │ │ │ │ │ Discusiones │ │ │ │ │ └────────────────────┘ └────────────────────┘ │ │ │ │ │ │ dependencia opcional │ │ ▼ │ │ ┌────────────────────┐ │ │ │ SynkraAI/ │ │ │ │ mcp-ecosystem │ │ │ │ (Apache 2.0) │ │ │ │ │ │ │ │ - Docker MCP │ │ │ │ - Configuraciones │ │ │ │ de IDE │ │ │ │ - Presets MCP │ │ │ └────────────────────┘ │ │ │ │ REPOSITORIOS PRIVADOS │ │ ════════════════════════ │ │ │ │ ┌────────────────────┐ ┌────────────────────┐ │ │ │ SynkraAI/mmos │ │ SynkraAI/ │ │ │ │ (Propietario+NDA) │ │ certified-partners│ │ │ │ │ │ (Propietario) │ │ │ │ - Mentes MMOS │ │ - Squads Premium │ │ │ │ - ADN Mental │ │ - Portal de Socios│ │ │ └────────────────────┘ └────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────┘ ``` --- ## Repositorio Central (aiox-core) ### Propósito El repositorio central contiene el marco AIOX fundamental del que todos los proyectos dependen. ### Contenidos | Directorio | Descripción | | ---------------------------- | ------------------------------------------------------- | | `.aiox-core/core/` | Fundamentos del marco (config, registry, puertas de calidad) | | `.aiox-core/development/` | Definiciones de agentes, tareas, flujos de trabajo | | `.aiox-core/product/` | Plantillas, listas de verificación, datos de PM | | `.aiox-core/infrastructure/` | Scripts, herramientas, integraciones | | `docs/` | Documentación del marco | ### Licencia **MIT** - Licencia permisiva para uso, modificacion y distribucion del core. ### Paquete npm ```bash npm install @aiox/core ``` --- ## Repositorios Squad ### Descripción General Los squads son extensiones modulares que agregan capacidades especializadas a AIOX. ### Repositorio aiox-squads ``` aiox-squads/ ├── etl/ # Squad de procesamiento ETL │ ├── squad.yaml # Manifiesto del squad │ ├── agents/ # Agentes específicos del squad │ ├── tasks/ # Tareas del squad │ └── README.md # Documentación del squad │ ├── creator/ # Squad de creación de contenido │ ├── squad.yaml │ ├── agents/ │ └── tasks/ │ ├── mmos/ # Squad de integración MMOS │ ├── squad.yaml │ ├── agents/ │ └── tasks/ │ └── templates/ # Plantillas de creación de squad └── squad-template/ ``` ### Manifiesto del Squad (squad.yaml) ```yaml name: etl version: 1.0.0 description: Squad de procesamiento ETL para tuberías de datos license: MIT peerDependencies: '@aiox/core': '^2.1.0' agents: - id: data-engineer extends: dev tasks: - extract-data - transform-data - load-data exports: - agents - tasks ``` ### Licencia **MIT** - Libertad de código abierto completa para contribuciones comunitarias. ### Paquetes npm ```bash npm install @aiox/squad-etl npm install @aiox/squad-creator npm install @aiox/squad-mmos ``` --- ## Repositorio del Ecosistema MCP ### Propósito Configuraciones MCP (Model Context Protocol) centralizadas para varios IDEs y entornos. ### Contenidos ``` mcp-ecosystem/ ├── docker/ # Configuraciones Docker MCP │ ├── docker-compose.yml │ └── mcp-servers/ │ ├── ide-configs/ # Configuraciones específicas del IDE │ ├── claude-code/ │ ├── cursor/ │ └── vscode/ │ └── presets/ # Paquetes MCP preconfigurados ├── minimal/ ├── development/ └── enterprise/ ``` ### Licencia **Apache 2.0** - Licencia permisiva para máxima adopción. ### Paquete npm ```bash npm install @aiox/mcp-presets ``` --- ## Repositorios Privados ### SynkraAI/mmos (Propietario + NDA) Contiene componentes MMOS (Mental Model Operating System) propietarios: - Definiciones de Mentes MMOS - Algoritmos de ADN Mental - Datos de entrenamiento propietarios - Personalizaciones específicas de socios **Acceso:** Requiere acuerdo NDA y de licencia. ### SynkraAI/certified-partners (Propietario) Recursos para socios certificados de AIOX: - Implementaciones de squads premium - Acceso al portal de socios - Herramientas de soporte empresarial - Configuraciones de marca blanca **Acceso:** Requiere estado de socio certificado. --- ## Mecanismo de Sincronización ### Dependencias Entre Repositorios ``` ┌──────────────┐ depende de ┌──────────────┐ │ aiox-squads │ ──────────────────► │ aiox-core │ └──────────────┘ └──────────────┘ │ │ │ │ │ opcional │ opcional │ │ ▼ ▼ ┌──────────────┐ ┌──────────────┐ │mcp-ecosystem │ │ mmos │ └──────────────┘ └──────────────┘ ``` ### Compatibilidad de Versiones | aiox-core | aiox-squads | mcp-ecosystem | | --------- | ----------- | ------------- | | ^2.1.0 | ^1.0.0 | ^1.0.0 | | ^3.0.0 | ^2.0.0 | ^1.x.x | ### Git Submodules (Opcional) Para proyectos que necesitan múltiples repositorios: ```bash # Agregar squads como submodule git submodule add https://github.com/SynkraAI/aiox-squads.git squads # Agregar ecosistema MCP como submodule git submodule add https://github.com/SynkraAI/mcp-ecosystem.git mcp ``` ### Dependencias npm (Recomendado) ```json { "dependencies": { "@aiox/core": "^2.1.0", "@aiox/squad-etl": "^1.0.0", "@aiox/mcp-presets": "^1.0.0" } } ``` --- ## Distribución de Paquetes ### Alcance de Paquetes npm | Paquete | Registro | Licencia | Repositorio | | --------------------- | ---------- | -------------- | ------------- | | `@aiox/core` | npm public | MIT | aiox-core | | `@aiox/squad-etl` | npm public | MIT | aiox-squads | | `@aiox/squad-creator` | npm public | MIT | aiox-squads | | `@aiox/squad-mmos` | npm public | MIT | aiox-squads | | `@aiox/mcp-presets` | npm public | Apache 2.0 | mcp-ecosystem | ### Flujo de Publicación ```bash # Desde aiox-core npm publish --access public # Desde aiox-squads/etl cd etl && npm publish --access public # Desde mcp-ecosystem npm publish --access public ``` --- ## Mejores Prácticas ### Para Colaboradores del Núcleo 1. **Cambios Atómicos** - Mantén los PRs enfocados en características o correcciones únicas 2. **Compatibilidad Hacia Atrás** - Evita cambios disruptivos en versiones menores 3. **Documentación** - Actualiza la documentación en el mismo PR que los cambios de código 4. **Pruebas Entre Repositorios** - Prueba los cambios contra repositorios dependientes ### Para Desarrolladores de Squads 1. **Manifiesto Primero** - Define squad.yaml antes de implementar 2. **Dependencias Entre Iguales** - Especifica los requisitos exactos de versión de aiox-core 3. **Pruebas Independientes** - Los squads deben tener sus propios conjuntos de pruebas 4. **Estándares README** - Incluye ejemplos de uso y requisitos ### Para Consumidores de Proyectos 1. **Bloquea Versiones** - Utiliza versiones exactas en producción 2. **Prueba Actualizaciones** - Ejecuta el conjunto de pruebas completo después de actualizar dependencias 3. **Monitorea Lanzamientos** - Suscribete a notificaciones de lanzamiento 4. **Reporta Problemas** - Reporta problemas en el repositorio correcto ### Mantenimiento del Repositorio | Tarea | Frecuencia | Responsabilidad | | ------------------ | ----------- | -------------- | | Actualización de dependencias | Semanal | DevOps | | Auditorías de seguridad | Mensual | DevOps | | Lanzamientos de versión | Según sea necesario | Mantenedores | | Sincronización de documentación | Por lanzamiento | Colaboradores | --- ## Documentos Relacionados - [Arquitectura de Alto Nivel](./high-level-architecture.md) - [Sistema de Módulos](./module-system.md) - [Guía de Migración v2.0 a v4.0.4](../migration/migration-guide.md) - [Guía de Squads](../guides/squads-guide.md) --- _Última actualización: 2026-01-28 | Equipo del Marco AIOX_