# Plantilla de AGENTS.md

Qué es: el archivo de instrucciones que Codex lee antes de tocar tu proyecto.
Cómo se usa: copiá el bloque de abajo a un archivo llamado AGENTS.md en la raíz.
De dónde salió: Totem · megatotem.com · actualizado julio 2026

---

Codex arma su cadena de instrucciones al arrancar cada sesión: primero
`~/.codex/AGENTS.md` (global), después los `AGENTS.md` que encuentre desde la
raíz del proyecto hacia abajo hasta el directorio donde estás parado. Lo más
cercano gana, porque aparece último. Un `AGENTS.override.md` en una carpeta
reemplaza al `AGENTS.md` de esa misma carpeta.

El límite por defecto es de 32 KiB entre todos los archivos juntos. Cuando lo
pasás, Codex deja de sumar. Por eso las instrucciones específicas de una
subcarpeta van en esa subcarpeta y no en la raíz.

---

## El archivo

```markdown
# AGENTS.md

## Qué es este proyecto

[Dos o tres líneas. Qué hace, para quién, en qué estado está.]

## Cómo se trabaja acá

- Antes de tocar código, leé [archivo o carpeta] para entender el flujo.
- Corré `[comando de test]` después de modificar [tipo de archivo].
- Usá `[gestor de paquetes]` para instalar. Preguntá antes de agregar una
  dependencia de producción.
- No toques [carpeta o archivo sensible] sin avisarme.

## Cuándo delegar en subagentes

Delegá en paralelo cuando el trabajo tenga dos o más ramas que puedan avanzar
sin esperarse y cada una produzca un archivo distinto. Casos típicos acá:

- Revisión de una rama: un agente por dimensión (seguridad, tests, mantenibilidad).
- Investigación de un bug: uno reproduce, otro mapea el código, otro corrige.
- Auditoría de una carpeta grande: un agente por subsistema.

No delegues para una edición chica, para una pregunta con una sola fuente de
verdad, ni cuando el paso B necesita el resultado del paso A.

Reglas del equipo:
- Cada subagente es dueño de un archivo. Nadie escribe en el archivo de otro.
- Los subagentes de exploración y revisión van en modo lectura.
- Todo hallazgo se devuelve con archivo y línea. Sin referencia, es un supuesto
  y se declara como tal.
- Si un subagente necesita un permiso nuevo, para y escala. No lo amplía solo.

## Code Review Rules

[Reglas concretas de revisión, si usás la revisión de Codex en GitHub.
Una regla por viñeta: qué marcar y cuál es el camino seguro.]
```

---

## Cómo comprobar que lo está leyendo

Desde la raíz del proyecto:

```bash
codex --ask-for-approval never "Resumí las instrucciones activas."
```

Codex tiene que citarte las viñetas de tu archivo antes de proponer trabajo. Si
no aparece nada, revisá que no estés en otra carpeta, que el archivo no esté
vacío y que no haya un `AGENTS.override.md` más arriba pisándolo.

Para ver cuáles cargó desde una subcarpeta:

```bash
codex --cd services/pagos --ask-for-approval never "Listá las fuentes de instrucciones que cargaste."
```

## Dos avisos

**El archivo se paga.** Todo lo que escribas en `AGENTS.md` entra en el
contexto de cada mensaje. Un archivo largo se cobra en cada turno y en cada
subagente. Escribí lo que cambia decisiones, no lo que ya se deduce del código.

**No hay caché.** Codex reconstruye la cadena en cada arranque. Si editaste el
archivo con una sesión abierta, reiniciala.