hiddenrows

Guías prácticas para trabajar con agentes de IA, con un laboratorio al final de cada una

última edición=16 de octubre · 24 piezas · 14 breves
regla=solo lo verificado como hecho
llamadas a un modelo por visita=0
Protocolos

La diferencia entre pedirle algo al agente e impedírselo

Lo que tiene que cumplirse siempre no se escribe en un fichero de normas: se programa. Separar lo que se pide de lo que se impone es la primera decisión seria al montar un agente.

2 min de lectura publicado el 24 sept 2026

La idea

Las normas del proyecto se suelen escribir en un fichero de texto, un AGENTS.md, que el agente lee antes de ponerse a trabajar. El problema es que eso es solo texto: el modelo lo lee y casi siempre lo cumple, pero puede no hacerlo, y además ese fichero compite por el sitio con todo lo demás que tiene que leer.

Un hook es otra cosa: código tuyo que el programa ejecuta siempre en un momento fijo —antes de usar una herramienta, al terminar, al resumir la sesión— y que puede cortar la acción antes de que ocurra. No depende de que el modelo quiera hacerte caso. La documentación de Claude Code marca la diferencia con dos palabras: las normas del fichero son orientativas; los hooks se cumplen siempre.

Los datos que lo sostienen
  • V Claude Code incorporó los hooks en junio de 2025, y desde entonces Codex, Cursor y Copilot tienen su equivalente. Ya no es una particularidad de una herramienta.
  • V El fichero de normas AGENTS.md lo usan más de 60.000 proyectos, según quienes lo promueven, y desde diciembre de 2025 lo gestiona una fundación del sector. Claude Code lo lee por su cuenta desde la versión 2.1.277, siempre que el proyecto no tenga además un CLAUDE.md: si están los dos, gana el CLAUDE.md. Hasta esa versión había que importarlo a mano, y así estuvo escrito aquí.
  • V Sobre si conviene escribir mucho en ese fichero, la evidencia se contradice: un estudio de la ETH de Zúrich mide un 20 % más de coste sin que mejore el resultado, y otro mide un 28 % menos de tiempo de ejecución. I Mientras no se aclare, la prudencia es escribir poco y comprobarlo en tu caso.
  • O Mitchell Hashimoto, creador de Ghostty y de Terraform, explica así el suyo: cada línea del fichero está ahí porque un agente se portó mal antes. No es documentación, es una lista de cicatrices.
  • I La regla práctica. Si incumplirlo tiene consecuencias de verdad —claves, borrados, despliegues—, hook. Si es cuestión de estilo o de preferencia, una línea en el fichero de normas y a otra cosa.
hiddenrows · proyecto personal de divulgación de Miguel Yepes Contenido divulgativo, puede contener errores · sin garantías · Aviso legal · Privacidad · llms.txt