Archify erzeugt überprüfbare Systemarchitekturdiagramme

Hintergrund

Wenn Entwickler KI-gestützte Tools nutzen, um Systemarchitekturen zu visualisieren, stößt die Branche auf ein langjähriges Problem: Agenten erzeugen Diagramme häufig probabilistisch und erfinden dabei Komponenten, Verbindungen oder Routen, die so nie existiert haben. Diese Darstellungen wirken professionell, lassen sich aber nicht verifizieren. Sobald sie in Code-Reviews oder im teamübergreifenden Austausch landen, können sie Entscheidungen in die Irre führen. Genau hier setzt Archify (tt-a1i/archify) an. Das Projekt ist ein Node.js-Rendering- und Validierungssystem, das sich als Agent-Skill in Cursor, Claude Code, Codex CLI und OpenCode einbettet und aus Codebasen oder simplen Systembeschreibungen interaktive, überprüfbare Systemkarten macht.

Archify positioniert sich an der Schnittstelle zwischen der "Architecture-as-Code"-Bewegung und der Coding-Agent-Toolchain. Primär in JavaScript geschrieben, wird es unter Kategorien wie agent-skills, architecture-diagram und coding-agents geführt und befindet sich im Entwicklungsversion v2.17.0-dev.1. Die wachsende Aufmerksamkeit auf GitHub spiegelt ein echtes Interesse an gerade diesem Nischenthema wider: überprüfbaren Architekturdiagrammen. Damit bedient das Projekt zugleich die Zeichenfähigkeit der Agenten und das Vertrauen der Menschen in die Glaubwürdigkeit der Ergebnisse.

Tiefenanalyse

Der Kern von Archify entkoppelt Zeichnen von Validierung. Der Agent muss zunächst eine typisierte JSON-Zwischenrepräsentation erzeugen, die das System dann deterministisch in HTML oder SVG kompiliert. Die Grafik ist damit kein freies Produkt des Modell-Sampling mehr, sondern das ergebnis von Typ- und Prüfungen. Daraus ergeben sich vier erkennbare Fähigkeiten. Erstens das sofortige Präsentieren: fünf Diagrammtypen, vier Presets, dunkle und helle Themen sowie dezent animierte Elemente machen die Bilder sowohl für Chat-Fenster als auch für formale Präsentationen geeignet.

Zweitens das Prüfen von Architekturänderungen vor dem Zusammenführen. Das System vergleicht zwei validierte Snapshots im Before-/Delta-/After-Format und meldet präzise Additionen, Entfernungen, Änderungen, Verschiebungen und Neuroutungen, womit die Architekturentwicklung nachvollziehbar wird. Drittens jede Interaktion auf Faktenbasis: Knotensuche, optionales Öffnen überprüfter Quellen, das Nachverfolgen stromaufwärts- und stromabwärtsreichbarer Pfade sowie der semantische Rollenvergleich und die geführte Story-Wiedergabe erfinden keine Topologie. Viertens das vertrauenswürdige Teilen in einer Datei: der typisierte IR und die deterministischen Prüfungen erzeugen ein selbständiges HTML, das sich als PNG, SVG, WebM oder 1200x630-Teilkarte exportieren lässt.

Branchenwirkung

Die größere Bedeutung von Archify liegt darin, dass es das Ingenieurprinzip der Verifizierbarkeit in den Bereich des Diagrammzeichnens trägt, der historisch der am wenigsten kontrollierbare Teil von KI-Ausgaben war. Für Entwicklergemeinschaften bietet es ein Paradigma, KI-Ausgaben als überprüfbare Artefakte zu behandeln. Für Engineering-Teams dienen der Architekturänderungsvergleich vor dem Zusammenführen und das Erreichbarkeitsverfolgen direkt dem Code-Review und dem Risikomanagement. Als Beleg für die reale Verankerung zeigt das Projekt eine aus dem tatsächlichen Repository mco-org/mco an einer bestimmten Commitsstelle zurückverfolgte Architekturkarte, ergänzt durch Erreichbarkeitsverfolgung und typisierte Quellen.

Das Tool birgt zugleich beobachtbare Risiken. Wenn die Glaubwürdigkeit stark von den Typ-Constraints und Validierungsregeln des IR abhängt, können diese Regeln Lücken aufweisen oder der Agent kann sich bei der IR-Erzeugung vom Faktum abwenden, was die Validierung zur Formalität werden lässt. Zudem eliminiert die deterministische Kompilierung die Zufälligkeit, garantiert aber nicht, dass die Topologiebeschreibung exakt mit dem echten Code übereinstimmt; kritische Pfade bedürfen weiterhin manueller Prüfung.

Ausblick

Beobachtungswürdige Richtungen umfassen, ob Validierungszertifikate zum Standard in Team-Workflows werden, ob semantischer Rollenvergleich und geführte Geschichten die teamübergreifende Kommunikation weiter senken und ob das Tool von weiteren Coding-Agenten und CI-Pipelines übernommen wird.

Archify verkörpert einen pragmatischen Weg: Es verfolgt nicht schickeres Zeichnen, sondern vertrauenswürdiges. Je weiter sich das Architecture-as-Code-Ökosystem entwickelt, desto mehr könnte der determinismusbasierte Ansatz einen Maßstab dafür setzen, wie agentengenerierte Diagramme künftig validiert, überprüft und geteilt werden.