derive-instead-of-transcribing
Todo lo copiado a mano desde otro archivo es correcto exactamente una vez. Si se puede generar, genéralo, y haz fallar la compilación cuando la copia quede desactualizada.
Conferida por quien revisó y leyó la tarjeta, no reclamada por el propio archivo. Una tarjeta que el agente destila durante una ejecución que consumió contenido no confiable nace contaminada y queda retenida para revisión antes de ser recuperada.
Cuándo viene a la mente
- documentando una lista de comandos
- copiando valores entre proyectos
- manteniendo dos archivos sincronizados
- escribiendo una página de referencia
Evita y Comprueba es donde suele estar el valor. Haz es la sección que todo el mundo escribe.
El cuerpo de la tarjeta de arriba es una traducción. El original en inglés es lo que importa la CLI, lo que lee el agente en ejecución y lo que atestigua el hash de abajo.
Disparador
Dos lugares en tu sistema contienen la misma información: una configuración y su documentación, un esquema y sus tipos de cliente, una paleta y el sitio que la usa, una lista de comandos y una página de referencia.
No aplica cuando la segunda copia es deliberadamente distinta — una guía de inicio curada no es una copia desactualizada de la referencia, es prosa con un propósito diferente.
Haz
- Elige cuál es la fuente. Normalmente la que el programa realmente lee en tiempo de ejecución.
- Genera la otra, haciendo commit del archivo generado para que los diffs sean revisables.
- Añade un paso de CI que regenere y falle si la copia con commit difiere, con el comando exacto a ejecutar en el mensaje de error.
- Marca el archivo generado con la versión o el commit del que fue generado, para que un lector sepa qué describe.
Evita
Mantener la copia sincronizada de memoria. Eso funciona mientras una persona tenga ambos archivos en la cabeza, y deja de funcionar la primera semana que alguien más toque uno de ellos.
Evita también la versión a medias: generar el archivo pero no bloquearlo con una compuerta. Un artefacto que a veces se regenera es peor que uno escrito a mano, porque lleva la autoridad de haber sido generado mientras está igual de desactualizado.
Y evita generar prosa. El material de referencia se genera bien; la explicación no, y una página de descripciones de campos expandidas mecánicamente es una página que nadie lee.
Comprueba
Cambia la fuente, no regeneres, y haz push. CI debe ponerse en rojo y decirte qué ejecutar.
Luego lee el archivo generado buscando lo que cambiaste y confirma que está ahí — la compuerta prueba que el archivo está actualizado, no que el generador capturó el campo que te importa.
Riesgo
Un artefacto generado que nadie puede leer anula el propósito; si la salida solo tiene sentido para una máquina, necesita una capa de renderizado, lo cual es más código que mantener.
También hay un costo de acoplamiento. El consumidor ahora depende de la forma del productor, y un refactor de un lado rompe un build del otro. Ese suele ser justamente el punto — pero significa que la compuerta debe ser fácil de satisfacer, o alguien la deshabilitará durante un refactor no relacionado y lo olvidará.
Cómo usarla
La tarjeta es un dato. Clona el repositorio e impórtala por ruta: lo que llega por la red se trata como contaminado y queda retenido a la espera de aprobación, que es el comportamiento deseable y la razón por la que aquí no hay un instalador de una línea.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/derive-instead-of-transcribing/SKILL.mdIntegridad
SHA-256 del archivo tal como se publicó. Quien lo importe puede comprobar que lo que recibió es lo que mostró esta página.
8b9a25705790b36bd8b04294161cac342e63b667c0e6a6e36240d981687f35f9