NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Landkarte mit Netzwerkknoten, Wegweiser Archify und grünem Prüfstempel

Was ist Archify?

Archify ist eine Open Source Agent Skill, die aus einer Systembeschreibung oder einer Codebase ein interaktives Diagramm baut. Der Coding Agent schreibt typisiertes JSON, Archify kompiliert daraus deterministisch eine einzelne HTML Datei mit Inline SVG.
Das Projekt liegt unter MIT Lizenz auf GitHub und läuft mit Node.js. Unterstützt werden fünf Diagrammtypen: Architecture, Workflow, Sequence, Data Flow und Lifecycle. Als Agents sind Cursor, Claude Code, Codex CLI und OpenCode vorgesehen.
Der Unterschied zu klassischen Diagramm Tools liegt in der Prüfung. Bevor ein Artefakt ausgeliefert wird, laufen Schema, Layout, HTML, Route und Label Checks durch. Fällt einer durch, bleibt die letzte gültige Datei stehen und der Agent bekommt einen maschinenlesbaren Fehlerbericht statt eines Stacktrace.

Inhalt

Archify mit NCA: Diagramme, die im Review standhalten

Wir arbeiten täglich mit Coding Agents und wissen, wo Diagramme aus KI Hand kippen. Ein Agent malt gern Pfeile, die es im Code nicht gibt. Archify dreht das um: Struktur zuerst als typisiertes JSON, dann die Prüfung, dann erst das Bild. Genau diese Reihenfolge predigen wir seit Jahren bei Quality Gates, nur eben für Code.
Wir helfen Teams beim Vibe Coding Consulting, richten OpenCode als Coding Agent ein und zeigen, wie Agent Skills sauber im Projekt landen. Für Architekturdokumentation ordnen wir Archify gegen PlantUML ein. Wer wissen will, was im eigenen Repo wirklich steckt, startet mit einem Codebase Audit und automatisiert danach das KI Code Review.

Archify im Team einführen

Finde das passende Angebot für dein Projekt

Anfrage-Konfiguration

Starten Sie Ihre Anfrage

Projektart
Infos
Nachricht

Eliminierung technischer Schulden mit PHPStan, Rector PHP und PHPUnit. Über 20 Jahre Praxiserfahrung in skalierbaren Backends.

CORE EXPERTISE

Gesetzliche Konformität & Inklusion. Optimierung von Performance und Conversion durch radikal nutzerzentriertes, universelles Design.

BFSG COMPLIANT

Skalierbare KI-Systeme mit echtem Code Ownership. CI/CD, Backup-Strategien und Infrastruktur, die mit deinem Team wächst.

ENTERPRISE READY

Archify installieren und den ersten Prompt absetzen

Die Installation läuft über den Skills Installer. Global für alle Projekte reicht ein Befehl:
Code: 
          
npx skills add tt-a1i/archify -g
Wer nur einmal reinschauen will, nutzt den Weg ohne Installation. Der Agent bekommt die Skill für die laufende Sitzung:
Code: 
          
npx skills use tt-a1i/archify@archify --agent codex
Danach genügt eine normale Beschreibung im Chat. Ein Repository ist nicht nötig, ein Satz reicht für das erste Diagramm.
Code: 
          
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
Mit Repo wird es interessanter. Dann analysiert der Agent den Code und markiert Knoten auf Wunsch mit Quellenbezug: evidenzgestützte Knoten tragen ein Kürzel und öffnen die passende Datei samt Zeilenbereich, festgenagelt auf einen Commit. Wer das nicht anfordert, bekommt ein Diagramm ganz ohne Quellenverweise.
Nachbessern läuft im Dialog. Kurze Anweisungen wie add Redis oder highlight the rollback path reichen, weil die typisierte Quelle erhalten bleibt und der Agent gezielt nur diesen Teil ändert.

Fünf Diagrammtypen und wann welcher passt

