InterviewLab

Agentes de IA

Codex CLI

Codex CLI — Instrucciones de proyecto (AGENTS.md)

AGENTS.md es el archivo de instrucciones de proyecto que Codex lee al arrancar — el sitio para los comandos de build y test, el estilo de código y las reglas propias del repositorio. Genera uno inicial con /init en la TUI.

Orden de descubrimiento

Las instrucciones se ensamblan una vez por ejecución (una por sesión de la TUI), en este orden:

  1. Ámbito global — en $CODEX_HOME (por defecto ~/.codex): lee AGENTS.override.md si existe, y si no AGENTS.md. En este nivel sólo se usa el primer archivo que no esté vacío.
  2. Ámbito de proyecto — empezando en la raíz del proyecto (normalmente la raíz de Git; configurable con project_root_markers) y bajando hasta el directorio actual. En cada directorio Codex mira AGENTS.override.md, luego AGENTS.md y luego los nombres de project_doc_fallback_filenames. Como mucho un archivo por directorio. Si no encuentra raíz de proyecto, sólo mira el directorio actual.
  3. Fusión — todos los archivos encontrados se concatenan de la raíz hacia abajo, separados por líneas en blanco. Los más cercanos al directorio actual quedan al final y por tanto sobrescriben lo anterior.

Reglas y límites

  • Los archivos vacíos se ignoran.
  • El tamaño combinado está limitado por project_doc_max_bytes (por defecto 32 KiB).
  • AGENTS.override.md tiene prioridad sobre AGENTS.md dentro del mismo directorio — por ejemplo, services/payments/AGENTS.override.md sustituye al AGENTS.md de ese directorio (muy útil para ajustes locales que no quieres commitear).
  • La clave de configuración model_instructions_file sustituye por completo las instrucciones internas de Codex — es algo aparte de AGENTS.md, no un reemplazo suyo.
  • Para que la revisión de código de Codex en GitHub las tenga en cuenta, añade una sección ## Code Review Rules al AGENTS.md más cercano al código que se revisa.

Ejemplo de AGENTS.md

# AGENTS.md — example-repo

## Proyecto
Microservicio en Go 1.22. Punto de entrada: cmd/server/main.go.
Los paquetes internos viven en internal/; nada fuera de internal/ puede importarlos.

## Build y tests
- Build:        make build
- Tests unit.:  make test
- Lint:         make lint   (ejecútalo antes de cada commit)
- Integración:  make test-integration   (requiere Docker)

## Estilo de código
- Usa gofmt; mantén las funciones por debajo de 60 líneas.
- Errores: envuélvelos con fmt.Errorf("contexto: %w", err).
- Nada de dependencias nuevas sin comentarlo antes.

## Convenciones
- Las migraciones de db/migrations/ son sólo de añadir — nunca edites una ya aplicada.
- Los cambios de API obligan a actualizar docs/openapi.yaml en el mismo commit.

## Code Review Rules
- Marca cualquier concatenación de cadenas SQL.
- Marca las goroutines sin límite.

Sé concreto: los comandos exactos y las reglas duras funcionan mucho mejor que los consejos generales. Los AGENTS.md en subdirectorios encajan muy bien en monorepos, donde cada paquete puede llevar sus propias instrucciones.

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.

Ver este documento en GitHub