Haz del repositorio la fuente de verdad
Una ventana de chat es RAM: rápida, y borrada en cuanto acaba la sesión. El repo es el disco. Lo que tenga que durar más que hoy hay que escribirlo donde la sesión de mañana lo encuentre.
Si una carretera no está dibujada en el mapa, el conductor no puede tomarla, por bien que se sepa la ciudad de memoria. Una sesión nueva de un agente solo sabe lo que el repositorio le dice. Una regla que vive en Slack, en tu memoria o en un chat cerrado es una carretera que no existe para el agente.
Memoria volátil vs. estado duradero
Todo lo que un agente «sabe» a mitad de sesión vive en una ventana de contexto que será resumida, truncada o descartada. Trátala como memoria de trabajo, nunca como fuente de verdad. En el momento en que una regla, una decisión o un avance solo existe en el chat, tienes un punto único de fallo que la siguiente sesión no puede recuperar.
La solución es una disciplina: todo lo que deba sobrevivir se escribe en un archivo y se commitea. El repo se vuelve el único lugar que tú y el agente acordáis que es real.
flowchart LR S["Reglas en el chat"] --> W["Escribir en archivos del repo"] Head["Reglas en tu cabeza"] --> W W --> Repo["feature_list.json, AGENTS.md, handoff.md"] Repo --> A["La sesión nueva lee el repo"]
Qué va en el repo
- Reglas y restricciones, en
AGENTS.mdy docs por tema, no reexplicadas cada sesión. - El plan y su estado, una lista de funciones que el agente actualiza sobre la marcha.
- Decisiones y su porqué, para que no se reviertan en silencio después.
- Notas de traspaso, qué se hizo, qué sigue, qué es arriesgado.
Si no está commiteado, da por hecho que desapareció. El historial de Git sirve además como registro de auditoría de cómo se desarrolló el trabajo.
Cómo lo refuerza Agentum
El Harness Engine de Agentum trata el repo como registro de forma literal. Persiste el estado de cada función, pending → coding → verifying → done, de vuelta en .agentum-harness/feature_list.json, así que un daemon reiniciado (o tú, abriendo el board) ve la verdad viva desde el disco, no desde la memoria de una sesión. Tras cada función en verde sobrescribe handoff.md con el estado actual. El directorio del harness vive en tu árbol de trabajo, versionado y recuperable, no en un chat en el servidor de otro.
Puntos clave
- El chat es memoria de trabajo; el repositorio es la fuente de verdad.
- Si importa más allá de esta sesión y no está commiteado, no existe.
- Reglas, plan, decisiones y notas de traspaso van en archivos que el agente lee.
- El historial de Git se vuelve un rastro de auditoría recuperable.
Ejercicios
- Audita la visibilidad. Lista tres reglas que tus agentes deberían seguir. ¿Cada una está escrita en el repo o solo en tu cabeza?
- Mueve una regla. Toma la regla no escrita más importante y commitéala en AGENTS.md.