VISION & ROADMAP

Architecture-first
Agentic Engineering

KI-Agenten verändern, wie wir Software schreiben. ArchKeel verändert, wie wir ihre Architektur entwerfen, kontrollieren und weiterentwickeln.

KI kann Code schreiben. Architektur sollte kein Zufall sein.

Deterministische Grundlage verfügbar. Kollaboratives Studio geplant.

ArchKeel-Konzept: Mensch und KI entwerfen ein gemeinsames Target. Booking API, Domäne und privater Store liegen innerhalb der akzeptierten Grenze; eine zusätzliche Beziehung ist ein Vorschlag mit ausstehendem Review.
Ein gemeinsames Target. Gemeinsam entwerfen, freigeben und innerhalb der Grenzen bauen.

Gemeinsam entwerfen. Innerhalb klarer Grenzen bauen. Entscheidungen hinterfragen. Bewusst weiterentwickeln.

01 / GEPLANT

ArchKeel Studio.

Ein gemeinsamer Arbeitsbereich für den menschlichen Architekten und einen leistungsfähigen KI-Agenten: am Whiteboard entwerfen, im Chat Alternativen diskutieren und die resultierende Target-Änderung vor der Übernahme reviewen.

Interaktives Konzept · geplant

Ansichten wechseln, Komponenten auswählen oder den Änderungsvorschlag öffnen. Illustrative Daten; kein Live-Agent und keine Vertragsänderungen.

Booking Platform⌄
AAI
Target-Architekturv1···
BOOKING / AKZEPTIERTE GRENZE
Nicht deklarierter API → Store-Zugriff
Booking domainBuchungen entscheiden. Persistenz und Zustellung hinter deklarierten Schnittstellen halten.
Akzeptiert Vorschlag
Target v1 · 1 Vorschlag offen Illustrative Zusammenarbeit
Konzeptansicht mit illustrativen Daten.

VORGESCHLAGENES TARGET-AMENDMENT

Eine sichtbare Entscheidung.
Eine konkrete Regeländerung.

Konzept · Architektenreview ausstehend

Booking domain darf die Zustellung über eine öffentliche Schnittstelle anfordern. Bis der verantwortliche Architekt das Amendment akzeptiert, bleibt Target v1 verbindlich.

Target v1 → vorgeschlagenes v2+ Booking domain → Notifications.public Booking store bleibt privat Kein direkter Zugriff: Booking API → Booking store

Fragen vor der Freigabe

  • Was passiert bei einem Zustellfehler?
  • Welche Wiederholungen und Idempotenzgarantien sind erforderlich?
  • Welche Checks müssen den geänderten Vertrag prüfen?

Dieses Konzept zeigt den Review. Es gibt keinen Architektur Contract frei und schreibt keinen Vertrag.

Whiteboard und Chat. Ein Architekturmodell.

Beide geplanten Bearbeitungsoberflächen arbeiten über den bestehenden Architecture Contract. Canvas-Positionen sind Darstellung. Vorgeschlagene Komponenten, Schnittstellen und Erlaubnisse sind Vertragsänderungen und brauchen Review.

Der akzeptierte Architecture Contract bleibt verbindlich. Ein Agentenvorschlag wird erst zum Target, wenn der verantwortliche Architekt ihn annimmt.

Mit dem Zweck beginnen

Anforderungen, Randbedingungen und Entscheidungen festhalten, die menschliches Urteil brauchen.

Direkt auf dem Canvas arbeiten

Komponenten verschieben und verbinden; Verantwortlichkeiten und Schnittstellengrenzen untersuchen.

Alternativen diskutieren

Einen KI-Architekten Abwägungen erklären und eine konkrete Änderung vorschlagen lassen.

Gezielt verfeinern

In Module, Interfaces und Klassen eintauchen, sobald der Entwurf diese Details braucht.

02 / RÜCKKOPPLUNG MIT REVIEW

Architektur darf sich ändern.
Die Entscheidung bleibt sichtbar.

Ein Coding-Agent kann einen guten Grund entdecken, das Design zu ändern. Der Entwicklungsablauf sollte diesen Befund mit Belegen, Alternativen und Folgen an den Architekten zurückgeben.

Wähle einen Prüfpunkt oder Rückweg, um seine Verantwortung zu sehen.

Mensch + KI-Architekt

Entwurf & Review

Zweck, Komponenten, Verantwortlichkeiten und Schnittstellen festlegen. Annahmen festhalten, für die noch Belege fehlen. Grenzen und Alternativen prüfen. Sicherstellen, dass das Target das beabsichtigte System beschreibt.

A / IMPLEMENTIERUNG VERLETZT DAS TARGET

Implementierung korrigieren.

