Escribe un archivo de contexto (AGENTS.md)

Lo más rentable que puedes hacer es escribir un archivo de contexto que la IA lea automáticamente. Distintas herramientas buscan distintos nombres: AGENTS.md, CLAUDE.md, .cursorrules, o un .github/copilot-instructions.md, pero la idea es idéntica: un documento vivo que le dice a la IA cómo funciona tu proyecto y cómo quieres tú que se comporte.

Sin él, la IA adivina. Con él, la IA deja de reformatear tu código, deja de inventar bibliotecas que no usas y deja de volver a explicar decisiones que ya tomaste. Piénsalo como documentación de incorporación para una nueva compañera de equipo que es brillante pero tiene amnesia total entre sesiones: todo lo que necesita para ser productiva tiene que vivir en algún lugar que lea cada vez.

Un archivo inicial práctico:

# Project: Invoice Manager

## What this is
A small web app for freelancers to create and track invoices.

## Tech stack
- TypeScript + React (Vite)
- Tailwind for styling
- SQLite via Prisma
- Vitest for tests

## Commands
- Install: `npm install`
- Run dev server: `npm run dev`
- Run tests: `npm test`
- Lint: `npm run lint`

## Conventions
- Use functional components and hooks; no class components.
- Keep components small; one component per file.
- Write a test for every new function in `src/lib`.
- Never edit files in `src/generated/` — they are auto-generated.

## Don'ts
- Don't add new dependencies without flagging it first.
- Don't commit secrets; use environment variables.

Mantenlo breve y actualizado. Un archivo de contexto que crece hasta mil líneas deja de leerse con atención, ya sea por ti o por el modelo, así que pódalo con la misma agresividad con la que lo amplías. Cuando la IA repita el mismo supuesto erróneo, esa es tu señal para añadir una línea; cuando una regla ya no coincida con la realidad, elimínala antes de que empiece a confundir activamente al agente.

Unos pocos patrones separan un archivo de contexto que funciona de uno que se ignora:

• Sé específico y concreto. "Usa nuestras convenciones" es inútil. "Usa zod para validación; no usamos yup" es una regla que la IA realmente puede seguir.
• Declara los "no hagas" con la misma fuerza que los "haz". Los modelos están ansiosos por ayudar, lo que significa que añadirán con gusto una dependencia o reescribirán una configuración a menos que les digas que no lo hagan.
• Señala ejemplos. "Sigue el estilo de src/features/invoices" le da a la IA un modelo concreto que copiar en lugar de una instrucción vaga que interpretar.

Trata el archivo de contexto como un registro de cada lección que de otro modo tendrías que repetir. Es la inversión más barata y duradera de todo este capítulo.