📚 El agente propone, tú apruebas

Un agente que reescribe sus propias reglas puede, sin querer, flexibilizar justo la regla que lo limitaba. Una línea de "puede pagar facturas pequeñas" hace que la política del módulo 4.1 deje de aplicarse.

Por eso el AGENTS.md del kit lo dice claramente: "No cambies estas reglas. Para proponer un cambio, agrega una línea a la tabla 'Aprendizaje' de la runtime/POLITICA.md. Quien aprueba es la persona."

Cómo leer el diagrama: el camino azul de abajo siempre pasa por la caja ámbar, que eres tú. El arco rojo de arriba es el agente escribiendo directamente en Lessons, sin pasar por ti. Ese es el atajo que el AGENTS.md prohíbe.

La tabla está al final de runtime/POLITICA.md, bajo el título "Aprendizaje (propone → aprueba → incorpora)". En el kit viene vacía: solo el encabezado, a la espera de la primera propuesta.

Cada línea tiene cuatro columnas. La segunda pide evidencia: no vale "me pareció mejor", vale "pasó esto, este día, con este resultado".

O agente **não muda as próprias regras**. Ele acrescenta uma linha aqui; você decide.

| data | o que aconteceu (com evidência) | proposta (1 linha) | status: proposto / aprovado / recusado |
|---|---|---|---|

Qué revisar en la tabla: las dos líneas son ejemplos de cómo quedaría, escritos para este curso; no vienen en el kit. Fíjate en que la propuesta cabe en una línea y dice qué hacer, no qué sentir.

A POLITICA.md cierra la sección así: "Aprobado → se convierte en regla en CLAUDE.md/AGENTS.md". Sin kit, el lugar es la sección ## Lessons del AGENTS.md.

Por qué en el AGENTS.md y no en el CLAUDE.md? Porque el CLAUDE.md del kit empieza extrayendo el AGENTS.md. Una regla escrita en un solo lugar sirve para Claude y para Codex.

## Lecciones

Reglas aprobadas por la persona, una por línea:

@AGENTS.md

## Autoaprendizaje

Cuando el humano te corrija o notes un error tuyo: propón la lección como una fila en la tabla «Aprendizaje» de `runtime/POLITICA.md`. Después de que la aprueben, se agrega a `## Lessons` de `AGENTS.md`.

Cómo leer el diagrama: todo pasa por el recuadro ámbar. Escribes la regla una vez en el AGENTS.md, y las dos flechas azules llevan la misma regla a ambos agentes. No existe una versión "solo para Claude" que pueda quedar desactualizada.

## Lecciones

Reglas aprobadas por la persona, una por línea:
- Antes de consultar la agenda, repetir la fecha en AAAA-MM-DD y esperar confirmación.

Cuando algo se rompe y lo arreglas, la tentación es seguir adelante. El runtime/FALHAS.md pide treinta segundos antes: una línea con la fecha, qué se rompió, la corrección mínima y si el problema era del prompt o de infraestructura.

El kit ya incluye una fila real, de cuando se puso a prueba. Es el mejor ejemplo del formato:

| data | o que quebrou | menor correção | prompt \| infra |
|---|---|---|---|
| 2026-10-05 | `doctor.mjs` dizia "codex sem login" com o Codex logado | ler stdout **e** stderr (`codex login status` responde no stderr) | infra |

No todo problema es una falla. A veces no se rompió nada: simplemente el entorno no dejó. El sandbox bloqueó la red, la herramienta no tiene esa función, el sitio pide iniciar sesión. Eso va al runtime/LIMITES.md.

En el kit viene solo con el encabezado. La última columna, estado, indica si el límite sigue abierto o si aceptaste convivir con él.

| data | o que tentei | o que barrou | contorno | status |
|---|---|---|---|---|

Qué revisar en la tabla: la pregunta clave es «¿se rompió o no lo permitieron?». Si se rompió y lo arreglaste, FALHAS. Si no lo permitieron, LIMITES. Si cambió la forma de trabajar, Aprendizado.

-c sandbox_workspace_write.network_access=true

Los tres archivos solo ayudan si alguien los lee. Una vez por semana, pídele al agente que lea todo y convierta lo que se repite en propuestas. Él hace la parte tediosa. Tú haces la parte que importa: decidir.

Son dos solicitudes. La primera solo genera propuestas. La segunda, que escribes después de leerlas, aprueba lo que quieras.

Lee runtime/FALHAS.md, runtime/LIMITES.md y la tabla Aprendizado de runtime/POLITICA.md. Busca lo que se repite o sigue abierto. Para cada caso, agrega una línea en la tabla Aprendizado con fecha, evidencia, propuesta en una línea y estado propuesto. No marques nada como aprobado y no modifiques el AGENTS.md ni el CLAUDE.md. Al final, enumera las líneas que agregaste.

Na tabela Aprendizado de runtime/POLITICA.md, mude para aprovado a linha <data e proposta> e para recusado a linha <data e proposta>. Copie só a proposta aprovada, em uma linha, para ## Lessons do AGENTS.md.