# Agent Home (Home-Verzeichnis) *Ein Verzeichnis pro Rolle, mit Verlauf. Gewöhnliche Dateien, die Sie mitnehmen können.* > **Ein Agent Home** ist ein Verzeichnis pro Rolle, mit Verlauf: Anweisungen, Skills, Gedächtnis, Journal und Arbeitsbereich, alles als gewöhnliche Dateien. Jede Laufzeitumgebung kann es betreten, und Sie können alles mitnehmen, wenn Sie gehen. **AN-01** · Konformitätsstufe: L0 Files · Gruppe: Arbeit ## 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](https://agentnas.com/de/concepts/agent-branch/): Ä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](https://agentnas.com/de/concepts/trust-labels/) und [Agent Memory](https://agentnas.com/de/concepts/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. *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 ``` ## 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](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/) ## 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 ### Ist ein Agent Home nur ein Git-Repository? Im Wesentlichen ja, und absichtlich: Sie können es einfach mit `git clone` holen. Der Unterschied ist, dass es zusätzlich einen Eigentümer (eine Rolle), Kontingente, einen Erben, eine Exportgarantie und die Regel hat, dass nur geprüfte Notizen automatisch geladen werden, und dass das NAS dies durchsetzt, statt es bei einer Konvention zu belassen. ### Verliere ich das Gedächtnis, wenn ich das Agenten-Framework wechsle? Nein, solange die neue Laufzeitumgebung bereit ist, die Dateien zu lesen. Ein Home nutzt offene Konventionen: `AGENTS.md`, `SKILL.md` und Markdown-Notizen hängen von keinem Framework ab. Teile, deren Abbildung verlustbehaftet ist, sollten beim Import als ungeprüft markiert werden. ### Muss ich Agent NAS installieren, um ein Home zu nutzen? Nein. Ein Git-Verzeichnis mit einer `AGENTS.md` ist ein L0-Home. Was ein NAS hinzufügt, sind Kontingente, geschützte Merges, Leases und ein Prüfpfad, kein Dateiformat. ## Verwandte Konzepte - [Agent Branch (Agentenzweig)](https://agentnas.com/de/concepts/agent-branch/): Jede Ausführung arbeitet auf einem Copy-on-Write-Branch. Nur ein geprüfter Merge erreicht die Hauptlinie. - [Agent Memory (Agentengedächtnis)](https://agentnas.com/de/concepts/agent-memory/): Notizen, die Sie lesen und bearbeiten können, sind die Wahrheit. Indizes sind ein Cache, den Sie wegwerfen können. - [Capability Lease (befristete Berechtigung)](https://agentnas.com/de/concepts/capability-lease/): Eine enge Autorisierung für eine Ausführung, mit Ablauf und Budgets. Kind-Leases können nur enger sein. --- Kanonische URL: https://agentnas.com/de/concepts/agent-home/ Aktualisiert am: 2026-11-11 · Spezifikationsentwurf v0.2 · CC BY 4.0