Workshops: Agentic-Engineering-Praxis

Softwarearchitektur mit KI-Agenten: ADRs, C4 und Fitness Functions

Coding-Agenten erzeugen Code schneller, als ein Architekturboard ihn prüfen kann. Dieser Workshop zeigt Architektinnen, Architekten und erfahrenen Entwicklern, wie sie Agenten für die analytische Seite der Architekturarbeit einsetzen – von der Rekonstruktion der Ist-Architektur über Entscheidungsdokumente bis zu automatisierten Architekturtests. Die Verantwortung für Entscheidungen bleibt dabei klar beim Menschen.

Für wen ist der Workshop?

  • Software- und Solution-Architektinnen und -Architekten
  • Tech Leads und Senior Engineers, die im Team Architekturentscheidungen treffen
  • Staff und Principal Engineers mit Verantwortung für teamübergreifende Konsistenz
  • Enterprise-Architekten, die näher an die Umsetzungsteams rücken wollen
  • CTOs kleinerer Unternehmen, die Architektur selbst verantworten

Das nehmen Sie mit

  • Sie rekonstruieren mit einem Agenten die Ist-Architektur einer Codebasis als C4-Diagramme in Code und gleichen sie mit der Realität ab.
  • Sie nutzen Agenten als Sparringspartner für Trade-off-Analysen mit Optionen, Qualitätsszenarien und Gegenargumenten.
  • Sie erstellen, prüfen und pflegen Architecture Decision Records mit Agenten und verknüpfen sie mit dem betroffenen Code.
  • Sie übersetzen Architekturregeln in Fitness Functions, die in der CI laufen und Coding-Agenten sofort Rückmeldung geben.
  • Sie stellen Coding-Agenten Architekturwissen so bereit, dass generierter Code Grenzen und Entscheidungen respektiert.

Agenda

  1. Modul 1

    Architekturarbeit, wenn Code billig wird

    • Was sich ändert, wenn Agenten den Großteil des Codes schreiben
    • Wo Agenten helfen: Analyse, Dokumentation, Optionen
    • Wo nicht: Verantwortung, Organisationskontext, Abwägungen zwischen Stakeholdern
  2. Modul 2

    Die Ist-Architektur rekonstruieren

    • Übung: Ein Agent analysiert Ihr Repository und entwirft C4-Kontext-, Container- und Komponentensichten
    • Diagramme als Code mit Structurizr DSL, Mermaid oder PlantUML
    • Ergebnis validieren: Zyklen, Hotspots und das, was der Code nicht verrät
  3. Modul 3

    Entscheidungen und Trade-offs

    • Qualitätsszenarien als gemeinsame Sprache
    • Übung: Der Agent als Advocatus Diaboli für eine anstehende Entscheidung
    • ADR-Vorlagen, Status und Review im Pull Request
  4. Modul 4

    Fitness Functions

    • Architekturregeln als Tests, etwa mit ArchUnit, NetArchTest, dependency-cruiser oder import-linter
    • Übung: Der Agent leitet Regeln aus einem bestehenden ADR ab
    • Einbindung in die CI und Umgang mit bekannten Verstößen
  5. Modul 5

    Architekturkontext für Coding-Agenten

    • Ein Architekturabschnitt in CLAUDE.md oder AGENTS.md
    • ADRs und Modulkarten als Kontext statt als Textwand
    • Review-Checkliste für architekturrelevante Pull Requests

Die Entscheidung bleibt beim Menschen

Ein Agent kann fünf Varianten für Event Sourcing oder klassisches CRUD auflisten, jede überzeugend begründen – und trotzdem übersehen, dass Ihr Betriebsteam keine Erfahrung mit dem gewählten Message Broker hat. Architekturentscheidungen hängen von Budget, Kompetenzen, Verträgen und Organisationsrealität ab, und davon steht wenig im Repository.

Wir setzen Agenten deshalb ein, um den Lösungsraum zu erweitern und Annahmen zu hinterfragen. Jede Entscheidung hat eine verantwortliche Person oder ein Gremium; das ADR hält fest, wer entschieden hat und warum – nicht, welches Modell es vorgeschlagen hat.

Anschlussfähig an arc42 und Ihre Vorlagen

Viele Teams im deutschsprachigen Raum dokumentieren mit arc42, andere nur mit C4 oder mit schlanken ADRs im Repository. Der Workshop setzt auf Ihren vorhandenen Vorlagen auf. Gibt es noch keine, beginnen wir mit einem minimalen Satz, den Menschen und Agenten gleichermaßen pflegen können.

Geleitet wird der Tag von AI Solutions Architects und AI Code Engineers von neooutput, die Architekturarbeit und agentische Entwicklung aus Projekten kennen.

Häufige Fragen

Kann ein Agent unsere Zielarchitektur entwerfen?

Er liefert plausible Entwürfe und weist auf Risiken hin, kennt aber weder Ihre Organisation noch Budget und Rahmenbedingungen. Wir nutzen Agenten, um Entscheidungen vorzubereiten und zu hinterfragen, nicht um sie zu treffen.

Wie genau sind aus Code generierte Architekturdiagramme?

Für Abhängigkeiten und Modulstruktur sind sie ein guter Ausgangspunkt. Laufzeitverhalten, Deployment-Topologie und versteckte Kopplung über Datenbanken oder Messaging fehlen oft, deshalb validieren wir sie immer mit dem Team.

Für welche Sprachen gibt es die Übungen zu Fitness Functions?

Wir bereiten Beispiele für Ihren Stack vor, etwa ArchUnit für Java, NetArchTest für .NET, dependency-cruiser für JavaScript und TypeScript oder import-linter für Python. Die Prinzipien lassen sich auf andere Ökosysteme übertragen.

Workshop

Kontakt aufnehmen

Welche Architekturentscheidung möchten Sie mit einem Agenten als Sparringspartner durchspielen?

Wählen Sie die ungefähre Teilnehmerzahl und passende Termine – wir melden uns innerhalb von 24 Stunden mit einem Vorschlag für Inhalte, Format und Ablauf.

Lieber erst sprechen?

15 Minuten, kostenlos und unverbindlich – mit unseren AI Trainern und AI Code Engineers.

Kostenloses Gespräch buchen (öffnet in neuem Tab) +49 761 519 751 50 (rund um die Uhr)

Schulung/Workshop anfragen

Workshop: Softwarearchitektur mit KI-Agenten: ADRs, C4 und Fitness Functions · 1 Tag

Passende Termine (optional)

Vorschläge in ca. 2 Wochen – Mehrfachauswahl möglich

Antwort meist innerhalb von 24 Stunden · jocapps ist ISO 27001-zertifiziert · Datenschutz