> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés. # Repositorio de referencia **Especificación del Meta-Universo** **ID del documento:** MU-V2-REFARCH-006 **Título:** Ejemplo de repositorio estándar **Clase de documento:** informativo **Versión:** 2.0 (borrador) **Estado:** borrador de trabajo **Referencias normativas:** Constitución del Meta-Universo (MUC), MMAS, MUFP **Referencias informativas:** Architecture, Naming Examples **Copyright:** © Orkestron.AI **Licencia:** Apache-2.0 --- # 1. Propósito Este documento define la estructura de repositorio recomendada para las especificaciones, los meta-modelos de dominio y los paquetes semánticos conformes con el Meta-Universo. El repositorio de referencia aporta un modelo organizativo común que mejora la localizabilidad, la interoperabilidad, la gobernanza y la mantenibilidad a largo plazo. La estructura se recomienda como arquitectura de referencia, pero puede adaptarse cuando esté justificado, sin vulnerar MUC, MMAS ni MUFP. --- # 1a. El Meta-Universo como estándar de publicación de conocimiento El Meta-Universo no es solo una manera de *construir* modelos semánticos; es también un estándar para *publicarlos*. La familia de estándares reparte esa responsabilidad con nitidez: - **MMAS** define *cómo construir* los modelos: su arquitectura, su versionado y su validación. - **MUC** define *las leyes* que obedecen todo modelo y todo intercambio. - **MUFP** define *cómo interactúan los modelos* entre Universos soberanos. - **El repositorio de referencia** (este documento) define *cómo se publican los modelos*: la forma organizativa común en la que el conocimiento se hace localizable, verificable y federable. Esto refleja cómo otros ecosistemas separan la creación de la publicación. Git guarda la historia; GitHub publica el código. OpenAPI publica APIs. OCI publica contenedores. Con el mismo espíritu, **el Meta-Universo publica modelos semánticos**, y el repositorio de referencia es la disposición canónica que hace reconocible un modelo publicado para cualquier persona o agente de IA que se lo encuentre. Un repositorio organizado así es en sí mismo una especie de proyección del conocimiento que contiene: una superficie predecible que expone fundamentos, arquitectura, federación, conceptos fundamentales, modelos de dominio y guías en lugares conocidos, con metadatos conocidos, de modo que quien lo consume pueda navegar, validar y federar sin acuerdos previos. --- # 2. Principios de diseño Un repositorio conforme DEBERÍA ser: - legible por humanos; - legible por la IA; - nativo de Git; - modular; - versionado; - trazable; - extensible. La organización del repositorio DEBERÁ anteponer la claridad semántica a la comodidad de implementación. --- # 3. Estructura canónica del repositorio Estructura de primer nivel recomendada: ``` Repository/ ├── README.md ├── LICENSE ├── CHANGELOG.md ├── archive/ ├── 00-foundation/ ├── 01-constitution/ ├── 02-architecture/ ├── 03-federation/ ├── 04-core-concepts/ ├── 05-reference-architecture/ ├── 06-domain-models/ ├── 07-guides/ ├── examples/ └── schemas/ (optional) ``` PUEDEN introducirse directorios adicionales siempre que no alteren el significado semántico del repositorio. --- # 4. Responsabilidad de cada carpeta **archive/** Contiene versiones históricas conservadas por trazabilidad. **00-foundation/** Visión, principios, terminología y glosario. **01-constitution/** Documentos constitucionales normativos. **02-architecture/** Estándares de arquitectura (MMAS). **03-federation/** Especificaciones del protocolo de federación (MUFP). **04-core-concepts/** Conceptos semánticos fundacionales. **05-reference-architecture/** Arquitecturas de referencia y patrones arquitectónicos. **06-domain-models/** Meta-modelos de dominio reutilizables. **07-guides/** Guías informativas de implementación y migración. **examples/** Ejemplos ilustrativos que muestran la aplicación correcta de los estándares. --- # 5. Requisitos de los documentos Todo documento normativo DEBERÍA definir: - el identificador del documento; - el título; - la versión; - el estado; - la clasificación; - el propósito; - la declaración final. Los documentos DEBERÍAN seguir siendo comprensibles por separado. --- # 6. Convenciones de nomenclatura La nomenclatura del repositorio DEBERÍA seguir las convenciones de nomenclatura de MMAS. Los ficheros DEBERÍAN: - llevar nombres descriptivos; - evitar la ambigüedad; - permanecer estables entre versiones. Los nombres normativos de fichero NO DEBERÍAN incluir números de versión. --- # 7. Versionado La evolución del repositorio DEBERÁ seguir el versionado semántico. Las publicaciones históricas DEBERÍAN seguir disponibles. Los cambios estructurales rupturistas DEBERÁN ir acompañados de una nueva versión mayor. --- # 8. Trazabilidad Los artefactos del repositorio DEBERÁN conservar: - la procedencia; - la autoría; - el historial de versiones; - el linaje del documento; - los estándares relacionados. La trazabilidad DEBERÁ extenderse a toda la historia del repositorio. --- # 9. Extensibilidad Los repositorios PUEDEN incluir: - esquemas; - contratos; - plantillas; - recursos de validación; - artefactos generados; - recursos de automatización. Las extensiones DEBERÁN mantenerse semánticamente compatibles con la estructura de referencia. --- # 10. Validación Un repositorio conforme DEBERÍA validar: - las carpetas obligatorias; - los metadatos obligatorios; - los identificadores de documento; - la coherencia de la nomenclatura; - la coherencia de versiones; - las referencias cruzadas entre documentos. La validación DEBERÍA poder automatizarse. --- # 11. Gobernanza Todo repositorio DEBERÁ identificar: - la autoridad que lo gobierna; - el proceso de publicación; - las versiones del estándar que admite; - el nivel de conformidad. La gobernanza DEBERÁ permanecer transparente. --- # 12. Invariantes arquitectónicas Un repositorio conforme DEBERÁ preservar: - el cumplimiento constitucional; - la organización semántica; - la trazabilidad; - la modularidad; - la mantenibilidad a largo plazo. La estructura del repositorio DEBERÁ sostener la evolución semántica sin sacrificar la integridad histórica. --- # Direcciones futuras El repositorio de referencia describe cómo se dispone un solo repositorio. El paso natural siguiente es una **especificación de registro del Meta-Universo** que describa cómo los repositorios se *descubren y verifican a escala*, formando una federación de registros. Una especificación así permitiría a los agentes de IA: - descubrir automáticamente repositorios del Meta-Universo desde un punto de entrada de registro conocido; - detectar qué versiones de MUC, MMAS y MUFP admite cada repositorio; - verificar la conformidad de forma automática (carpetas obligatorias, metadatos, identificadores, nomenclatura y referencias cruzadas); - y, sobre esa base, construir federación entre repositorios sin configuración manual. Donde el repositorio de referencia hace reconocible un modelo publicado, la especificación de registro haría navegable *todo el ecosistema de modelos*: la diferencia entre una sola API publicada y un índice de todas las APIs publicadas que un agente puede consultar, validar y con las que puede conectarse por su cuenta. --- # Declaración final El repositorio de referencia define la organización canónica de los estándares y meta-modelos del Meta-Universo. Al adoptar una estructura de repositorio común, quienes publican permiten que personas y agentes de IA descubran, comprendan, validen y hagan evolucionar el conocimiento semántico de forma coherente entre repositorios independientes, preservando la gobernanza, la trazabilidad y la interoperabilidad en todo el ecosistema del Meta-Universo.