# Agent Home (hogar del agente) *Un directorio por rol, con historial. Archivos normales que puedes llevarte contigo.* > **Un Agent Home** es un directorio por rol, con historial: instrucciones, habilidades, memoria, diario y espacio de trabajo, todo como archivos normales. Cualquier runtime puede entrar en él, y puedes llevártelo todo cuando te vayas. **AN-01** · Nivel de conformidad: L0 Files · Grupo: Trabajo ## 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](https://agentnas.com/es/concepts/agent-branch/): 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](https://agentnas.com/es/concepts/trust-labels/) y [Agent Memory](https://agentnas.com/es/concepts/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. *layout* ```text /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](https://agents.md) - [Agent Skills](https://agentskills.io/specification) - [Letta Context Repositories](https://www.letta.com/blog/context-repositories/) - [Turso AgentFS](https://github.com/tursodatabase/agentfs) - [Cloudflare Artifacts](https://blog.cloudflare.com/artifacts-git-for-agents-beta/) ## 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 ### ¿Un Agent Home es solo un repositorio Git? En su mayor parte, y a propósito: basta con hacer `git clone`. La diferencia es que además tiene un dueño (un rol), cuotas, un heredero, una garantía de exportación y la regla de que solo se cargan automáticamente las notas revisadas, y el NAS las hace cumplir en lugar de dejarlas como convención. ### ¿Perderé la memoria si cambio de framework de agentes? No, siempre que el nuevo runtime esté dispuesto a leer los archivos. Un Home usa convenciones abiertas: `AGENTS.md`, `SKILL.md` y las notas en Markdown no dependen de ningún framework. Las partes cuya asignación implica pérdidas deben marcarse como sin revisar al importar. ### ¿Necesito instalar Agent NAS para usar un Home? No. Un directorio de Git con un `AGENTS.md` es un Home L0. Lo que añade un NAS son cuotas, fusiones protegidas, concesiones y un rastro de auditoría, no un formato de archivo. ## Conceptos relacionados - [Agent Branch (rama del agente)](https://agentnas.com/es/concepts/agent-branch/): 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)](https://agentnas.com/es/concepts/agent-memory/): Las notas que puedes leer y editar son la verdad. Los índices son una caché que puedes tirar. - [Capability Lease (concesión de capacidad)](https://agentnas.com/es/concepts/capability-lease/): Una autorización estrecha para una ejecución, con caducidad y presupuestos. Las concesiones hijas solo pueden ser más estrechas. --- URL canónica: https://agentnas.com/es/concepts/agent-home/ Actualizado: 2026-11-11 · Borrador de especificación v0.2 · CC BY 4.0