Un AGENTS.md corto que enruta

El recepcionista del edificio

Cuando entras en un edificio de oficinas, el recepcionista no te explica todo lo que se hace allí. Te dice: «Tercera planta, puerta B». El AGENTS.md debe hacer lo mismo: orientar y mandar a cada sitio. A este tipo de archivo el curso lo llama archivo de enrutamiento, y recomienda unas 50-200 líneas.

Qué lleva dentro

Cuatro bloques:

1. Resumen del proyecto: una o dos frases.
2. Arranque rápido: los comandos de primera ejecución (instalar, probar, verificar).
3. Restricciones duras: no más de unas quince reglas innegociables.
4. Documentos por tema: enlaces con una línea de descripción y cuándo leerlos.

Todo lo demás va fuera, en documentos de 50-150 líneas organizados por tema en docs/ o junto al módulo. El agente los abre solo cuando los necesita, que es justo la idea de recuperar contexto justo a tiempo.

Plantilla para copiar

# AGENTS.md

## Resumen del proyecto
Backend FastAPI en Python 3.11, base de datos PostgreSQL 15.

## Arranque rápido
- Instalar: `make setup`
- Tests: `make test`
- Verificación completa: `make check`

## Restricciones duras
- Todas las APIs usan autenticación OAuth 2.0
- Las consultas a la base de datos usan sintaxis SQLAlchemy 2.0
- Ningún PR se acepta sin pytest + mypy --strict + ruff check

## Documentos por tema
- `docs/api-patterns.md`: leer al añadir endpoints
- `docs/database-rules.md`: leer al modificar operaciones de base de datos
- `docs/testing-standards.md`: consultar al escribir tests

La plantilla del curso para el repositorio mínimo sigue la misma lógica en un formato aún más compacto: unas pocas líneas de «Comienza aquí» (leer arquitectura y producto, comando para arrancar, comando de verificación antes de dar algo por completado) y unas reglas estrictas, como no marcar algo como completo sin verificarlo y dejar un estado limpio para la siguiente sesión.

Trucos de colocación

• Lo más importante, arriba o abajo, nunca en medio.
• Parte de la información está mejor en el código: tipos, comentarios de interfaz, archivos de configuración. El agente los ve al leer el código; no hace falta duplicarlos.
• Gestiona las instrucciones como dependencias: audítalas de vez en cuando y borra lo que no se usa.