Was ist Archify?
Archify ist ein Agent-Skill für Claude Code, Codex CLI, Cursor und OpenCode, der den Agenten eine typisierte JSON-Beschreibung eines Diagramms schreiben lässt, sie validiert und eine eigenständige, interaktive HTML-Datei rendert. Es deckt zehn Diagrammtypen ab (Architektur, Workflow, Sequenz, Datenfluss, Lebenszyklus, ERD, Klassen, Baum, Zeitleiste und Wasserfall) sowie einseitige Erklärseiten, die die Antwort zuerst nennen und nummerierte Quellen zitieren.
Im Viewer können Leser einen Knoten fokussieren, Beziehungen nach oben oder unten verfolgen, einen Pfad hervorheben, das Theme wechseln und PNG, WebP, JPG oder Share-Karten exportieren. Soll es ein Repository lesen, können Architekturknoten auf Dateien und Zeilenbereiche verlinken, die an einen öffentlichen Commit gebunden sind. Installiert wird es, indem man den Agenten auf eine llms.txt-Datei verweist, oder über npx skills.
Das Repo, im April 2026 angelegt, hat etwa 92.100 GitHub-Sterne und steht jetzt unter Apache-2.0; frühere Releases behalten ihre ursprüngliche MIT-Lizenz. Das neueste Release ist v3.2.0 (19. Oktober 2026).
Lohnt sich Archify?
Der eigentliche Beitrag von Archify ist Validierung, nicht Schönheit. Die meisten Diagramm-Tools für Agenten verlangen vom Modell Mermaid oder SVG und hoffen auf das Beste; Archify lässt den Agenten eine typisierte JSON-Quelle schreiben, prüft Schema, Layout, Pfade und Abstände der Beschriftungen und ersetzt die vorherige Ausgabe erst, wenn alle Prüfungen bestanden sind. Schlägt eine Prüfung fehl, liefert validate --json einen Regelcode und die konkret erlaubten Korrekturen, sodass der Agent eine Sache korrigiert, statt das ganze Bild neu zu erzeugen. Grundsätzlich bleiben spätere Überarbeitungen so stabiler, als wenn jedes Mal freie Ausgabe neu erzeugt wird.
Das Ergebnis ist eine einzige HTML-Datei ohne Laufzeit, die man installieren müsste. Ein Leser kann alles verfolgen, was von einem Dienst abhängt, den Weg von der Web-App zur Datenbank untersuchen oder die Rollen von Backend und Datenbank vergleichen, und die Interaktionen nutzen nur Beziehungen, die der Autor deklariert hat, statt Laufzeitauswirkungen abzuleiten. Der Repository-Modus ist der nützliche Kniff für Entwickler: Belegte Knoten öffnen genau die Dateien und Zeilenbereiche an einem fixierten Commit, sodass ein Reviewer die Karte mit dem Code abgleichen kann.
Das Gewicht liegt an den Rändern. Das Projekt ist von MIT zu Apache-2.0 gewechselt, liefert schnell (fünf Releases zwischen Ende September und Mitte Oktober 2026) und führt eine optionale Update-Prüfung aus, die etwa einmal am Tag den eigenen Server anpingt, sofern du nicht ARCHIFY_UPDATE_CHECK_DISABLED=1 setzt; laut README werden keine Projektdaten gesendet. Der Sponsorenbereich bewirbt mehrere API-Relay-Dienste von Drittanbietern, die Zugang zu Claude, OpenAI und Gemini für wenige Prozent der offiziellen Preise anbieten. Das sagt nichts über den Code von Archify aus, ist aber eine seltsame Nachbarschaft für ein Entwicklerwerkzeug, und man klickt besser nicht darauf.
Gegenüber einer handgeschriebenen Mermaid-Datei verlangt Archify mehr vom Agenten und liefert etwas weit Reichhaltigeres; gegenüber diagram-design oder fireworks-tech-graph ist es die durchdachtere Option, mit einem Validator und einem Viewer-Vertrag statt eines Styleguides. Mermaid-Parsing, Auto-Layout, gehostetes Teilen und Drag-and-drop-Bearbeitung sind bewusst nicht vorgesehen, es ergänzt also ein Whiteboard, statt es zu ersetzen.
Wo es sich lohnt
Eine Staff Engineer, die drei neue Kollegen in ein Backend mit 40 Diensten einarbeitet
Eine durch den Code belegte Laufzeit-Architekturkarte des Repos erstellen
Lass den Agenten das Repository analysieren und mit Archify 8 bis 12 Kernkomponenten zeichnen; belegte Knoten verlinken auf die Dateien an einem fixierten Commit, und das HTML kommt ins Onboarding-Dokument. Kostenlos; die Kosten sind ein paar Agentenrunden an Tokens.
Ein SRE, der eine Incident-Analyse schreibt
Zeigen, was passiert ist und wo die Zeit verloren ging
Erzeuge eine Zeitleiste aus Log-Zeitstempeln und einen Wasserfall aus Trace-Spans und teile die einzelne HTML-Datei. Das Projekt warnt, dass Zeiten nur dann echt sind, wenn sie aus deinen Logs oder Traces stammen.
Eine Produktmanagerin, die eine Architekturänderung prüft
Sehen, was ein vorgeschlagenes Design hinzufügt, entfernt und verschiebt
Der Befehl compare rendert ein Architecture Delta zwischen zwei JSON-Snapshots; Reviewer gehen die deklarierten Änderungen durch, Risiko oder Merge-Sicherheit leitet es aber nicht ab.
Bevor du dich festlegst
- Einrichtung
- Sag dem Agenten, er soll Archify aus seiner llms.txt installieren, oder führe npx -y skills@latest add https://archify.si --skill archify --agent cursor --global --copy --yes aus. Node.js führt den mitgelieferten Renderer und Validator aus; das erste Diagramm braucht einen Prompt.
- Integrationen
- Claude Code, Codex CLI, OpenCode und Cursor mit vollem Renderer; Skill-Upload in Claude.ai; Community-Integrationen für Hermes Agent und DeepSeek Harness. Exportiert PNG, WebP, JPG, Share-Karten und Druck als PDF.
- Daten und Datenschutz
- Läuft lokal; das erzeugte HTML ist eigenständig. Eine optionale Update-Prüfung ruft etwa alle 24 Stunden per GET ein Manifest vom Server des Projekts ab, nur mit normalen HTTP-Metadaten; ARCHIFY_UPDATE_CHECK_DISABLED=1 schaltet sie ab. Apache-2.0; keine Sicherheitshinweise veröffentlicht.
- Kosten im großen Maßstab
- Keine kostenpflichtige Edition. Die Kosten sind Agenten-Tokens pro Diagramm und Überarbeitung, plus der Modell-Tarif, den dein Coding-Agent nutzt.
- Grenzen
- Etwa 270 offene Issues; kein Mermaid-Parsing, kein allgemeines Auto-Layout, kein gehostetes Teilen und keine WYSIWYG-Bearbeitung; der Agent hat pro Diagramm zwei Korrekturrunden vor der visuellen Prüfung.
Was gut ist
- Typisierte JSON-Quelle mit Prüfung von Schema, Layout und Pfaden vor der Auslieferung
- Zehn Diagrammtypen plus Erklärseiten mit zitierten Quellen
- Interaktives HTML in einer Datei; zum Ansehen nichts zu installieren
- Repository-Knoten verlinken auf Dateien und Zeilen an einem fixierten Commit
Was nicht
- Tägliche Update-Prüfung ist aktiv, bis du sie abschaltest
- Von MIT zu Apache-2.0 umlizenziert; schneller Release-Takt
- Unter den Sponsoren im README sind API-Relay-Dienste zu Dumpingpreisen
- Keine WYSIWYG-Bearbeitung und kein Mermaid-Import
Am besten für
Entwickler und Tech Leads, die von ihrem Coding-Agenten Architektur- und Ablaufdiagramme wollen, die geprüft, interaktiv und als eine Datei teilbar sind.
Alternativen zu Archify
Archify: häufige Fragen
- Lohnt sich Archify?
- Diagramme, die sich selbst prüfen, bevor sie bei dir ankommen, und genau das hat von Agenten gezeichneten Architekturbildern bisher gefehlt. Wir bewerten es mit 4.0 von 5.
- Was kostet Archify?
- Kostenlos und Open Source (Apache-2.0; frühere Releases MIT).
- Welche Nachteile hat Archify?
- Tägliche Update-Prüfung ist aktiv, bis du sie abschaltest; Von MIT zu Apache-2.0 umlizenziert; schneller Release-Takt; Unter den Sponsoren im README sind API-Relay-Dienste zu Dumpingpreisen; Keine WYSIWYG-Bearbeitung und kein Mermaid-Import.
- Für wen eignet sich Archify?
- Entwickler und Tech Leads, die von ihrem Coding-Agenten Architektur- und Ablaufdiagramme wollen, die geprüft, interaktiv und als eine Datei teilbar sind.
- Was kostet Archify für ein Team oder im Produktivbetrieb?
- Keine kostenpflichtige Edition. Die Kosten sind Agenten-Tokens pro Diagramm und Überarbeitung, plus der Modell-Tarif, den dein Coding-Agent nutzt.
- Ist Archify sicher für Firmendaten?
- Läuft lokal; das erzeugte HTML ist eigenständig. Eine optionale Update-Prüfung ruft etwa alle 24 Stunden per GET ein Manifest vom Server des Projekts ab, nur mit normalen HTTP-Metadaten; ARCHIFY_UPDATE_CHECK_DISABLED=1 schaltet sie ab. Apache-2.0; keine Sicherheitshinweise veröffentlicht.
- Was sind die besten Alternativen zu Archify?
- Die nächsten Alternativen, die wir getestet haben, sind Diagram Design, fireworks-tech-graph und Anatomy.
Antworten geprüft am 31. Okt. 2026.