Archify kennt fünf Modi. Der Agent wählt anhand der Frage, du kannst den Typ aber auch direkt vorgeben. Die Tabelle zeigt, was jeweils in den Prompt gehört, damit das Ergebnis brauchbar wird.
Diagrammtyp Passt für Gehört in den Prompt
Architecture Komponenten, Services, Speicher, Trust Boundaries Scope, Kernkomponenten, Hauptpfad
Workflow CI/CD, Freigaben, Tool Calls, Runbooks Beteiligte, Reihenfolge, Verzweigungen, Ausnahmen
Sequence API Calls, Cache Fallback, Auth, asynchrone Traces Aufrufer, Aufgerufene, Rückgaben, Timing
Data Flow Pipelines, Lineage, personenbezogene Daten, Consumer Quellen, Transformationen, Speicher, Grenzen
Lifecycle Zustände, Retries, Wartezeiten, Endzustände States, Events, Retry und Abbruchpfade

Validierung statt Vertrauen: der Delivery Gate

Der eigentliche Wert von Archify steckt in der Prüfkette. Der Agent schreibt keine HTML Datei, er schreibt JSON. Erst die Kommandozeile rendert daraus ein Kandidatenartefakt, prüft es und ersetzt die Zieldatei nur dann, wenn alle Checks bestehen. Fällt etwas durch, bleibt die letzte gültige Datei liegen.
Code: 
          
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json
Geprüft werden Schema, Layout, HTML und SVG, Routen und der Abstand zwischen Beschriftung und Linie. Bei einem Fehler kommt kein Node Stacktrace zurück, sondern ein JSON Objekt mit stabilem Regelcode, dem betroffenen Element, der gemessenen Evidenz und den erlaubten Korrekturen. Der Agent rät also nicht, er repariert gezielt.
Zusätzlich gibt es einen Browser Check, der die ausgelieferte Datei misst und Screenshots sammelt, ohne sie neu zu rendern. Das Projekt trennt die drei Aussagen sauber: deterministische Artefaktprüfung, Verhalten im echten Browser und optische Bewertung durch einen Menschen. Diese Trennung ist der Grund, warum das Tool im Review überhaupt etwas wert ist.

Architecture Delta: Architekturänderungen vor dem Merge sehen

Für Reviews vergleicht Archify zwei geprüfte Stände und stellt sie als Before, Delta und After nebeneinander. Der Bericht listet, was hinzugekommen, entfernt, geändert, verschoben oder umgeleitet wurde.
Code: 
          
node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json
Wichtig ist, was das Tool bewusst nicht behauptet. Es leitet kein Risiko ab, keine Auswirkung auf die Laufzeit und keine Aussage über Merge Sicherheit. Es zeigt Fakten aus der Quelle. Diese Zurückhaltung ist selten und macht das Ergebnis in einer Diskussion belastbar.
Auch die Interaktion bleibt geerdet. Wer einen Knoten fokussiert, sieht Upstream und Downstream aus den beschriebenen Beziehungen, nicht aus einer Vermutung. Routen zeigen den kürzesten gerichteten Pfad, der tatsächlich in der Quelle steht. Erfundene Topologie ist ausgeschlossen, weil das Rendering nur nutzt, was im JSON steht.

Archify, PlantUML und Mermaid im Vergleich

Die drei Werkzeuge lösen unterschiedliche Aufgaben. PlantUML und Mermaid sind Textformate mit automatischem Layout und gehören in die Dokumentation im Repository. Archify verschiebt die Layoutentscheidung bewusst zum Agent und legt eine Prüfung davor. Wer Mermaid Code einwirft, bekommt kein maschinelles Umwandeln: der Agent liest die Struktur und baut das Diagramm neu auf.
Kriterium Archify PlantUML und Mermaid
Quelle Typisiertes JSON mit Schema Eigene Textsyntax
Layout Der Agent entscheidet Hierarchie und Betonung Automatisches Layout der Engine
Prüfung Schema, Layout, Routen und Labels vor Auslieferung Syntaxprüfung beim Rendern
Ausgabe Eine HTML Datei mit SVG, dazu PNG, SVG, WebM und Share Card Meist PNG oder SVG
Interaktion Suche, Routen, Reach, Rollenvergleich, geführte Kapitel Statisches Bild
Stärke bei Präsentation, Review, Onboarding Versionierte Dokumentation im Repo

Datenschutz, Betrieb und was Archify nicht kann