Den akzeptierten Vertrag beibehalten. Die verbotene Verbindung entfernen oder die deklarierte Schnittstelle wiederherstellen. Danach erneut prüfen.

B / ARCHITEKTUR BRAUCHT EINE ÄNDERUNG

Amendment reviewen.

Eine exakte Regeländerung mit Begründung und Folgen vorschlagen. Der Architekt entscheidet; ein akzeptiertes Amendment legt das nächste Target fest.

Das ist der beabsichtigte Gesamtablauf. CLI-Validierung und Amendments gibt es heute; Studios kollaborative Bearbeitung und Review-Oberfläche sind geplant.

03 / ABSICHT VOR IMPLEMENTIERUNG

Warum Architecture-first?

Ein Coding-Agent arbeitet an der Aufgabe, die gerade vor ihm liegt. Über viele Änderungen können lokal sinnvolle Entscheidungen zu einem System führen, das niemand bewusst entworfen hat. Verhaltenstests können weiter bestehen, während Zuständigkeiten und Abhängigkeitsgrenzen aufweichen.

Architecture-first Engineering macht diese Entscheidungen explizit und verfeinert sie schrittweise. ArchKeel übersetzt unterstützte Teile dieser Absicht in ausführbare Regeln. Dein Harness oder CI-Workflow führt die Checks aus und entscheidet, ob eine Änderung weiter darf.

AnsatzWoher die Architektur kommtWas bewussten Review braucht
Vibe CodingArchitektur entsteht, während Prompts und Implementierung weiterentwickelt werden.Die entstandene Struktur und ihre übernommenen Annahmen.
Architecture-first EngineeringMenschen und Agenten entwerfen Zuständigkeiten und Grenzen und verfeinern sie mit neuen Erkenntnissen.Abwägungen, Zuständigkeiten und vorgeschlagene Änderungen am Target.
ArchKeels BeitragEin versionierter Vertrag macht unterstützte Architekturregeln gegen den Code prüfbar.Verletzungen, fehlende Belege und exakte Änderungen der akzeptierten Regeln.
Wie das in einen Agent-Harness passt

04 / HEUTE VERFÜGBAR

Eine Grundlage, die du prüfen kannst.

ArchKeel ist ein Open-Source-Werkzeug für deterministische Architekturprüfung. Es vergleicht statischen Code mit einem unabhängig deklarierten Target und liefert Belege für Menschen, Coding-Agenten und CI.

Am 10. Oktober 2026 gegen Release 1.1.1 und den aktuellen Main-Stand geprüft. Release 1.1.1 · Geprüfter Main-Stand

01

Ausführbare Architekturverträge

Deklariere Komponenten, Verantwortlichkeiten, Schnittstellen und erlaubte Abhängigkeiten in einem versionierten Vertrag. Die Absicht bleibt reviewbar, während sich die Implementierung verändert.

Vertrag und Regelreferenz
02

Deterministische Architekturprüfung

Führe lokale Checks ohne LLM aus. Verbotene Imports, falsch platzierte Typen und weitere unterstützte Verletzungen werden innerhalb des dokumentierten Laufzeit- und Analyseumfangs reproduzierbare Befunde.

Validierung und Prüfumfang
03

As-Is / Target / Diff

Erkunde beobachteten Code, deklarierte Absicht und ihre Unterschiede in einem Report. Es sind Ansichten eines Snapshots. Ein Diagramm wird dadurch nicht stillschweigend zur Erlaubnis.

Echte Demos erkunden
04

Verschachtelte Architektur und UML

Navigiere durch verschachtelte Komponenten, Module und unterstützte Klassen-, Interface-, Member- und Beziehungsdeklarationen. Fehlende oder unvollständige Belege bleiben sichtbar.

UML-Demos und Abdeckung
05

Python, TypeScript und Dart

Analysiere alle drei über die Python-Installation. TypeScript liefert lexikalische UML und begrenzte statische Beziehungen; Dart benötigt für die Analyse kein SDK. Die Sprachprofile haben unterschiedliche Grenzen.

Sprachprofile und Grenzen
06

Reports für Agenten und CI

Frage eine kompakte Architekturübersicht, gezielte Befunde und Quellbelege ab. Codex-/Claude-Skills und CLI-Gates verbinden die Ergebnisse mit deinem Entwicklungsablauf.

Agent-Setup und Integration
07

Kontrollierte Architekturänderungen

Vergleiche die Regeln mit einem reviewten Basisstand. Erweiterte Erlaubnisse benötigen ein explizites Amendment für das exakte Regelpaar. Freigaberechte und geschützte CI bleiben Aufgaben deines Workflows.

Target-first und Amendments
08

Belege für PASS / FAIL / UNKNOWN

Unterscheide belegte Konformität, entschiedene Verletzungen und fehlende Belege. Filter erhalten globale Ergebnisse. Ein erfolgreicher Report-Befehl allein bedeutet keine Entwarnung.

