# §2 — Descubrimiento — manifiesto y registro

Cabuya 0.1 · Normativa

Canonical: https://cabuya.org/es/developers/spec/0.1/2-discovery
Language: es

> Esta página es la traducción al español, y es informativa: donde las dos difieran, rige el texto en inglés. Está versionada junto a la sección que traduce, así que cambiar una sin la otra se ve en la revisión.

---


# §2 — Descubrimiento

**§2.1** Un publicador MUST exponer un **manifiesto**: un documento JSON que
cumpla con
[`manifest.schema.json`](https://cabuya.org/schemas/0.1/manifest.schema.json).

**§2.2 Ubicación.** RECOMMENDED en `/.well-known/cabuya.json`. ACCEPTABLE:
cualquier ruta HTTPS estable declarada en la entrada del registro y anunciada
con `<link rel="cabuya" href="…">` en el head HTML del sitio. La entrada del
registro es el puntero autoritativo; la ruta conocida es la convención.
(Algunos hostings de voluntarios maltratan los directorios que empiezan por
punto — la ruta conocida nunca es un MUST.)

**§2.3 Contenido.** El manifiesto lleva: `protocol` (nombre y `spec_version`),
`publisher{}` (`publisher_id` del registro, URL canónica, alias declarados,
contacto institucional), `conformance_target` (L0–L4), `feeds[]`
(`{name, url, entity, profile}` — al estilo del autodescubrimiento), `api{}`
(URL base si es L3 o superior), `mcp{}` (endpoint, si existe), `license`,
`permitted_use[]`, `crawl_policy_url`, `events[]` (identificadores de eventos
del registro que sirve) y `languages[]` (BCP 47).

**§2.4 Registro.** Una colección de entradas de publicadores versionada en
git, actualizada por pull request con revisión humana. Las claves son **la URL
canónica más los alias declarados, nunca slugs** (una misma aplicación ha
salido a producción bajo tres nombres). El registro anota la política de
rastreo y reutilización de cada publicador; **las herramientas — la skill para
agentes incluida — MUST respetarla**: nada de descargar de un publicador cuya
política se reserva la reutilización.

**§2.5 Por qué los dos mecanismos.** Una caída del registro no debe romper las
lecturas entre publicadores (por eso existen las rutas conocidas); las SPA con
catch-all y las limitaciones de hosting impiden una regla de solo ruta conocida
(2 de 20 hostings observados no podían servirla honestamente). Los dos, cada
uno haciendo aquello en lo que es bueno.

---

## Navegación del Sitio

- [Inicio](https://cabuya.org/es)
- [Especificación](https://cabuya.org/es/developers/spec)
- [Esquemas](https://cabuya.org/es/developers/schemas)
- [RFCs](https://cabuya.org/es/rfcs)
- [Cambios](https://cabuya.org/es/changelog)
- [Desarrolladores](https://cabuya.org/es/developers)
- [Registro](https://cabuya.org/es/registry)
- [Gobernanza](https://cabuya.org/es/governance)
- [Participar](https://cabuya.org/es/join)
- [GitHub](https://github.com/Cabuya)
- [Repositorio de la skill](https://github.com/Cabuya/cabuya-skill)
- [Registro fundacional](https://github.com/Cabuya/cabuya.org/tree/main/docs/context)