Der Renderer läuft lokal mit Node.js, das Ergebnis ist eine Datei ohne externe Abhängigkeiten. Es gibt einen optionalen Abgleich mit einem festen Manifest, der lediglich eine Update Erinnerung anzeigt. Dabei werden weder Version noch Projektdaten, Prompts oder Konto Kennungen übertragen. Wer auch das nicht will, setzt eine Umgebungsvariable:
Code: 
          
export ARCHIFY_UPDATE_CHECK_DISABLED=1
Die eigentliche Datenfrage liegt woanders. Nicht Archify sieht deinen Code, sondern der Coding Agent, der die Beschreibung erzeugt. Wer echte Architektur eines Kundensystems abbilden will, muss also klären, welches Modell den Kontext bekommt. Wir empfehlen Coding über souveräne europäische Anbieter oder ein lokales Modell und eine Entwicklungsumgebung mit Fakedaten.
Bewusst außerhalb des Funktionsumfangs liegen automatisches Mermaid Parsing, allgemeines Auto Layout, gehostetes Teilen und ein grafischer Editor. Archify ist kein Zeichenprogramm. Wer eine Maus und eine Leinwand sucht, ist hier falsch.

It turns technical intent into a communication artifact.

Archify README, Open Source Projekt unter MIT Lizenz – GitHub tt-a1i/archify

Archify im NCA Kontext: das Diagramm als Prüfschritt

Ein Diagramm ist bei uns kein Deko Element. Es ist die schnellste Art, Missverständnisse zwischen Team und Auftraggeber sichtbar zu machen. Genau deshalb interessiert uns an Archify weniger die Animation als die Tatsache, dass ein Artefakt erst nach bestandener Prüfung ersetzt wird. Das ist dasselbe Muster wie bei Quality Gates für KI Code, nur mit Bildern statt Tests.
Sinnvoll ist das Tool vor allem in drei Momenten. Beim Onboarding, wenn neue Leute den Hauptpfad eines Systems begreifen sollen. Im Review, wenn eine Änderung die Architektur berührt. Und im Gespräch mit Fachbereichen, wenn eine Präsentation her muss und niemand Lust auf Folienbastelei hat. Für den Alltag im Repo bleibt Text nah am Code oft die bessere Wahl.
Wir ordnen Archify als Editorial Werkzeug ein und helfen bei der Bewertung im eigenen Stack. Passende Themen dazu: Schema Based AI Coding als Prinzip hinter dem typisierten JSON, Agentic Coding Patterns für den Workflow drumherum, Fallow für Codebase Intelligence und die Modellauswahl ohne US Anbieter. Wer Diagramme in die Pipeline heben will, schaut auf Vibe Coding CI/CD Pipelines.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

E-Mail Kontakt

Häufige Fragen zu Archify

Die wichtigsten Fragen zu Installation, Diagrammtypen, Validierung, Datenschutz und der Abgrenzung zu klassischen Diagramm Tools.

Was ist Archify 2026 genau?

Archify ist eine Agent Skill unter MIT Lizenz, die aus einer Systembeschreibung ein interaktives Diagramm baut. Der Coding Agent schreibt typisiertes JSON, ein Node.js Renderer kompiliert daraus eine einzelne HTML Datei mit Inline SVG. Unterstützt werden Architecture, Workflow, Sequence, Data Flow und Lifecycle. Das Besondere ist die Prüfkette vor der Auslieferung.

Welche Coding Agents unterstützt Archify 2026?

Vorgesehen sind Cursor, Claude Code, Codex CLI und OpenCode, dazu ein Community Weg über die DeepSeek Harness und eine manuelle Installation für Raven. Der Installer legt die Skill je nach Agent im passenden Verzeichnis ab. Es gibt auch einen Upload Weg über eine ZIP Datei, dort hängt die Funktion aber davon ab, ob Node.js verfügbar ist.

Wie installiere ich Archify 2026?

Global genügt npx skills add tt-a1i/archify -g. Für einen Test ohne Installation gibt es npx skills use mit Angabe des Agents. Danach beschreibst du das System einfach im Chat, ein Repository ist nicht nötig. Wer im Repo arbeitet, lässt den Agent den Code analysieren und bekommt Knoten mit Quellenbezug, wenn er das ausdrücklich anfordert.

