El problema que todos tenemos (y nadie comenta)
Seguro que te ha pasado: estás programando, le pides ayuda a tu IA favorita y… te suelta un código que parece escrito por alguien que no conoce tu proyecto. Comentarios por todos lados cuando tú no los quieres, un naming de métodos raro, dependencias obsoletas que llevan sin usarse desde 2019, y un montón de cositas que te hacen pensar “esto lo tengo que arreglar yo, ¿no?“.
Y claro, cada vez que le pides algo nuevo, vuelta a empezar: “oye, sin comentarios”, “usa camelCase”, “prefiero usar esta librería en vez de esa otra”. Es agotador.
Pues amigos, esto se acabó. Hoy os traigo AGENTS.MD, un simple archivo que va a revolucionar vuestra forma de programar con IA.
Por qué necesitas AGENTS.MD en tu vida
Apoyarse en la inteligencia artificial para programar ya no es ciencia ficción, es una realidad. Pero si vamos a hacerlo, hagámoslo bien. No vale con preguntarle cositas a un chat o usar tu editor con IA y cruzar los dedos.
Para ser realmente eficientes necesitamos aplicar las nuevas metodologías que van saliendo (y sí, ya sé que en programación todo cambia cada dos días, pero para eso estoy yo, para traeros lo importante).
En posts anteriores os he hablado de MCPs y de cómo exprimir Cursor al máximo. Pero lo que os traigo hoy es mejor que truquillos de un editor específico. Para mí, esto es algo básico que se va a convertir en el estándar de la industria.
PD: Antes de seguir, si ves estos posts y no estás suscrito… ¿qué haces con tu vida? Dale al botón que no cuesta nada y a mí me hace muy feliz 😊
¿Qué narices es AGENTS.MD?
La premisa es sencillísima: AGENTS.MD es como un README pero para inteligencias artificiales. Básicamente, es un archivo donde defines las instrucciones de tu proyecto para que la IA sepa exactamente qué hacer.
En este archivo puedes especificar:
- Cómo debe iniciar el proyecto
- Cómo correr los tests
- Qué dependencias usar (y cuáles NO usar)
- Tu estilo de programación preferido
- Convenciones de naming
- Política de comentarios
- Estructura de carpetas
Es como una biblia para la IA. Una vez que la lees, ya no tienes que repetir las mismas indicaciones una y otra vez.
”Pero si esto ya existe…”
Vale, es verdad. Muchos editores tienen sus propias reglas:
- Cursor lo llama “rules”
- Jules (el asistente de JetBrains) tiene “guidelines”
- Warp usa
warp.mdpara reglas de proyecto
La diferencia es que AGENTS.MD no te casa con ningún editor. Es una convención “internacional” que cualquier agente puede leer.
¿Quién soporta AGENTS.MD?
La lista crece cada día, pero de momento lo soportan:
- Codex
- Cursor
- Visual Studio Code
- Warp (una terminal con IA que os recomiendo)
- Gemini CLI
- Devin
- Y muchos más…
Probablemente cuando estés leyendo esto, la lista sea aún más larga.
La ventaja frente a las reglas clásicas
Aquí está la clave: hoy puedes estar usando Cursor, pero mañana quizás es mejor Gemini CLI, o Codex, o lo que sea que salga la semana que viene. Con AGENTS.MD no tienes que cambiar nada, el nuevo editor detectará automáticamente tus reglas.
Y esto es importante. Ya sabéis que no me gusta depender siempre de la misma herramienta porque las cosas cambian muy rápido en este mundillo.
¿Cómo funciona?
Nada del otro mundo. Es un archivo de texto libre donde indicas los requisitos que quieres para tu proyecto. No hay formato específico, no hay mínimo ni máximo. Simplemente pon lo que pienses que es útil.
Existen más de 20.000 ejemplos en internet dependiendo de tu proyecto, lenguaje y tecnologías, pero mi consejo es que lo crees tú mismo con las cosas que realmente necesitas para tu caso específico.
Un ejemplo que te dejará con la boca abierta
Para que veáis la diferencia, hice una prueba rápida. Le pedí a la IA que me creara una API con Python. Sin AGENTS.MD me generó esto:
# API básica sin estructura
from flask import Flask
app = Flask(__name__)
@app.route('/api/data')
def get_data():
# Comentarios innecesarios
return {"data": "example"}
Ahora, creé un AGENTS.MD especificando:
- La estructura que quiero
- Que todas las llamadas tengan autenticación
- El naming específico de los métodos
- Sin comentarios obvios
Con el mismo prompt, la diferencia fue brutal. Me generó una API completamente estructurada, con autenticación JWT, siguiendo mis convenciones y sin un solo comentario innecesario.
La importancia de las instrucciones, amigos.
Estructura recomendada (pero no obligatoria)
Aunque no hay una estructura obligatoria, aquí os dejo un ejemplo que podéis adaptar:
# AGENTS.md
## Project Context
- Language/runtime: Python 3.11 / Node 20
- How to run locally: `npm run dev` o `python main.py`
- How to run tests: `npm test` o `pytest`
## Code Style
- Naming: camelCase para variables, PascalCase para clases
- NO comments obvios, solo documentación necesaria
- Formateo: Prettier/Black según lenguaje
- Preferir composición sobre herencia
- Usar async/await cuando sea posible
## Dependencies
- Allowed: fastapi, pydantic, sqlalchemy (últimas versiones)
- AVOID: Flask (legacy), requests (usar httpx)
## Testing & Quality
- Framework: pytest con coverage mínimo 80%
- Tests unitarios obligatorios para lógica de negocio
- Lint con ruff/eslint antes de commit
## API & Security
- Auth requerido por defecto (JWT)
- Error responses: JSON estándar con status codes apropiados
- Logging: structured logging con contexto
## Git & CI
- Conventional Commits obligatorio
- CI debe pasar tests y lint antes de merge
- No commits directos a main
IMPORTANTE: No metáis keys ni secretos aquí dentro, por favor. Es sentido común pero nunca está de más recordarlo.
El futuro es ahora
Si sois tan vagos como yo (que lo sois, no nos engañemos) y no queréis perder tiempo explicándole lo mismo a la IA cada vez, esta es la solución.
Al igual que pasó con los MCPs, esto probablemente se convierta en un estándar de la industria. Los que nos adaptemos pronto llevaremos ventaja.
Conclusión
AGENTS.MD no es magia, es simplemente organización e inteligencia. Es aprovechar la tecnología de forma correcta para no hacer el mismo trabajo dos veces.
Implementadlo en vuestros proyectos, adaptadlo a vuestras necesidades y, sobre todo, compartid vuestra experiencia. Si os ha gustado el post, dejádmelo en los comentarios y decidme qué otros temas queréis que cubra.
Y recordad: en el mundo de la programación o te adaptas o te quedas atrás. Mejor adaptarse, ¿no?
Nos vemos en el próximo post 👋
