Archetypen
Version 1.1. DWP erkennt drei Archetypen. Der Archetyp bestimmt, wie ein Agent onboardet, wie Pläne zugeschnitten werden und ob die maschinenlesbare Zustandsschicht erforderlich ist.
Additiv in v1.1. Der Agenten-Arbeitsbereich (§3) wird als dritter Archetyp aufgenommen: das langlebige Zuhause eines autonomen Agenten. Git wird EMPFOHLEN statt vorausgesetzt. Die beiden v1.0-Archetypen sind unverändert.
Einzel-Repository
Eine in sich geschlossene Codebasis — eine Anwendung, eine Bibliothek oder ein Service. Pläne operieren direkt auf dem Code.
Merkmale:
- Eine einzige zusammenhängende Codebasis.
- Pläne ändern Dateien in diesem Repository.
.dwp/-Arbeitsbereich im Repository-Stammverzeichnis.
Orchestrator-Hub
Ein Koordinations-Repository, das mehrere untergeordnete Repositorys verwaltet. Pläne können untergeordnete Pläne in Sub-Repositorys erzeugen.
Merkmale:
- Koordiniert mehrere Sub-Repositorys.
- Pläne können an untergeordnete Pläne delegieren.
- Pflegt ein Register der verwalteten Repositorys.
.dwp/-Arbeitsbereich im Hub-Stammverzeichnis verfolgt repository-übergreifenden Zustand.
Agenten-Arbeitsbereich
Ein Agenten-Arbeitsbereich ist das langlebige Arbeitszuhause eines autonomen Agenten — ein OpenClaw-Arbeitsbereich, ein Hermes-Service-Verzeichnis, das Datenverzeichnis eines Personal-Assistant-Daemons oder das persistente Volume eines Cloud-Agenten. Es ist ein Arbeitsbereich, nicht notwendigerweise ein git-Repository, und sein primäres Produkt ist die laufende Arbeit des Agenten statt einer Codebasis.
Die Erkenntnis, die diesen Archetyp ermöglicht: das Harness ist ein Arbeitsbereich, nicht speziell ein Repository. Jedes Harness-Element, das die Methodik für ein Repository definiert, hat ein direktes Arbeitsbereich-Äquivalent:
| Harness-Element (Repository) | Agenten-Arbeitsbereich-Äquivalent |
|---|---|
AGENTS.md (Regeln, Schnellbefehle) |
Der stehende Kontext des Arbeitsbereichs — AGENTS.md selbst oder die Stehende-Anweisungen-Datei der Plattform |
docs/ (dauerhaftes Wissen) |
Arbeitsbereich-Wissensdateien und Speicherdokumente |
.agents/ (Skills, Agenten, Befehle) |
Das Skill-Verzeichnis der Plattform — OpenClaw scannt nativ <workspace>/.agents/skills/ |
.dwp/ (Pläne, Entwürfe) |
.dwp/ im Arbeitsbereich-Stammverzeichnis — unverändert |
| git-Protokoll (Zustand, Wiederaufnehmbarkeit) | state.json je Plan (Plan-Zustand), hier ERFORDERLICH |
Ein Agenten-Arbeitsbereich MUSS AGENTS.md, .agents/ und .dwp/ im Arbeitsbereich-Stammverzeichnis bereitstellen.
Git ist EMPFOHLEN, nicht ERFORDERLICH. Wo git fehlt, MUSS jeder Plan die maschinenlesbare Zustandsschicht tragen: state.jsons Checkpoint, Gate-Einträge und aufgabenbezogene Zeitstempel enthalten die Wiederherstellungsinformationen, die das git-Protokoll in einem Repository enthält.
Pläne in einem Agenten-Arbeitsbereich laufen typischerweise unbeaufsichtigt: Ein geplanter Heartbeat oder Cron-Turn nimmt den offenen Plan über das DWP-Wiederaufnahme-Protokoll wieder auf, führt die nächste atomare Aufgabe aus, aktualisiert die Zustandsschicht und gibt frei. Der Plan — nicht die Sitzung — ist die Einheit der Kontinuität.
Klassifizierungsheuristik
Individual repository
- single codebase
- plans modify local files
- .dwp/ at repo root
Orchestrator hub
- coordinates sub-repos
- plans delegate to child plans
- cross-repo .dwp/ state
Als Agenten-Arbeitsbereich klassifizieren zuerst, wenn das Ziel das Arbeitsverzeichnis einer autonomen Agenten-Plattform ist — Signale: eine Plattform-Identitätsdatei (wie OpenClaws SOUL.md oder HEARTBEAT.md), kein primärer Anwendungsstack und Inhalte, die überwiegend den eigenen Zustand des Agenten darstellen. Ein starkes Plattformsignal genügt.
Andernfalls als Orchestrator-Hub klassifizieren, wenn eine klare Mehrheit der folgenden Punkte zutrifft: mehrere verschachtelte git-Repositorys oder Submodule; ein Register oder Manifest verwalteter Repositorys; Konfiguration, die auf externe Repositorys verweist. Andernfalls als Einzel-Repository klassifizieren — das ist die sichere Voreinstellung.
Wenn Signale mehrdeutig sind, MUSS der Agent dem Nutzer seine Einschätzung und Belege vorlegen und um Bestätigung bitten, bevor er fortfährt.
Onboarding-Unterschiede
| Aspekt | Individual | Orchestrator | Agenten-Arbeitsbereich |
|---|---|---|---|
| Umfang | Dieses Repository | Mehrere Repositorys | Der Arbeitsbereich und seine Pläne |
| Onboarding | Repository-Struktur | Hub-Register | Plattformdateien + Arbeitsbereich-Konventionen |
| Planziel | Lokale Dateien | Untergeordnete Pläne | Lokale oder externe Repositorys |
| Zustand | Lokales .dwp/ |
Repository-übergreifendes .dwp/ |
.dwp/ + state.json (ERFORDERLICH ohne git) |
| Git | Erforderlich | Erforderlich | EMPFOHLEN |
| Zustandsschicht | EMPFOHLEN | EMPFOHLEN | ERFORDERLICH ohne git; ERFORDERLICH für unbeaufsichtigte Läufe |