Ist Archify 2026 kostenlos?

Ja. Das Projekt steht unter MIT Lizenz und darf frei genutzt, verändert und weitergegeben werden. Kosten entstehen nur an anderer Stelle, nämlich beim Coding Agent und dem dahinterliegenden Modell, das die Beschreibung erzeugt. Der Renderer selbst läuft lokal mit Node.js und braucht keinen Dienst im Hintergrund.

Ersetzt Archify 2026 Mermaid oder PlantUML?

Nein, es löst eine andere Aufgabe. PlantUML und Mermaid sind Textformate mit automatischem Layout und passen gut zu versionierter Dokumentation im Repository. Archify zielt auf Präsentation, Review und Onboarding. Automatisches Mermaid Parsing liegt bewusst außerhalb des Funktionsumfangs: der Agent liest gepasteten Mermaid Code nur als Struktur und baut das Diagramm neu.

Wie verhindert Archify erfundene Diagramme?

Das Rendering nutzt ausschließlich das, was in der typisierten Quelle steht. Suche, Fokus, Routen und Rollenvergleich greifen auf beschriebene Knoten und Beziehungen zurück, nicht auf Vermutungen. Zusätzlich prüfen Validatoren Schema, Layout, Routen und Beschriftungen. Fällt ein Check durch, bleibt die letzte gültige Datei stehen und der Agent bekommt einen maschinenlesbaren Reparaturhinweis.

Was macht Architecture Delta?

Architecture Delta vergleicht zwei geprüfte Stände und zeigt sie als Before, Delta und After. Der Bericht listet, was hinzugekommen, entfernt, geändert, verschoben oder umgeleitet wurde. Das Tool leitet daraus bewusst kein Risiko, keine Laufzeitwirkung und keine Aussage zur Merge Sicherheit ab. Es zeigt Fakten aus der Quelle, die Bewertung bleibt beim Team.

Welche Exportformate bietet Archify?

Die Hauptausgabe ist eine eigenständige HTML Datei mit Inline SVG. Darüber hinaus lassen sich PNG in die Zwischenablage kopieren sowie SVG, WebM und Share Cards im Format 1200 mal 630 herunterladen. Nach dem Verfolgen einer Route gibt es eine eigene Route Share Card, die den Pfad zeigt und das Gesamtdiagramm als Kontext behält.

Sendet Archify Daten nach außen?

Der Renderer arbeitet lokal. Es gibt einen optionalen Abgleich mit einem festen Manifest, der nur eine Update Erinnerung anzeigt. Version, Agent, Projektdaten, Prompts und Kontokennungen werden dabei nicht übertragen. Wer auch diesen Aufruf unterbinden will, setzt die Variable ARCHIFY_UPDATE_CHECK_DISABLED auf 1. Die relevantere Datenfrage betrifft ohnehin das Modell hinter dem Coding Agent.

Kann ich Archify ohne Repository nutzen?

Ja. Eine Beschreibung im Chat reicht völlig, etwa ein Pfad von Browser über API und Cache bis zur Datenbank. Ein Repository brauchst du nur, wenn die Knoten mit echten Quellstellen belegt werden sollen. Dann verweisen markierte Knoten auf Dateien und Zeilenbereiche, festgenagelt auf einen Commit.

Wie ändere ich ein fertiges Diagramm?

Im Dialog mit dem Agent. Kurze Anweisungen wie einen Dienst ergänzen, ein Element nach links verschieben oder einen Pfad hervorheben genügen. Weil die typisierte Quelle erhalten bleibt, ändert der Agent gezielt einen Teil, während der Rest der Struktur stabil bleibt. Es gibt bewusst keinen grafischen Editor mit Maus und Leinwand.

Für welche Teams lohnt sich Archify?

Für Teams, die Architektur regelmäßig erklären müssen: beim Onboarding, im Review einer strukturellen Änderung oder im Gespräch mit Fachbereichen. Wer nur ein statisches Bild in die Dokumentation braucht, fährt mit einem Textformat schlanker. Wir helfen bei der Einordnung im eigenen Stack und richten den passenden Coding Agent samt Regeln ein.