# Reglas de escritura

*Vercy para agentes de IA · lección 2 de 4 · ~12 min*

## Qué aprenderá

Las reglas que permiten a los agentes escribir en conocimiento compartido sin corromperlo: solo en el maestro, respetando los orígenes, manteniendo el recorrido en verde, y sabiendo cuándo negarse.

## La directiva primera: escriba en el maestro

Antes de cualquier escritura, busque el conjunto de datos en `sources.yaml`:

- **Maestro en el modelo** → edite el registro en su sitio, siguiendo las convenciones del modelo (nombres, front matter, `kind_class`), y marque la derivación con honestidad si produjo contenido a partir de fuentes.
- **Maestro externo** → la corrección pertenece al sistema externo. Si no puede alcanzarlo, entregue la corrección a quien pueda, o regístrela como una anotación claramente marcada, con maestro en el modelo, *sobre* el espejo. Nunca edite los bytes del espejo: la comodidad no es autoridad.

Escribir en una copia es corrupción aunque sea más rápido, aunque la copia sea lo que el usuario está mirando, aunque usted esté seguro. El registro existe para que "¿dónde va este arreglo?" tenga una respuesta mecánica.

## Respete los orígenes

- Nunca edite a mano `raw/` (la evidencia pierde su valor al tocarla) ni `artifacts/` (la regeneración le borrará).
- Nunca "mejore" hechos mientras recolecta: las transformaciones reestructuran; el enriquecimiento es una capa aparte, con maestro en el modelo y con su propia procedencia.
- Si una proyección generada está mal, arregle el generador o los registros de origen y luego regenere.

## Deje el recorrido en verde

Añadir, mover o borrar archivos cambia el mapa del modelo. Tras cambios estructurales: vuelva a ejecutar el recorredor de cobertura y confirme el informe nuevo. Si su archivo nuevo es un huérfano, el arreglo es una *regla* (amplíe la clasificación del manifiesto) o una *ubicación* (póngalo donde corresponde), nunca una exclusión: excluir contenido semántico para acallar la comprobación no es conforme, y el siguiente agente heredará su mentira.

La misma disciplina para los registros: conjunto de datos nuevo, pipeline cambiado, titularidad cambiada → `sources.yaml` se actualiza en el mismo cambio. Los cambios de titularidad son eventos versionados, no ediciones silenciosas.

## Cierre el círculo en las proyecciones

Si el modelo alimenta proyecciones de escritura de vuelta (un sitio, una página de wiki, un endpoint de hechos), su edición puede haberlas dejado rancias. Ejecute la comprobación de desviación del modelo; vuelva a publicar si informa de desviación. En instalaciones maduras hay un vigilante programado que avisa a una persona de todos modos: su trabajo es no depender de él.

## Cuándo negarse

Un agente conforme se niega a escribir, y dice por qué, cuando:

- no puede determinarse el maestro del conjunto de datos (entrada de registro ausente o ambigua);
- se le pide editar en su sitio un espejo, una captura cruda o un artefacto generado;
- se le pide ocultar contenido a la clasificación o saltarse el recorrido;
- la comprobación de cobertura falla y el cambio solicitado se apoya en la zona sin clasificar;
- la regla de conflicto de un conjunto de datos prohíbe la divulgación o el cambio (propietario, no publicar nunca).

La formulación del estándar es tajante: *un agente que no puede saber qué le está permitido editar no debe editar*. Negarse con un motivo es una funcionalidad; la alternativa son dos verdades con su nombre en el commit.

## Etiqueta en equipos mixtos

- Prefiera añadir un registro a reescribir uno; mantenga estables los identificadores de registro.
- El conocimiento sobre estructura y autoridad va a BOOTSTRAP, al manifiesto y al registro, no a los logs del chat.
- El trabajo derivado lleva procedencia: de qué, con qué herramienta, cuándo: de ello depende la maquinaria de confianza del modelo (estado de validación, revisión del propietario).
- Entregue en verde: nunca termine una sesión con un recorrido en rojo o un registro que no diga la verdad.

## Ideas clave

- Encuentre al maestro y escriba solo ahí; respete las fronteras entre autoría, recolectado y generado.
- Los cambios estructurales y las actualizaciones del registro viajan en el mismo cambio; el recorrido sigue en verde.
- Negarse a una escritura insegura, con el motivo, es comportamiento conforme, no un fallo.

## Profundizar

- [Operaciones del agente: recetas y negativas](/spec/#07-guides/Agent-Operations.md)
- [Titularidad de los datos (ARCH-018)](/spec/#02-architecture/Data-Mastership.md)

Siguiente: [El hub para máquinas](03-machine-hub.md)