Beim Schreiben einer README oder eines Übergabedokuments landet am Ende immer ein Strukturdiagramm neben dem Text. Das Zeichnen ist nicht der schwere Teil. Der schwere Teil ist, dass es bereits in dem Moment veraltet, in dem Sie es fertigstellen: Zwei Module werden refaktoriert, eine Message-Queue taucht auf, und das Diagramm zeigt noch die Form des Vormonats – die nächste Person, die ihm vertraut, lernt also das falsche System. Archify ist ein optionaler Hermes-Skill, der genau auf dieses Problem zielt: Sie geben ihm eine kleine typisierte JSON-Spec (oder fügen das Mermaid ein, das Sie ohnehin schon hatten), und er erzeugt ein selbstständiges interaktives HTML-Diagramm – nachdem er eine Validierungsrunde darauf laufen ließ.

Was er tatsächlich tut

Man kann sich archify so vorstellen, dass er ein Diagramm als schema-gesteuertes Artefakt behandelt und nicht als Bild:

• fünf Diagrammtypen: architecture, workflow, sequence, dataflow und lifecycle (State Machine);
• Die Ausgabe ist selbstständiges HTML: Dark- und Light-Theme, Pan und Zoom, Suche, Beziehungs-Tracing, optionales Trace-Motion und Export nach PNG / JPEG / WebP / SVG / WebM;
• Die Eingabe kann eine umgangssprachliche Anforderung sein oder Mermaid, das Sie woanders kopiert haben (flowchart, sequenceDiagram, stateDiagram);
• Wenn das Diagramm echten Code abbilden soll, kann er Repository-Belege lesen, statt allein mit Ihrer Beschreibung zu arbeiten.

Der wichtige Unterschied ist der letzte Schritt: Jeder Kandidat durchläuft einen validate/deliver-Beleg mit neun Checks. „Ist dieses Diagramm richtig?“ wird zu etwas, das Sie prüfen können, statt zu etwas, das Sie mit dem Auge abschätzen.

Installation

hermes skills install official/creative/archify

Er ist ein offizieller optionaler Skill – nicht Teil einer Standardinstallation. Er liegt unter optional-skills/creative/archify, wird von tt-a1i gepflegt, ist MIT-lizenziert, Version 2.17.0.

Ein Design-Detail ist es wert, gekannt zu werden: Auf der Hermes-Seite ist das ein upstream-gepflegter Katalogeintrag. Der Skill selbst liegt bei tt-a1i/archify (die Node-CLI, die Schemas, Renderer, Beispiele und Referenzen liegen alle dort), und die Installation zieht den aktuellen Tree live aus diesem Repository, in Quarantäne genommen und gescannt wie jede Hub-Installation. Der Vorteil ist direkt: Die Kopie, die Sie installieren, kann nicht veralten.

Es gibt genau eine Voraussetzung: Node.js 18+ im PATH. Die Installation zieht ungefähr 200 Dateien (~8 MB, überwiegend Upstream-Tests und Beispiele), und der Fetch ist an einen einzigen Tree-SHA gepinnt. Das Ergebnis bestätigen Sie mit:

node bin/archify.mjs doctor

Ein npm install innerhalb des Skill-Pakets ist nicht nötig.

Fünf Typen, ein Workflow

Für Sie ist der Workflow immer derselbe: beschreiben, was Sie wollen, und ein HTML-Diagramm plus einen Validierungsbeleg erhalten.

Ein paar Entscheidungen sparen in der Praxis Zeit:

• „Woraus besteht das System, und wie hängen die Teile zusammen“ → architecture;
• „In welcher Reihenfolge läuft eine Anfrage durch diese Schritte“ → workflow oder sequence (Ersterer für verzweigende Flüsse, Letzterer für Roundtrips zwischen Teilnehmern);
• „Woher kommen die Daten, was passiert mit ihnen, wo landen sie“ → dataflow;
• „Welche Zustände hat dieses Objekt, und welche Events bewegen es“ → lifecycle.

Wenn Sie bereits Mermaid haben – in vielen Meeting-Notizen und Issues steckt welches –, ist das Einfügen und Konvertieren in eine interaktive Version durch archify besser, als die Sache von Grund auf neu zu beschreiben.

Wie er sich die Arbeit mit dem eingebauten Skill teilt

Hermes bringt einen architecture-diagram-Skill mit: null Dependencies und der Fallback neben archify (beide teilen dieselbe Cocoon-AI-Abstammung).

Die Wahl ist einfach:

• Ein Diagramm, keine Node-Installation, keine Interaktivität oder Export nötig → der eingebaute Skill;
• Ein Validierungsbeleg, Mermaid-Konvertierung, Sequenz-/Lifecycle-Typen oder Exporte über eine einzelne HTML-Datei hinaus → archify.

Zwei Dinge, die Sie im Hinterkopf behalten sollten

1. Sein Update-Check gibt nur einen Hinweis aus. Der Upstream-Schritt „update awareness“ führt scripts/check-update.mjs aus, das ein Release-Manifest von GitHub liest und nur einen Hinweis ausgibt – nie etwas herunterlädt oder installiert. Wenn ausgehende Aufrufe in Ihrer Umgebung unerwünscht sind, überspringen Sie ihn.
2. Das Lesen Ihres Codes hat eine Kontext-Voraussetzung. Wenn Sie archify bitten, ein Diagramm in Repository-Belegen zu erden, liest er, was in Ihrem aktuellen Arbeitsverzeichnis liegt – der Aufruf aus dem Repository-Root ist also deutlich nützlicher als aus einem leeren Temp-Ordner.

Die Kurzfassung

Das Verkaufsargument ist nicht „der Agent kann zeichnen“ – das ist seit einer Weile nichts Neues mehr. Es ist, dass archify ein Diagramm als etwas mit Schema, Validierungsrunde und Beleg behandelt: fünf Typen, die auf fünf klare Absichten abbilden, eine Eingabe, die typisiertes JSON oder vorhandenes Mermaid sein kann, eine Ausgabe, die interaktives HTML mit mehreren Exportformaten ist, und ein upstream-gepflegter Katalogeintrag, damit Ihre Kopie nie veraltet.

Wenn Sie auf der Suche nach optionalen Skills sind, gibt die Übersicht der optionalen Skills einen breiteren Blick. Zur Visualisierung allgemein siehe den 3D-Office-Beitrag und den Desktop-Skills-Hub. Die vollständige Befehlsfläche zum Installieren, Vertrauen und Verwalten von Skills steht in der hermes skills-Referenz.