> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés. # Antipatrones **Especificación del Meta-Universo** **ID del documento:** MU-V2-REFARCH-007 **Título:** Errores de diseño habituales **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, Interaction Patterns, Federation Patterns **Copyright:** © Orkestron.AI **Licencia:** Apache-2.0 --- # 1. Propósito Este documento identifica los antipatrones arquitectónicos y semánticos que suelen aparecer al diseñar repositorios, meta-modelos y ecosistemas federados conformes con el Meta-Universo. Su propósito es ayudar a quienes diseñan a evitar decisiones que reducen la interoperabilidad, la trazabilidad, la explicabilidad o la capacidad de evolucionar a largo plazo. --- # 2. Filosofía de diseño Un antipatrón es una solución que se repite con frecuencia, parece razonable y, sin embargo, produce consecuencias indeseables a largo plazo. Los antipatrones aquí descritos son orientaciones informativas derivadas de los principios de MUC, MMAS y MUFP. --- # 2a. Los antipatrones como especificación negativa Un estándar maduro dice no solo qué hacer, sino qué *no* hacer. Este documento es la **especificación negativa** de la arquitectura del Meta-Universo: la frontera que define la arquitectura por su complemento. Es un recurso familiar en disciplinas asentadas. La práctica orientada a objetos tiene sus *code smells* y sus *antipatrones*. La arquitectura de microservicios advierte contra el *monolito distribuido* y la *base de datos compartida*. El diseño guiado por el dominio cataloga sus propias trampas. En todos los casos el catálogo negativo carga tanto peso como el positivo, porque recoge los errores que parecen razonables hasta que aflora su coste a largo plazo. Algunos antipatrones del Meta-Universo merecen destacarse en particular porque a quien se ha formado en sistemas clásicos le resultan *naturales y correctos*, y son por tanto los que con más probabilidad se reintroducen por costumbre: - **Copia en lugar de proyección** (sección 4). Los sistemas clásicos replican datos con libertad; en el Meta-Universo, copiar rompe la procedencia y provoca deriva semántica. El conocimiento se comparte por proyección, no por duplicación. - **Tratar la identidad local como global** (el antipatrón de identidad oculta, sección 7). Una clave primaria única dentro de una base de datos *no* es una identidad canónica. Reutilizar un identificador local como si fuera global rompe la federación y la resolución de identidades. - **Confianza por autenticación** (sección 15). "Quien llama se autenticó, luego puede recibir los datos" es un reflejo del control de acceso clásico. En el Meta-Universo la autenticación es necesaria pero nunca suficiente: la confianza, el propósito, el contexto y los contratos se evalúan de forma independiente. - **Un gran meta-modelo universal** (sección 13). El instinto de diseñar un esquema único para toda la empresa produce un monolito inmantenible. El Meta-Universo prefiere, en su lugar, meta-modelos de dominio pequeños y federados. Reconocer estos cuatro como antipatrones - y no como valores por defecto sensatos - es uno de los mayores cambios conceptuales para quien llega de arquitecturas clásicas. --- # 3. Antipatrón: múltiples fuentes de verdad Problema Varios objetos independientes se declaran autoritativos sobre el mismo concepto semántico. Consecuencias - ambigüedad de identidad; - conflictos de sincronización; - federación incoherente. Práctica recomendada Mantener un único meta-objeto autoritativo y distribuir proyecciones. --- # 4. Antipatrón: copia en lugar de proyección Problema El conocimiento se duplica en vez de proyectarse. Consecuencias - deriva semántica; - actualizaciones en conflicto; - pérdida de la procedencia. Práctica recomendada Intercambie proyecciones conscientes del contexto y regidas por contratos semánticos. --- # 5. Antipatrón: semántica implícita Problema El significado solo existe en la documentación o en la cabeza de quien programa. Consecuencias - interoperabilidad pobre; - la IA no puede razonar de forma fiable; - implementaciones incoherentes. Práctica recomendada Haga explícita la semántica mediante meta-modelos, relaciones y contexto. --- # 6. Antipatrón: modelos dirigidos por la tecnología Problema El modelo semántico refleja tablas de base de datos, APIs o detalles de implementación. Consecuencias - dependencia del proveedor; - reutilización pobre; - arquitectura inestable. Práctica recomendada Modele primero la realidad semántica y después la implementación. --- # 7. Antipatrón: identidad oculta Problema La identidad canónica falta o está sustituida por identificadores locales. Consecuencias - federación rota; - resolución de identidades imposible; - entidades duplicadas. Práctica recomendada Separe la identidad canónica de los identificadores operativos locales. --- # 8. Antipatrón: procedencia ausente Problema Los objetos no pueden explicar de dónde salieron. Consecuencias - menor confianza; - auditoría imposible; - razonamiento de IA poco fiable. Práctica recomendada Capture la procedencia como una propiedad de pleno derecho. --- # 9. Antipatrón: contexto ausente Problema El conocimiento se intercambia sin contexto explícito. Consecuencias - ambigüedad semántica; - interpretación incorrecta; - decisiones inválidas. Práctica recomendada Declare el contexto de forma explícita en cada proyección y cada interacción. --- # 10. Antipatrón: federación sin contratos Problema El conocimiento se intercambia sin contratos semánticos. Consecuencias - divulgación incontrolada; - fallos de gobernanza; - incertidumbre jurídica. Práctica recomendada Rija toda la federación mediante contratos explícitos. --- # 11. Antipatrón: resolución silenciosa de conflictos Problema Los conflictos se sobrescriben automáticamente sin dejar evidencia histórica. Consecuencias - pérdida de explicabilidad; - rastro de auditoría destruido; - errores semánticos ocultos. Práctica recomendada Registre los conflictos, resuélvalos de forma explícita y conserve la historia. --- # 12. Antipatrón: romper la historia Problema Se borran eventos, versiones o relaciones históricas. Consecuencias - pérdida de trazabilidad; - reconstrucción imposible; - fallos de gobernanza. Práctica recomendada Añada eventos nuevos en lugar de reescribir la historia. --- # 13. Antipatrón: gran meta-modelo universal Problema Un meta-modelo enorme intenta describir todos los dominios. Consecuencias - complejidad excesiva; - mantenibilidad pobre; - modularidad débil. Práctica recomendada Construya meta-modelos de dominio pequeños y reutilizables, conectados por federación. --- # 14. Antipatrón: correspondencias incrustadas en el código Problema Las correspondencias semánticas están embebidas en el código de la aplicación. Consecuencias - evolución cara; - semántica oculta; - reutilización baja. Práctica recomendada Trate las correspondencias semánticas como artefactos semánticos gobernados. --- # 15. Antipatrón: confianza por autenticación Problema La autenticación por sí sola se toma por autorización y por confianza semántica. Consecuencias - divulgación excesiva; - gobernanza débil; - supuestos injustificados. Práctica recomendada Evalúe la confianza, el propósito, el contexto y los contratos de forma independiente. --- # 16. Lista de comprobación arquitectónica Antes de publicar un meta-modelo, verifique: - ¿Hay una única fuente autoritativa? - ¿Es canónica la identidad? - ¿Es explícito el contexto? - ¿Se usan proyecciones en lugar de copias? - ¿Rigen contratos la divulgación? - ¿Se conserva la procedencia? - ¿Son inmutables los eventos? - ¿Puede reconstruirse la historia? - ¿Es explicable la federación? - ¿Puede la IA razonar sin supuestos ocultos? --- # Declaración final Los antipatrones del Meta-Universo recogen errores arquitectónicos recurrentes que degradan la calidad semántica y la interoperabilidad. Al reconocerlos y evitarlos, quienes diseñan pueden crear meta-modelos y ecosistemas federados que sigan siendo explicables, fiables y amigables con la evolución, preservando los principios constitucionales del Meta-Universo.