Agent Home répertoire personnel

Le problème #

L’état d’un agent est dispersé entre des bases de données de frameworks, des API de mémoire hébergées chez des fournisseurs et des disques de sandbox qui peuvent disparaître à tout moment. Changez de framework ou de fournisseur et l’état est perdu ; quand quelque chose tourne mal, il n’y a pas d’endroit unique où voir ce que l’agent sait réellement.

Dans le même temps, les agents grand public convergent vers les fichiers : AGENTS.md, Agent Skills, dépôts de mémoire adossés à Git. Ce qui manque n’est pas un nouveau format, mais un lieu pour les accueillir, avec un propriétaire, un historique, des quotas et un export garanti.

Fonctionnement #

• La disposition suit des conventions ouvertes. AGENTS.md, le SKILL.md d’Agent Skills et du Markdown avec frontmatter YAML, comme dans l’esquisse ci-dessous. Nous n’inventons pas de format.
• Un Home appartient à un rôle, pas à une seule exécution. Les exécutions l’utilisent par des branches : les modifications atterrissent d’abord sur une branche et sont fusionnées dans le Home après relecture.
• Il a un historique. Chaque modification est un commit. nas export ou git clone emporte tout le Home, y compris les métadonnées en texte brut de .nas/.
• Le contexte de démarrage, c’est simplement la lecture de quelques fichiers : AGENTS.md, memory/MEMORY.md et un résumé de la boîte de réception. Il n’y a pas de protocole de réveil particulier ; un NAS peut proposer par commodité une vue briefing plafonnée en tokens, mais ce n’est pas obligatoire.
• Seules les notes relues se chargent automatiquement. Seules les notes marquées reviewed entrent dans MEMORY.md et dans le contexte chargé automatiquement ; voir Trust Labels et Agent Memory.
• Cycle de vie. Création à partir d’un modèle, quotas, archivage et retrait, avec un héritier qui peut être désigné au moment du retrait.

Commencer petit #

• Créez un répertoire avec AGENTS.md, skills/ et memory/, et lancez git init. Faites pointer CLAUDE.md et les fichiers analogues vers AGENTS.md par des liens symboliques.
• Lancez git worktree add avant chaque exécution pour qu’elle travaille dans son propre arbre de travail.
• C’est L0 : sans aucun logiciel Agent NAS, vous avez déjà un Home avec historique que vous pouvez emporter.

Esquisse d’interface #

À titre d’illustration seulement. Les noms de champs peuvent changer avant la spécification 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

Ce que demande la spécification #

• Un Home DOIT pouvoir être reconstruit à partir du seul Store ; sa lecture NE DOIT PAS dépendre de données dérivées.
• Les métadonnées de .nas/ DOIVENT être en texte brut et DOIVENT être exportées avec le Home.
• Le contexte chargé automatiquement DOIT être plafonné en tokens et DOIT provenir uniquement de notes relues.
• La disposition DEVRAIT suivre des conventions ouvertes : AGENTS.md, SKILL.md, Markdown avec frontmatter YAML.
• Les exécutions DOIVENT utiliser un Home par des branches.

Ce qui est emprunté, et ce qui est nouveau #

Tout ce qui précède est emprunté, et très peu est nouveau : la disposition et Git existent déjà. La seule nouveauté est de traiter le Home comme un objet de première classe, avec quotas, héritier et garantie d’export, et de poser la frontière de confiance selon laquelle seules les notes relues se chargent automatiquement.

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

Limites assumées #

• Les formats de mémoire natifs diffèrent d’un framework à l’autre ; les convertir vers les conventions du Home se fait donc avec perte.
• Cela n’aide que si les runtimes acceptent de lire et d’écrire ces fichiers.
• L’état caché côté fournisseur, comme une mémoire hébergée dans le cloud d’un fournisseur, ne peut pas être rapatrié.

Questions ouvertes #

• Comment faire correspondre dans les deux sens les formats des différents frameworks avec le Home ?
• Comment maîtriser la charge et la latence au démarrage pour un Home très volumineux ?

Questions #

Concepts liés #

• Agent Branch (branche d’agent) Chaque exécution travaille sur une branche en copy-on-write. Seule une fusion relue atteint la ligne principale.
• Agent Memory (mémoire de l’agent) Des notes que vous pouvez lire et modifier font la vérité. Les index sont un cache que vous pouvez jeter.
• Capability Lease (habilitation de capacité) Une autorisation étroite pour une exécution, avec une expiration et des budgets. Les habilitations filles ne peuvent être que plus étroites.