Agent Home Home-Verzeichnis

Das Problem #

Der Zustand eines Agenten verteilt sich auf Framework-Datenbanken, beim Anbieter gehostete Gedächtnis-APIs und Sandbox-Datenträger, die jederzeit verschwinden können. Wechseln Sie Framework oder Anbieter, geht der Zustand verloren; wenn etwas schiefläuft, gibt es keinen einzelnen Ort, an dem man sehen kann, was der Agent tatsächlich weiß.

Zugleich nähern sich gängige Agenten den Dateien an: AGENTS.md, Agent Skills, Git-gestützte Gedächtnis-Repositories. Es fehlt nicht ein neues Format, sondern ein Ort dafür mit einem Eigentümer, Verlauf, Kontingenten und garantiertem Export.

So funktioniert es #

• Der Aufbau folgt offenen Konventionen. AGENTS.md, das SKILL.md von Agent Skills und Markdown mit YAML-Frontmatter, wie in der Skizze unten. Wir erfinden kein Format.
• Ein Home gehört zu einer Rolle, nicht zu einer einzelnen Ausführung. Ausführungen nutzen es über Branches: Änderungen landen zuerst auf einem Branch und werden nach einer Prüfung ins Home zurückgemergt.
• Es hat einen Verlauf. Jede Änderung ist ein Commit. nas export oder git clone nimmt das ganze Home mit, einschließlich der Klartext-Metadaten in .nas/.
• Der Startkontext ist nur das Lesen einiger Dateien: AGENTS.md, memory/MEMORY.md und eine Zusammenfassung des Posteingangs. Es gibt kein besonderes Aufwach-Protokoll; ein NAS kann der Bequemlichkeit halber eine auf Token begrenzte Ansicht briefing anbieten, sie ist aber nicht erforderlich.
• Nur geprüfte Notizen werden automatisch geladen. Nur Notizen mit der Markierung reviewed gelangen in MEMORY.md und in den automatisch geladenen Kontext; siehe Trust Labels und Agent Memory.
• Lebenszyklus. Anlegen aus einer Vorlage, Kontingente, Archivierung und Ruhestand, mit einem Erben, der beim Ruhestand benannt werden kann.

Klein anfangen #

• Legen Sie ein Verzeichnis mit AGENTS.md, skills/ und memory/ an und führen Sie git init aus. Verlinken Sie CLAUDE.md und ähnliche Dateien per Symlink auf AGENTS.md.
• Führen Sie vor jeder Ausführung git worktree add aus, damit sie in ihrem eigenen Arbeitsverzeichnis arbeitet.
• Das ist L0: Ohne jede Agent-NAS-Software haben Sie bereits ein Home mit Verlauf, das Sie mitnehmen können.

Schnittstellenskizze #

Nur zur Veranschaulichung. Feldnamen können sich vor der Spezifikation v0.3 ändern.

/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

Was die Spezifikation verlangt #

• Ein Home MUSS allein aus dem Store wiederaufbaubar sein; sein Lesen DARF NICHT von abgeleiteten Daten abhängen.
• Die Metadaten in .nas/ MÜSSEN Klartext sein und MÜSSEN mit dem Home exportiert werden.
• Automatisch geladener Kontext MUSS auf Token begrenzt sein und MUSS ausschließlich aus geprüften Notizen stammen.
• Der Aufbau SOLLTE offenen Konventionen folgen: AGENTS.md, SKILL.md, Markdown mit YAML-Frontmatter.
• Ausführungen MÜSSEN ein Home über Branches nutzen.

Was übernommen ist und was neu ist #

Alles Folgende ist übernommen, und sehr wenig ist neu: Aufbau und Git gibt es bereits. Neu ist nur, das Home als Objekt erster Klasse mit Kontingenten, Erben und Exportgarantie zu behandeln und die Vertrauensgrenze zu setzen, dass nur geprüfte Notizen automatisch geladen werden.

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

Ehrliche Grenzen #

• Die nativen Gedächtnisformate unterscheiden sich zwischen Frameworks, daher ist die Abbildung auf die Home-Konventionen verlustbehaftet.
• Es hilft nur, wenn Laufzeitumgebungen bereit sind, diese Dateien zu lesen und zu schreiben.
• Verborgener Zustand auf der Anbieterseite, etwa Gedächtnis in der Cloud eines Anbieters, lässt sich nicht herüberholen.

Offene Fragen #

• Wie lassen sich die Formate verschiedener Frameworks in beide Richtungen auf das Home abbilden?
• Wie bleiben Last und Latenz beim Start bei einem sehr großen Home beherrschbar?

Fragen #

Verwandte Konzepte #

• Agent Branch (Agentenzweig) Jede Ausführung arbeitet auf einem Copy-on-Write-Branch. Nur ein geprüfter Merge erreicht die Hauptlinie.
• Agent Memory (Agentengedächtnis) Notizen, die Sie lesen und bearbeiten können, sind die Wahrheit. Indizes sind ein Cache, den Sie wegwerfen können.
• Capability Lease (befristete Berechtigung) Eine enge Autorisierung für eine Ausführung, mit Ablauf und Budgets. Kind-Leases können nur enger sein.