Skip to content
← Alle Spezifikationsdokumente

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

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