Schnellstart-Leitfaden

Dieser Leitfaden hilft Ihnen, Ihr erstes Architekturdiagramm in Archyl in nur wenigen Minuten zu erstellen.

Schritt 1: Konto erstellen

  1. Gehen Sie zu app.archyl.com
  2. Registrieren Sie sich mit Ihrer E-Mail oder verbinden Sie sich mit GitHub, GitLab oder Bitbucket
  3. Verifizieren Sie Ihre E-Mail, wenn Sie sich per E-Mail registriert haben

Nach der Anmeldung landen Sie im Dashboard — Ihrer Kommandozentrale für alle Projekte:

Das Archyl-Dashboard: Projekte, Systeme, Container und Architektur-Analysen auf einen Blick

Schritt 2: Ihr erstes Projekt erstellen

  1. Klicken Sie auf "Neues Projekt" in Ihrem Dashboard
  2. Geben Sie einen Namen für Ihr Projekt ein (z.B. "Meine E-Commerce-Plattform")
  3. Fügen Sie optional eine Beschreibung und Tags hinzu
  4. Klicken Sie auf "Projekt erstellen"

Der Dialog zum Erstellen eines neuen Projekts

Schritt 3: Ihr erstes System hinzufügen

  1. In Ihrem neuen Projekt starten Sie auf der Systemkontext-Ebene
  2. Klicken Sie auf den "+"-Button oder rechtsklicken Sie auf die Leinwand
  3. Wählen Sie "System hinzufügen"
  4. Geben Sie einen Namen ein (z.B. "E-Commerce-Plattform")
  5. Fügen Sie eine Beschreibung hinzu, was das System macht

Schritt 4: Externe Systeme hinzufügen

Echte Systeme existieren nicht isoliert. Fügen Sie externe Systeme hinzu, mit denen Ihre Software interagiert:

  1. Klicken Sie auf "+" und wählen Sie "Externes System hinzufügen"
  2. Fügen Sie Systeme wie "Zahlungs-Gateway", "E-Mail-Dienst", "CDN" hinzu
  3. Diese erscheinen mit einem anderen Stil, um zu zeigen, dass sie extern sind

Schritt 5: Beziehungen erstellen

Zeigen Sie, wie Systeme kommunizieren:

  1. Klicken Sie auf das Quellsystem
  2. Ziehen Sie vom Verbindungspunkt zum Zielsystem
  3. Fügen Sie ein Label hinzu, das die Beziehung beschreibt (z.B. "Verarbeitet Zahlungen über API")

So sieht eine vollständige Systemkontext-Ansicht aus — Personen, Systeme und externe Anbieter, verbunden durch beschriftete Beziehungen:

Ein vollständiges Systemkontext-Diagramm mit beschrifteten Beziehungen

Klicken Sie auf ein beliebiges Element, um seine Details zu öffnen — Beschreibung, Verantwortliche, verknüpfte Entscheidungen, Dokumentation und API-Verträge:

Der Detailbereich eines Elements neben der Live-Leinwand

Schritt 6: In Container eintauchen

Doppelklicken Sie auf Ihr Hauptsystem, um auf die Container-Ebene zu gelangen:

  1. Fügen Sie Container wie "Webanwendung", "API-Server", "Datenbank" hinzu
  2. Zeigen Sie, wie sie miteinander kommunizieren
  3. Verbinden Sie sie mit externen Systemen

Schritt 7: Ihren Coding-Agenten verbinden

Sobald Sie ein Projekt haben, zeigt das Dashboard einen Block Lassen Sie Ihre Agenten arbeiten mit drei Schritten. Sie werden automatisch abgehakt, sobald Archyl den jeweiligen Schritt erkennt.

  1. Klicken Sie auf Coding-Agenten verbinden. Wählen Sie im sich öffnenden Fenster Ihr Tool (Claude Code, Cursor, VS Code oder OpenAI Codex) und klicken Sie auf Schlüssel erstellen.
  2. Fügen Sie ein, was das Fenster Ihnen anzeigt: einen einzeiligen Befehl für Claude Code, eine Konfigurationsdatei für die anderen. Der Schlüssel ist bereits enthalten, und die Server-URL wählt das Tool-Profil für Coding, eine kleine Auswahl an Tools, die für Coding-Agenten gebaut sind.
  3. Starten Sie Ihren Agenten neu und bitten Sie ihn, Ihre Archyl-Projekte aufzulisten. Das Fenster zeigt Ihr Agent ist verbunden, sobald der erste Aufruf eintrifft.
  4. Geben Sie dem Agenten eine erste Aufgabe. Das Fenster schlägt einen Prompt vor, mit dem er plan_work aufruft und dann unter dem Harness eine Arbeitssitzung öffnet, bevor er Code ändert. Auch das Starten eines verwalteten Agentenlaufs in Archyl schließt diesen Schritt ab.

Um den Block auszublenden, klicken Sie auf das Kreuz in seiner Ecke. Die vollständige Liste der unterstützten Tools und ihrer Einstellungen finden Sie in Ihrem Profil unter MCP-Server.

Nächste Schritte

Herzlichen Glückwunsch! Sie haben Ihr erstes Architekturdiagramm erstellt. Hier ist, was Sie als Nächstes erkunden können:

Tipps für den Erfolg

  • Beginnen Sie auf hoher Ebene: Starten Sie mit dem Systemkontext, bevor Sie in Details eintauchen
  • Verwenden Sie klare Namen: Benennen Sie Systeme und Container beschreibend
  • Fügen Sie Beschreibungen hinzu: Ihr zukünftiges Ich (und Ihr Team) wird es Ihnen danken
  • Iterieren Sie: Architektur-Dokumentation ist lebendig - aktualisieren Sie sie, wenn sich Ihr System weiterentwickelt