> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés. # Ejemplos de nomenclatura **Especificación del Meta-Universo** **ID del documento:** MU-V2-REFARCH-008 **Título:** Ejemplos de nomenclatura **Clase de documento:** informativo **Versión:** 2.0 (borrador) **Estado:** borrador de trabajo **Referencias normativas:** MMAS (convenciones de nomenclatura) **Referencias informativas:** Reference Repository, Anti-Patterns **Copyright:** © Orkestron.AI **Licencia:** Apache-2.0 --- # 1. Propósito Este documento ofrece ejemplos ilustrativos de nomenclatura para repositorios, meta-modelos y artefactos semánticos conformes con el Meta-Universo. Complementa la especificación normativa de convenciones de nomenclatura mostrando con ejemplos concretos las prácticas recomendadas. --- # 2. Principios de diseño Los nombres DEBERÍAN ser: - claros; - estables; - legibles por humanos; - legibles por la IA; - independientes de la tecnología; - semánticamente significativos. Los nombres DEBERÍAN describir conceptos y no implementaciones. --- # 3. Nombres de repositorio Recomendado: - employee-meta-model - product-meta-model - software-meta-model - organization-meta-model - healthcare-meta-model Evitar: - model-v2-final - temp-repository - test123 - new-model --- # 4. Nombres de carpeta Recomendado: - 00-foundation - 01-constitution - 02-architecture - 03-federation - 04-core-concepts - 05-reference-architecture - 06-domain-models - 07-guides - examples Evitar: - misc - docs2 - stuff - temp --- # 5. Nombres de documento Recomendado: - Employee.md - Organization.md - Projection.md - Semantic-Mapping.md - Federation-Contracts.md Evitar: - employee_final_v3.md - new_file.md - draft2.md Los nombres normativos de fichero DEBERÍAN permanecer estables entre versiones. --- # 6. Ejemplos de espacio de nombres Recomendado: - employee - organization - finance - healthcare - ai-agent - software Ejemplos cualificados: - employee:Employee - employee:Skill - organization:Department - product:Product - software:Service --- # 7. Ejemplos de objeto Nombres de objeto recomendados: - Employee - Department - Product - Customer - Invoice - Contract - Service - AIAgent Los nombres de objeto DEBERÍAN representar conceptos de negocio. --- # 8. Ejemplos de relación Recomendado: - reportsTo - memberOf - owns - assignedTo - dependsOn - implements - supervises - belongsTo Los nombres de relación DEBERÍAN expresar el significado semántico. --- # 9. Ejemplos de evento Recomendado: - EmployeeCreated - ContractApproved - ProjectionPublished - IdentityBound - FederationEstablished - SynchronizationCompleted Los eventos DEBERÍAN describir sucesos ya consumados. --- # 10. Ejemplos de proyección Nombres de proyección recomendados: - EmployeePublicProjection - EmployeeHRProjection - EmployeePayrollProjection - ProductCatalogProjection - IncidentSummaryProjection Los nombres de proyección DEBERÍAN indicar el contexto. --- # 11. Ejemplos de contrato Recomendado: - EmployeeDisclosureContract - HRFederationContract - ProductExchangeContract - AIAgentCapabilityContract Los nombres de contrato DEBERÍAN indicar el propósito. --- # 12. Ejemplos de identidad Identidad canónica: employee:550e8400-e29b-41d4-a716-446655440000 Identidad local: HR-10245 Vínculo: employee:550e8400... ↔ HR-10245 La identidad canónica DEBERÍA permanecer globalmente estable. --- # 13. Ejemplos de versión Recomendado: - 1.0.0 - 1.2.1 - 2.0.0 Evitar: - final - latest - vNext DEBERÍA emplearse versionado semántico. --- # 14. Ejemplo completo de nomenclatura Repositorio: employee-meta-model Espacio de nombres: employee Objeto: Employee Relación: reportsTo Proyección: EmployeeHRProjection Contrato: EmployeeDisclosureContract Evento: EmployeePromoted Esta secuencia de nombres muestra una nomenclatura semántica coherente a través de las capas arquitectónicas. --- # 15. Lista de comprobación arquitectónica Antes de publicar: - ¿Es estable el nombre? - ¿Es independiente de la tecnología? - ¿Es semánticamente significativo? - ¿Se entiende sin conocer la implementación? - ¿Es coherente con las convenciones de nomenclatura de MMAS? --- # 16. Hacia una guía de estilo semántico Los ejemplos de este documento tratan la *nomenclatura*, pero nombrar es solo una faceta de la coherencia estilística. Igual que la *Google Java Style Guide* rige mucho más que los nombres de identificador - cubre disposición, comentarios, modismos y fraseo uniforme para que miles de personas escriban código que se lee como si lo hubiera producido una sola - al Meta-Universo le conviene una única **guía de estilo semántico** que rija cómo se *escriben* los modelos semánticos, y no solo cómo se nombran. Una guía de estilo semántico estandarizaría, en un solo lugar: - Las **reglas de nomenclatura**: las convenciones ilustradas a lo largo de este documento (repositorios, espacios de nombres, objetos, relaciones, eventos, proyecciones, contratos, identidades, versiones). - Las **reglas de descripción de entidades**: cómo se describe un objeto, una relación o un evento, en qué orden y con qué nivel de detalle. - El **fraseo uniforme**: una voz y una forma de frase coherentes para las definiciones, de modo que las descripciones se lean igual en miles de modelos redactados de forma independiente. - Las **convenciones de relaciones y eventos**: formas verbales para las relaciones (`reportsTo`, `dependsOn`) y formas de pasado consumado para los eventos (`EmployeePromoted`, `ContractApproved`). - El **estilo de la declaración final**: una forma de cierre coherente para todo documento. - **Propósito / alcance / principios uniformes**: una estructura inicial compartida, para que cada documento presente su propósito, su alcance y sus principios de diseño de la misma manera reconocible. - Las **recomendaciones para meta-modelos de dominio**: el estilo de la casa para ensamblar un modelo de dominio completo a partir de esas piezas. El objetivo es una *uniformidad apta para la fusión automática*: cuando miles de organizaciones publican modelos semánticos con un estilo coherente, los agentes de IA pueden entenderlos, analizarlos, compararlos y fusionarlos con mucha más fiabilidad que si cada editor inventara su propio fraseo. La coherencia de estilo no es cosmética: para un ecosistema nativo de IA es una condición previa del razonamiento automatizado entre modelos. --- # Direcciones futuras Se espera que la **guía de estilo semántico** descrita arriba crezca hasta convertirse en un compañero informativo independiente de las convenciones normativas de nomenclatura: el equivalente en el Meta-Universo de una guía de estilo de un idioma, que cubra nomenclatura, descripción, fraseo, convenciones de relaciones y eventos, estructura del documento y forma de la declaración final. Su medida de éxito es sencilla: dos organizaciones cualesquiera que la siguieran producirían modelos que un agente de IA podría leer, analizar y fusionar como si vinieran de una sola autoría. --- # Declaración final Una nomenclatura coherente es esencial para la interoperabilidad semántica a largo plazo. Al aplicar nombres estables, significativos e independientes de la tecnología, las implementaciones del Meta-Universo resultan más fáciles de entender, validar, federar y hacer evolucionar, tanto para personas como para agentes de IA, preservando la claridad semántica entre repositorios y dominios.