# Dile a los agentes dónde está tu cara para agentes

**Status:** Proposed · **Opened:** 2026-07-10

Las superficies de doble cara existen: los sitios publican portadas llms.txt, las apps exponen endpoints MCP, la documentación publica markdown literal junto a la página renderizada. Nosotros mismos publicamos varias. Pero nada le dice a un agente que llega que la cara para máquinas existe — en la web la convención es un nombre de archivo conocido que hay que adivinar, y en Nostr no hay nada. NIP-89 anuncia qué app puede *manejar* un kind; ningún evento anuncia dónde vive la representación nativa-para-agentes de una *superficie*. Así que los agentes raspan páginas humanas aun cuando una cara estructurada y verificada por hash está a una URL de distancia.

## La brecha

Descubrimiento. Las caras existen; el puntero no. Sin una convención, cada superficie de doble cara lo es solo para los agentes que ya la conocen — es decir, casi siempre los del propio constructor.

## Lo que estamos esbozando

Una convención pequeña de anuncio — probablemente adyacente a NIP-89 — que declara, para una superficie (un dominio, un naddr, una app): dónde viven sus caras para agentes (llms.txt, espejo markdown, índice de hashes, endpoint MCP) y qué habla cada una (contrato, versión, cobertura de idiomas — las etiquetas de la idea #1 aplican aquí también). La historia del cliente: resolver una superficie → buscar el anuncio → consumir la cara declarada; raspar queda degradado a plan B. Implementaciones de referencia antes que prosa: nuestras propias páginas anuncian sus caras, y una habilidad de MKStack empaqueta la convención para que las apps armadas con la plantilla la traigan por defecto.

## Por qué nosotros

Nuestras dos páginas públicas ya publican doble cara (página renderizada + md literal + llms.txt + sha256 por archivo), y construimos búsqueda que consume caras de agente entre superficies — somos el primer consumidor al que este puntero ausente le muerde. Publicar una cara que nadie encuentra es doble navegabilidad solo de nombre.

## Recibos

- [llms.txt](https://llmstxt.org) — la convención de portada del lado web que esto extiende más allá de nombres adivinables
- [NIP-89: Recommended Application Handlers](https://github.com/nostr-protocol/nips/blob/master/89.md) — la forma de anuncio adyacente
- [Model Context Protocol](https://modelcontextprotocol.io) — la cara de consulta en vivo que los agentes ya hablan
- Las caras de este mismo sitio — [/manual/llms.txt](/manual/llms.txt) + [/manual/index.json](/manual/index.json), lo que un anuncio señalaría