Agent Home hogar del agente

El problema #

El estado de un agente está repartido entre bases de datos de frameworks, APIs de memoria alojadas por el proveedor y discos de sandbox que pueden desaparecer en cualquier momento. Si cambias de framework o de proveedor, el estado se pierde; cuando algo sale mal, no hay un único lugar donde ver qué sabe realmente el agente.

Al mismo tiempo, los agentes principales están convergiendo en los archivos: AGENTS.md, Agent Skills, repositorios de memoria respaldados por Git. Lo que falta no es un formato nuevo, sino un lugar para ellos con dueño, historial, cuotas y exportación garantizada.

Cómo funciona #

• La organización sigue convenciones abiertas. AGENTS.md, el SKILL.md de Agent Skills y Markdown con frontmatter YAML, como en el esbozo de abajo. No inventamos un formato.
• Un Home pertenece a un rol, no a una ejecución. Las ejecuciones lo usan a través de ramas: los cambios llegan primero a una rama y se fusionan de vuelta en el Home tras la revisión.
• Tiene historial. Cada cambio es un commit. nas export o git clone se llevan el Home entero, incluidos los metadatos en texto plano de .nas/.
• El contexto de arranque es solo leer unos pocos archivos: AGENTS.md, memory/MEMORY.md y un resumen de la bandeja de entrada. No hay un protocolo especial de despertar; un NAS puede ofrecer, como comodidad, una vista briefing con tope de tokens, pero no es obligatoria.
• Solo se cargan automáticamente las notas revisadas. Solo las notas marcadas como reviewed entran en MEMORY.md y en el contexto de carga automática; consulta Trust Labels y Agent Memory.
• Ciclo de vida. Creación a partir de una plantilla, cuotas, archivo y retirada, con un heredero que se puede nombrar al retirar.

Empezar en pequeño #

• Crea un directorio con AGENTS.md, skills/ y memory/, y ejecuta git init. Enlaza simbólicamente CLAUDE.md y archivos similares a AGENTS.md.
• Ejecuta git worktree add antes de cada ejecución para que trabaje en su propio árbol de trabajo.
• Eso es L0: sin ningún software de Agent NAS ya tienes un Home con historial que puedes llevarte.

Esbozo de la interfaz #

Solo ilustrativo. Los nombres de los campos pueden cambiar antes de la especificación v0.3.

/agents/cleo/                    # a role's Home: it belongs to the role, not to one run
├── AGENTS.md                    # instructions (open convention)
├── skills/                      # Agent Skills: one directory per skill
│   └── release-notes/SKILL.md
├── memory/
│   ├── MEMORY.md                # reviewed core memory: auto-loaded, token-capped
│   ├── notes/                   # notes: Markdown + YAML frontmatter
│   ├── journal/                 # raw log: append-only
│   └── quarantine/              # unreviewed notes: recallable, never auto-loaded
├── inbox/                       # tasks and messages received
├── outbox/                      # deliverables and replies
├── workspace/                   # scratch space (retention class: scratch)
└── .nas/                        # plain-text metadata: role.yaml, limits.yaml, maintenance.yaml

Lo que pide la especificación #

• Un Home DEBE poder reconstruirse solo desde Store; leerlo NO DEBE depender de ningún dato derivado.
• Los metadatos de .nas/ DEBEN ser texto plano y DEBEN exportarse con el Home.
• El contexto de carga automática DEBE tener un tope de tokens y DEBE provenir solo de notas revisadas.
• La organización DEBERÍA seguir convenciones abiertas: AGENTS.md, SKILL.md, Markdown con frontmatter YAML.
• Las ejecuciones DEBEN usar un Home a través de ramas.

Lo prestado y lo nuevo #

Lo que sigue está todo prestado, y muy poco es nuevo: la organización y Git ya existen. Lo único nuevo es tratar el Home como un objeto de primera clase con cuotas, heredero y garantía de exportación, y fijar la frontera de confianza de que solo se cargan automáticamente las notas revisadas.

• AGENTS.md
• Agent Skills
• Letta Context Repositories
• Turso AgentFS
• Cloudflare Artifacts

Límites honestos #

• Los formatos de memoria nativos difieren entre frameworks, así que asignarlos a las convenciones del Home implica pérdidas.
• Solo sirve si los runtimes están dispuestos a leer y escribir estos archivos.
• El estado oculto del lado del proveedor, como la memoria alojada en la nube de un proveedor, no se puede traer.

Preguntas abiertas #

• ¿Cómo deben asignarse en ambos sentidos los formatos de distintos frameworks al Home?
• ¿Cómo se mantienen bajo control la carga y la latencia al arrancar con un Home muy grande?

Preguntas #

Conceptos relacionados #

• Agent Branch (rama del agente) Cada ejecución trabaja en una rama copy-on-write. Solo una fusión revisada llega a la línea principal.
• Agent Memory (memoria del agente) Las notas que puedes leer y editar son la verdad. Los índices son una caché que puedes tirar.
• Capability Lease (concesión de capacidad) Una autorización estrecha para una ejecución, con caducidad y presupuestos. Las concesiones hijas solo pueden ser más estrechas.