Resumen y práctica

Puntos clave

• Un buen espacio de trabajo le da a la IA contexto, un ciclo de retroalimentación rápido y una forma barata de deshacer; la configuración es el multiplicador, a menudo más que el modelo mismo.
• Un archivo de contexto (AGENTS.md / CLAUDE.md) es lo más rentable que puedes escribir: reglas concretas, prohibiciones contundentes, y referencias a ejemplos.
• Convierte el control de versiones en un reflejo — confirma en pequeño, lee el diff, usa ramas para trabajo arriesgado — para que nada de lo que haga la IA sea realmente irreversible.
• Mantén el ciclo ajustado y deja que el agente lo cierre: editar, ejecutar, leer el fallo, corregir. Retroalimenta a la IA con los diagnósticos (LSP, lint, verificación de tipos).
• Enjaula cada API de pago con un tope duro y un limitador de tasa, mantén los secretos fuera del repositorio, y usa un arnés para convertir las verificaciones de seguridad en algo que la IA no pueda saltarse.

Ponlo en práctica

Abre cualquier proyecto en el que estés trabajando (o crea uno vacío) y escribe a mano un primer borrador de AGENTS.md: qué es el proyecto, el stack tecnológico, los comandos exactos para ejecutar dev/test/lint, tres convenciones reales, y al menos dos prohibiciones contundentes (por ejemplo, "nunca leas ni imprimas .env", "no añadas dependencias sin señalarlo primero"). Luego pídele a tu herramienta de IA que haga un cambio trivial y observa si respeta el archivo. Cada vez que haga algo que no querías, añade o afina una línea. Estás ajustando la habitación, no solo el código.

Prompt del capítulo

Read my project and help me write a concise AGENTS.md context file for it.

First, inspect the repo and tell me:
- the tech stack and versions you detect
- the commands for install / dev / test / lint / build
- the layout and where the entry point is

Then draft an AGENTS.md with these sections: What this is, Tech stack,
Commands, Conventions, and Don'ts. Be specific and concrete (name the
exact libraries and rules, not "follow our conventions"). State the don'ts
as loudly as the do's, and point to one existing file as a style example.
Keep it under ~40 lines — I'll prune from there.