Ergebnisse richtig lesen

Echte Explorer-Ansichten. Deklarierte Absicht auf zwei Ebenen.

Originale Repository-Screenshots aus 1.1.1. Öffne eine Ansicht für die veröffentlichte interaktive Demo. Für diese Quellprojekte bleiben dokumentierte Analyselücken bestehen.

Architekturprüfung ergänzt Laufzeittests. Sie beweist weder Laufzeitverhalten noch Designqualität oder vollständige Sprachsemantik. Ein eingetragener Architektenname dokumentiert Urheberschaft, keine authentifizierte Freigabe.

05 / PRODUKT-ROADMAP

Auf Belegen aufbauen.
Gemeinsam weiter entwerfen.

Die Reihenfolge beschreibt die Produktrichtung. Geplante Phasen haben keinen versprochenen Releasetermin. Bestehende UML- und Amendment-Mechanismen bilden eine Grundlage für die neue Bearbeitungsoberfläche.

  1. 01

    HEUTE

    Verfügbar

    Grundlage

    Ausführbare Verträge, deterministische Checks, As-Is / Target / Diff und klar abgegrenzte Belege.

    Release 1.1.1
  2. 02

    ALS NÄCHSTES

    Geplant

    Interaktive Bearbeitung

    Typisierte Target-Vorschläge, direkte Canvas-Bearbeitung, semantische Vorschau und explizite Freigabe.

    Studio-Konzept lesen
  3. 03

    DANACH

    Geplant

    KI-Zusammenarbeit

    Chat und Whiteboard auf einem Vertrag, ein KI-Architekturassistent und ein reviewter Weg für Architekturfragen.

    Entwicklungsablauf ansehen
  4. 04

    ZIEL

    Langfristige Vision

    Architecture-first Agentic Engineering

    Schrittweiser Entwurf von Komponenten bis zu Interfaces und Klassen, kontinuierliche Prüfung und kontrollierte Architekturentwicklung.

    Verwandte Target-Arbeit · #340

Verwandte Grundlagenarbeit: innere Target-Abdeckung (#340) und UML-Demo-/Browser-Abnahme (#339). Diese Issues betreffen bestehende Analyse- und Report-Arbeit; sie sind keine Studio-Lieferzusagen. #340 · #339 · GitHub Roadmap

06 / SO WOLLEN WIR BAUEN

Menschliche Kontrolle bleibt explizit.

01

Menschliches Urteil. KI beschleunigt.

Agenten untersuchen und implementieren Optionen. Menschen entscheiden, welche Abwägungen das System tragen soll.

02

Architektur ist eine Entscheidung, kein Zufall.

Verantwortlichkeiten und Grenzen festhalten, bevor man sich darauf verlässt. Den Entwurf mit neuen Belegen verfeinern.

03

Agenten schlagen vor. Architekten entscheiden.

Eine vorgeschlagene Verbesserung braucht sichtbaren Review und eine verantwortliche Entscheidung, bevor sie das Target verändert.

04

Vertrauen braucht Belege.

Aussagen mit dem geprüften Code, den Regeln und den Ergebnissen verbinden. Unsicherheit sichtbar halten.

Fragen zur Vision

Ist ArchKeel Studio heute verfügbar?

Nein. Whiteboard und dialogbasierter Architekturassistent sind eine geplante Erfahrung. Release 1.1.1 bietet CLI, Architekturverträge, Validierung und Explorer-Reports.

Darf ein KI-Agent die Architektur ändern?

Agenten können Grenzen und Amendments vorschlagen. Der Workflow muss kontrollieren, wer Regeländerungen akzeptiert, und Vertrag sowie Gates schützen. ArchKeel prüft deklarierte Regeln; es ist keine Agent-Sandbox.

Muss vor dem Coding die komplette Architektur feststehen?

Nein. Beginne mit den relevanten Grenzen und verfeinere Module, Interfaces und Klassen schrittweise. Unvollständige Absicht und fehlende statische Belege müssen sichtbar bleiben.

Wie hilft ArchKeel gegen Architekturdrift?

ArchKeel vergleicht Code mit dem deklarierten Vertrag und kann nicht freigegebene Erweiterungen von Erlaubnissen gegen einen reviewten Basisstand ablehnen. Verpflichtende CI-Gates reagieren auf diese Befunde; Verhaltenstests und menschlicher Review prüfen andere Fragen.

ARCHKEEL / OPEN SOURCE

Baue mit bewusster Architektur.

Nutze die Grundlage heute. Gestalte die nächste Bearbeitungsoberfläche mit.

Vision von Alexander Kell · Entwickler von ArchKeelVeröffentlicht am 10. Oktober 2026