Leer la publicación de Marcos Hernanz en X
Un reel de @ii.systema dice que un desarrollador quemó 60 mil millones de tokens y luego publicó el archivo de reglas que usa para programar con IA. Según el reel, el archivo hace que el modelo busque soluciones simples, lea la documentación y ahorre tus límites de uso.
El desarrollador es Marcos Hernanz. Trabajó en Next.js en Vercel. El 2 de agosto de 2026 publicó en X: «After doing ~60B tokens, this is my full AGENTS.md». La publicación mostraba siete reglas. Unas horas después respondió con una octava, bajo las palabras «Almost forgot».
Qué es un AGENTS.md
AGENTS.md es un archivo de texto simple en la carpeta principal de un proyecto. Los agentes de código lo leen antes de empezar, así que escribes tus reglas una vez en lugar de en cada chat. Claude Code lo lee cuando el proyecto no tiene un archivo CLAUDE.md.
Las ocho reglas, en palabras simples
- No mantengas vivo el código viejo. Cuando algo se reemplaza, borra el camino antiguo. No añadas alternativas ni capas para que siga funcionando.
- Elige la solución más simple que haga todo el trabajo hoy. No añadas ajustes ni capas «por si acaso».
- Crece en pasos pequeños. Primero construye la versión más pequeña que funcione de principio a fin. Luego añade una función a la vez sobre algo que ya funciona.
- Mantén las partes separadas. Cada parte hace un solo trabajo.
- Usa una biblioteca buena y conocida cuando haga las cosas más simples o más fiables. No reescribas funciones comunes sin un motivo.
- Revisa lo que el proyecto ya tiene antes de añadir un paquete o escribir tu propio código. Lee la documentación y los tipos de la biblioteca antes de decidir que no puede hacer algo.
- Decide a largo plazo. Nada de arreglos rápidos pensados para tirarse después.
- Antes de diseñar algo, mira cómo resuelven el mismo problema los buenos productos consolidados. Copia sus patrones probados en lugar de inventar los tuyos.
Por qué puede ahorrar tokens
La mayoría de estas reglas le piden al agente que escriba menos: sin capas extra, sin copias de bibliotecas, sin código guardado solo para versiones viejas. Menos código significa menos que leer, arreglar y explicar en el siguiente turno. La regla seis es la que el reel llama «leer la documentación». Marcos no da ninguna cifra de cuántos tokens ahorra el archivo.
Una advertencia del autor
Marcos añadió una nota bajo su publicación: solo usa este archivo para proyectos personales, y no deberías usarlo en producción si no quieres destruir tu código. La primera regla es la arriesgada. En un producto real, borrar caminos antiguos puede romperles las cosas a usuarios que todavía los necesitan.
Cómo usarlo
Crea un archivo llamado AGENTS.md en la carpeta principal de tu proyecto. Copia las ocho reglas de sus dos publicaciones y cambia cualquier regla que no encaje con tu proyecto. Si usas Claude Code y ya tienes un CLAUDE.md, añádele una línea para que Claude lea los dos:
@AGENTS.md