> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés.

# AGENTS.md - leer el Meta-Universo como agente de IA

Este fichero es el punto de entrada para un agente de IA (o cualquier
herramienta automatizada) que ingiera este repositorio. Te dice qué leer primero
y qué artefactos son legibles por máquina.

## Qué es esto

El Meta-Universo es una **familia de estándares abiertos** para sistemas
semánticos federados: cómo "universos" de significado independientes describen la
realidad, construyen meta-modelos y federan conocimiento preservando identidad,
contexto, propiedad, confianza y trazabilidad. Es una especificación, no un
runtime.

## Lee en este orden

1. **`spec-index.yaml`**: el índice legible por máquina de todos los documentos
   (id, clase, estado, ruta). Empieza aquí para enumerar la especificación.
2. **`00-foundation/Terminology.md`**: el vocabulario normativo. Resuelve los
   términos aquí, no a partir de la prosa.
3. **`01-constitution/Meta-Universe-Constitution.md`**: las leyes fundamentales
   (21 artículos). Cada afirmación normativa tiene un ID (`MUC-Rnn`).
4. **`REQUIREMENTS-INDEX.md`**: todos los requisitos RFC 2119 de todos los
   documentos normativos, con ID estables. Cita esos ID.
5. **`02-architecture/MMAS-Interchange.md`** + **`schemas/`**: la serialización
   MUIF y los JSON Schema; la cara concreta y validable del modelo.
6. **`03-federation/MUFP-Messages.md`**: el protocolo de cable (sobres, máquina
   de estados, errores) para federar.

## Artefactos legibles por máquina

| Artefacto | Para qué |
|----------|-----|
| `spec-index.yaml` | Enumerar los documentos y su estado. |
| `schemas/*.schema.json` | Validar modelos MUIF, sobres MUFP, documentos de descubrimiento e informes de validación (JSON Schema 2020-12). |
| `REQUIREMENTS-INDEX.md` | Dirigirse a requisitos normativos concretos por su ID. |
| `mu-fingerprint` (véase `tools/`) | Calcular la Huella semántica reproducible de un modelo. |
| `mu-validate` (véase `tools/`) | Validar un modelo MUIF contra las comprobaciones V0-V2. |
| `/.well-known/meta-universe.json` | El documento de descubrimiento de un Universo (véase `examples/well-known/`). |

## Ejemplos resueltos

- `examples/minimal-person/`: el modelo más pequeño y la reproducibilidad de la huella.
- `examples/federation-acme-govtax/`: dos universos federando de principio a fin.
- `examples/federation-handshake/`: una transcripción de mensajes MUFP.
- `examples/interop/`: correspondencias con RDF/OWL, Schema.org, FHIR, FOAF.

## Trabajar SOBRE un modelo conforme (no sobre este repositorio de la especificación)

Si te apuntaron a un *repositorio de modelo* (tiene `BOOTSTRAP.md`,
`manifest.yaml`, `sources.yaml`), tus instrucciones de operación son
**`07-guides/Agent-Operations.md`**: lee BOOTSTRAP → manifiesto → fuentes antes
que el contenido; recorre los paquetes en el orden declarado; escribe **solo** en
el maestro declarado del conjunto de datos; nunca edites a mano `raw/`, los
espejos ni `artifacts/`; vuelve a ejecutar el recorredor de cobertura tras
cambios estructurales; niégate a escribir cuando la maestría no esté declarada.
El mapa conectado y legible por personas de todo el estándar es
**`00-foundation/Overview.md`**.

## Construir un agente sobre el Meta-Universo

Véanse **`07-guides/AI-Integration-Patterns.md`** y
**`07-guides/AI-Agent-Guide.md`**: carga los meta-modelos como esquemas de
herramientas, recupera significado mediante Proyecciones y Sucesos (no filas
crudas), aplica un Contrato semántico ejecutable dentro del bucle y produce
resultados trazables.

## Reglas de trato

- Trata **Terminología** y la **Constitución** como autoritativas; no infieras
  significado normativo de la prosa informativa.
- Un modelo "significa lo mismo" si y solo si su **Huella semántica** coincide.
- Nunca tomes la localizabilidad del esquema por acceso a los datos.