> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés. # Buenas prácticas **Especificación del Meta-Universo** **ID del documento:** MU-V2-GUIDE-006 **Título:** Buenas prácticas **Clase de documento:** informativo **Versión:** 2.0 (borrador) **Estado:** borrador de trabajo **Referencias normativas:** MUC, MMAS, MUFP **Referencias informativas:** Design-Recommendations, Create-a-New-Meta-Model, Federation-Guide **Copyright:** © Orkestron.AI **Licencia:** Apache-2.0 --- # 1. Propósito Esta guía resume las prácticas recomendadas para diseñar, publicar y hacer evolucionar meta-modelos conformes al Meta-Universo. Las recomendaciones se derivan de los principios de MUC, MMAS y MUFP y constituyen orientación arquitectónica probada, no requisitos obligatorios. --- # 1a. Tres niveles de conocimiento El conocimiento del Meta-Universo existe en **tres niveles**, y esta guía ocupa el tercero. Distinguirlos aclara qué obliga, qué se recomienda y qué es solo criterio adquirido con la experiencia: - **Normativo**: *lo que hay que obedecer*. Los estándares mismos: MUC, MMAS y MUFP. La conformidad es obligatoria y verificable. - **Referencia**: *la arquitectura recomendada*. La arquitectura de referencia y los meta-modelos de dominio de referencia, que muestran una forma probada de aplicar los estándares. - **Buenas prácticas**: *cómo deciden en realidad quienes tienen experiencia*. Las heurísticas y costumbres acumuladas que usan los profesionales veteranos allí donde los estándares dejan margen al criterio. La analogía es cómo está documentada la Web. El **RFC de HTTP** define el protocolo (normativo); las **guías de arquitectura** muestran maneras recomendadas de construir sobre él (referencia); y las **recomendaciones prácticas** recogen cómo diseñan de verdad los sistemas reales quienes llevan años haciéndolo (buenas prácticas). Los tres hacen falta: el protocolo garantiza la interoperabilidad, la arquitectura muestra una forma probada y las prácticas transmiten una experiencia que ninguna especificación puede codificar del todo. Este documento es la tercera capa y nunca prevalece sobre la primera. --- # 2. Piensa en semántica, no en tecnología Modela siempre primero la realidad del negocio. DO: - identifica los conceptos; - identifica el significado; - define las relaciones. Evita modelar: - tablas de base de datos; - endpoints REST; - clases de programación; - estructuras de almacenamiento. La tecnología cambia más deprisa que la semántica. --- # 3. Prefiere modelos de dominio pequeños Crea meta-modelos de dominio enfocados. Buenos ejemplos: - Empleado - Organización - Producto - Cliente Evita los modelos universales grandes que intentan describir todos los dominios. La federación es preferible al modelado monolítico. --- # 4. Reutilizar antes que crear Antes de introducir un concepto nuevo: - busca en los Meta-modelos registrados; - repasa los estándares importados; - comprueba los Paquetes semánticos; - evalúa los Perfiles de federación. Reutiliza la semántica existente siempre que sea posible. --- # 5. Haz canónica la identidad Separa: - la Identidad canónica; - la Identidad local; - las Vinculaciones de identidad. La Identidad canónica se mantiene estable a lo largo de todo el ciclo de vida. --- # 6. Diseña relaciones explícitas Las relaciones conviene diseñarlas para que: - tengan nombres claros; - expresen significado de negocio; - sean trazables por sí mismas; - eviten la terminología de implementación. Unas buenas relaciones mejoran el razonamiento de la IA. --- # 7. Modela los sucesos de forma explícita Trata los Sucesos como artefactos semánticos de primera clase. Los cambios de negocio importantes generan Sucesos. Evita reconstruir la historia solo a partir del estado actual. --- # 8. Usa proyecciones en lugar de copias Nunca expongas los modelos internos directamente. Crea Perfiles de proyección apropiados para: - la audiencia; - el propósito; - la política de divulgación; - el Contexto. Compartir mediante Proyecciones reduce al mínimo la deriva semántica. --- # 9. Define siempre el contexto Toda Proyección e interacción define: - el propósito; - la audiencia; - los supuestos; - la visibilidad. El significado depende del Contexto. --- # 10. Preserva la procedencia Todo artefacto significativo preserva: - el origen; - el propietario; - la autoridad que lo publica; - la versión; - los Sucesos relacionados. La confianza depende de la procedencia. --- # 11. Diseña para la federación Da por supuesto que cualquier meta-modelo puede acabar participando en una federación. Prepara: - las Correspondencias semánticas; - las Vinculaciones de identidad; - los Contratos; - la estrategia de sincronización. La disposición para federar no debería ser una ocurrencia tardía. --- # 12. Versiona con prudencia Usa versionado semántico. Evita los cambios rompedores innecesarios. Mantén la compatibilidad siempre que sea practicable. La evolución preserva la continuidad semántica. --- # 13. Valida de forma continua La validación verifica: - el cumplimiento de MUC; - el cumplimiento de MMAS; - los nombres; - la trazabilidad; - el Contexto; - el diseño de las Proyecciones; - la compatibilidad. Automatiza la validación siempre que sea practicable. --- # 14. Conserva la historia Nunca reescribas la historia semántica. Prefiere: - Sucesos inmutables; - versiones archivadas; - evolución de solo adición. La historia aumenta la explicabilidad. --- # 15. Documenta para personas y para IA La documentación conviene mantenerla: - concisa; - estructurada; - legible por máquina donde sea practicable; - semánticamente coherente. Los repositorios los consumen tanto personas como agentes de IA. --- # 16. Publica metadatos completos Publica: - los estándares admitidos; - las versiones; - la compatibilidad; - la conformidad; - la gobernanza; - la licencia. Unos buenos metadatos mejoran el descubrimiento y la reutilización. --- # 17. Revisa con regularidad Repasa periódicamente: - la terminología; - las correspondencias; - los contratos; - las proyecciones; - los resultados de validación; - las declaraciones de compatibilidad. La mejora continua refuerza la interoperabilidad a largo plazo. --- # 18. Lista de comprobación de diseño Antes de publicar pregúntate: - ¿Está bien acotado el dominio? - ¿Es canónica la Identidad? - ¿Es explícito el Contexto? - ¿Están definidas las Proyecciones? - ¿Están completos los Sucesos? - ¿Se preserva la procedencia? - ¿Es posible la federación? - ¿Puede la IA entender el modelo? - ¿Puede el modelo evolucionar sin riesgo? --- # 19. Direcciones futuras A medida que crezca el cuerpo de experiencia práctica, la capa de Buenas prácticas podría consolidarse en un **Manual de arquitectura del Meta-Universo**: un compañero curado de los estándares normativos que reúna en un solo lugar patrones probados, antipatrones, ejemplos resueltos y heurísticas de decisión. Un manual así permanecería firmemente en el tercer nivel de conocimiento: explicaría *cómo deciden quienes tienen experiencia*, remitiría a la arquitectura de referencia y a las [Recomendaciones de diseño](Design-Recommendations.md), y nunca prevalecería sobre MUC, MMAS o MUFP. Sería el lugar donde el criterio acumulado de la comunidad queda escrito y se mantiene al día. --- # Declaración final Los meta-modelos logrados se diseñan en torno a conceptos semánticos estables y no a detalles de implementación pasajeros. Aplicando estas buenas prácticas de forma coherente, las organizaciones crean modelos semánticos reutilizables, explicables e interoperables que pueden evolucionar a lo largo de décadas, participar en federaciones y sostener tanto la colaboración humana como los sistemas de conocimiento nativos de IA sin comprometer identidad, confianza ni gobernanza.