# Cómo lee un modelo un agente

*Vercy para agentes de IA · lección 1 de 4 · ~10 min*

## Qué aprenderá

El protocolo de arranque en frío: qué hace un agente en los primeros cinco minutos con un modelo conforme que no ha visto nunca.

## Por qué los agentes tienen un protocolo

Un agente apuntado a un repositorio desconocido afronta los mismos riesgos que una persona, amplificados: lee deprisa, se salta cosas en silencio y responde con confianza. La respuesta del estándar es que un modelo conforme *le dice cómo leerlo*, y el primer deber de un agente es aceptar la oferta en vez de improvisar.

## La secuencia de arranque en frío

1. **Primero `BOOTSTRAP.md`.** Cómo quiere ser leído este modelo, convenciones locales, prohibiciones duras. Si el ecosistema tiene su propio archivo de entrada (`CLAUDE.md`, `AGENTS.md`), léalo después: ese lleva estado operativo; BOOTSTRAP lleva estructura.
2. **`manifest.yaml`.** Identidad, paquetes ordenados, reglas de clasificación, exclusiones. Ahora sabe qué *es* cada archivo antes de abrir ninguno.
3. **`sources.yaml`.** Qué conjuntos de datos tienen aquí su maestro, cuáles son espejos, con qué frescura, quién gana los conflictos. Léalo *antes que el contenido*: si no, no podrá distinguir el conocimiento autorizado de una copia rancia de la wiki de alguien.
4. **Recorra en el orden declarado.** Paquetes con los fundamentos primero, capas en orden, README de la capa antes que los registros. El orden es orden de dependencia: las definiciones llegan antes que su uso.
5. **Ejecute el recorredor si existe** (`tools/mu-walk*`). Un recorrido en rojo significa que el propio mapa del modelo está roto: informe de ello antes de confiar en nada.

Toda la secuencia son tres archivos pequeños y un comando antes de cualquier contenido: un seguro barato contra todos los errores posteriores.

## Responder con conciencia de autoridad

Al responder desde el modelo, un agente resuelve las afirmaciones hasta los registros y comprueba el conjunto de datos de cada registro contra el registro de fuentes:

- **Maestro en el modelo** → responda sin rodeos; esta es la verdad por declaración.
- **Espejo, fresco** → responda nombrando al maestro: "según la wiki de operaciones, recolectada el 2026-07-30".
- **Espejo, rancio** → dígalo; es preferible disparar una nueva recolección que adivinar.
- **`status: declared`** → es una intención, no datos; nunca lo presente como hecho.
- **`status: retired`** → historia congelada: "a fecha de la exportación final", nunca estado actual.

Y una distinción que evita disparates sutiles: una captura en `raw/` es evidencia de *lo que dijo una fuente*; un registro es *la afirmación propia del modelo*. Pueden discrepar deliberadamente (el modelo puede sostener una desviación anotada); cite en consecuencia.

## Qué gana todo el mundo con esto

Un equipo humano obtiene agentes que nunca confunden una maqueta con una especificación ni la exportación de un gestor muerto con un backlog vivo. El agente obtiene algo más raro: la capacidad de *demostrar* que su lectura fue completa: la comprobación de cobertura nombra todos los archivos que no leyó, y por qué.

## Ideas clave

- Arranque en frío: BOOTSTRAP → manifiesto → sources → recorrido ordenado → recorredor; y solo entonces, contenido.
- Toda respuesta lleva contexto de autoridad: con maestro propio, espejada (con qué frescura), declarada o retirada.
- La evidencia (`raw/`) y las afirmaciones (registros) son actos de habla distintos; no los mezcle.

## Profundizar

- [Guía de operaciones del agente](/spec/#07-guides/Agent-Operations.md) (la versión normativa de esta lección)
- [Recorrido del modelo (ARCH-017)](/spec/#02-architecture/Model-Traversal-and-Layout.md)

Siguiente: [Reglas de escritura](02-writing.md)