Software-Architektur

Die 31 Agenten dieser Kategorie übernehmen die Struktur-Entscheidungen, die sonst in langen Meetings hängen bleiben: Modulgrenzen schneiden, Bounded Contexts anhand von Begriffsunterschieden ziehen, Monolith gegen Dienste abwägen. Jeder Agent arbeitet nach einer festen Methode mit prüfbaren Zwischenergebnissen und einem Output-Vertrag — der Monolith-Abwäger bewertet etwa Last, Teamstruktur und Wandelrate und liefert dir Schwellenwerte statt Bauchgefühl. Was du nicht lieferst, wird nicht erfunden, sondern als markierte Annahme dokumentiert.

Der zweite Schwerpunkt ist Nachvollziehbarkeit: Das Entscheidungs-Protokoll hält deine Architektur-Entscheidungen als ADR mit Kontext, Optionen und Konsequenzen fest, damit spätere Teams die Begründung nicht rekonstruieren müssen. Fitness-Funktionen machen deine Architekturregeln automatisch prüfbar, der Drift-Detektor vergleicht gelebte Struktur mit dokumentierter, die Failure-Mode-Analyse spielt Versagensarten je Komponente durch, bevor du baust. Drei Agenten planen außerdem das Zusammenspiel der Keyvarn-OS-Skills selbst — Komposition, Übergabe-Verträge und saubere Abgrenzung.

Typische Aufgaben

• Ein Monolith soll zerlegt werden: Der Monolith-vs-Services-Abwäger prüft Last, Teamstruktur und Wandelrate — der Zerlegungs-Schnitt-Planer legt danach Schnittkandidaten und Reihenfolge fest.
• „Kunde" bedeutet in Vertrieb, Abrechnung und Support drei verschiedene Dinge: Der Bounded-Context-Finder zieht Kontextgrenzen und liefert eine Kontextkarte mit Beziehungstypen.
• Vor einem kritischen Release: Die Failure-Mode-Analyse spielt je Komponente Versagensarten durch und setzt Behandlungsvorränge — der Resilienz-Muster-Planer legt Schutzmuster je Ausfallpfad fest.
• Niemand weiß mehr, warum REST statt gRPC gewählt wurde: Das Architektur-Entscheidungs-Protokoll hält die Entscheidung als ADR mit Kontext, Optionen und Begründung fest.

Alle 31 Agenten in kv-arch

Jede Zeile ist eine Datei im ausgelieferten Paket — Name identisch mit dem Ordner im Download.

• kv-arch-abhaengigkeits-richtungs-pruefer Prüft Abhängigkeitsgraphen auf Zyklen und verbotene Kanten und liefert Umkehr- oder Entkopplungs-Vorschläge.
• kv-arch-anforderungs-architektur-mapper Mappt Anforderungen auf Architektur-Eigenschaften und benennt passende Bau-Kandidaten.
• kv-arch-annahmen-risiko-register Deckt ungeprüfte Architektur-Annahmen auf und registriert Risiken mit Wahrscheinlichkeit und Gegenmaßnahmen.
• kv-arch-api-versionierungs-stratege Entwirft eine API-Versionierungsstrategie mit Änderungsklassifikation, Deprecation-Regeln und Migrationspfad.
• kv-arch-architektur-drift-detektor Erkennt Abweichungen zwischen gelebter Systemstruktur und dokumentierter Architektur im Drift-Report.
• kv-arch-architektur-entscheidungs-protokoll Erstellt vollständige Architecture-Decision-Records mit Kontext, Optionen, Begründung und Konsequenzen.
• kv-arch-architektur-fitness-funktionen Macht Architekturregeln automatisch prüfbar — mit Bedingung, Messpunkt und Schwellenwert je Regel.
• kv-arch-bounded-context-finder Findet Bounded Contexts anhand von Begriffsunterschieden und liefert eine Kontextkarte mit Beziehungstypen.
• kv-arch-datenfluss-grenz-analyse Klärt, welche Komponente welche Daten besitzt: Karte mit Datenhoheit, Lese-/Schreibpfaden und Duplikaten.
• kv-arch-deploybarkeits-grenz-planer Plant unabhängig auslieferbare Deploy-Einheiten mit Versionsgrenzen und Kompatibilitätsregeln.
• kv-arch-event-fluss-modellierer Erstellt eine Event-Landkarte mit Ereignissen, Produzenten, Konsumenten und Reihenfolge-Annahmen.
• kv-arch-failure-mode-analyse Spielt je Komponente mögliche Versagensarten durch: Ursache, Auswirkung, Erkennbarkeit, Behandlungsvorrang.
• kv-arch-komponenten-schnittstellen-vertrag Spezifiziert Verträge je Komponentengrenze: Ein-/Ausgaben, Vor- und Nachbedingungen, Fehlerverhalten.
• kv-arch-konfigurations-architektur-planer Ordnet gewachsene Konfiguration in ein Schichtenmodell mit Quellen, Vorrang und Trennung von Geheimnissen.
• kv-arch-kontext-integrations-muster Wählt je Kontextpaar ein begründetes Integrationsmuster mit Macht- und Abhängigkeitsbewertung.
• kv-arch-modul-grenzen-schneider Schneidet Modulgrenzen mit Verantwortlichkeiten, erlaubten Abhängigkeitsrichtungen und Schnittstellen.
• kv-arch-monolith-vs-services-abwaegung Wägt Monolith gegen Dienste ab — mit Kostentreibern beider Optionen und Schwellenwerten für die Aufteilung.
• kv-arch-persistenz-grenz-stratege Empfiehlt Datenbankgrenzen je Baustein, wenn eine geteilte Datenbank alles koppelt — inkl. Konsistenzgrenzen.
• kv-arch-qualitaetsziele-priorisierer Priorisiert konkurrierende Qualitätsziele als gewichtete Rangliste mit dokumentierten Trade-off-Konflikten.
• kv-arch-querschnitts-belang-planer Plant Querschnittsthemen wie Logging, Auth und Fehlerbehandlung: Ort, Mechanismus und Aufrufkonvention.
• kv-arch-resilienz-muster-planer Legt je Ausfallpfad ein Schutzmuster gegen Teilausfälle fest — mit Parametern und Rückfallverhalten.
• kv-arch-schichten-konformitaets-pruefer Prüft, ob deklarierte Schichten eingehalten werden: jede Verletzung mit Fundort und Korrekturpfad.
• kv-arch-skalierbarkeits-grenz-planer Identifiziert Engpässe unter Last und benennt je Komponente die Skalierungsachse und Lastannahmen.
• kv-arch-skill-grenz-abgrenzer Grenzt überlappende Keyvarn-OS-Skills ab: Überschneidungsanalyse und eindeutige Grenzziehung je Skill-Paar.
• kv-arch-skill-kompositions-planer Zerlegt große Aufgaben in eine geordnete Skill-Kette mit Übergabewerten und Abbruchbedingungen.
• kv-arch-skill-orchestrierungs-vertrag Spezifiziert Übergaben zwischen Keyvarn-OS-Skills: Ein-/Ausgabeformat, Pflichtfelder und Fehlerverhalten.
• kv-arch-stil-auswahl-berater Vergleicht Architekturstile wie Schichten, Hexagonal und Microservices und begründet eine Empfehlung.
• kv-arch-sync-vs-async-entscheider Begründet je Interaktionsstrecke, ob synchron oder über Ereignisse kommuniziert wird — inkl. Ausfallfolgen.
• kv-arch-technische-schuld-kartograph Kartiert Architektur-Schuld mit Ursache, laufenden Mehrkosten, Behebungsaufwand und Vorrang je Eintrag.
• kv-arch-tradeoff-entscheidungsmatrix Baut eine Entscheidungsmatrix mit gewichteten Kriterien, Bewertungen je Option und Sensitivitätsprüfung.
• kv-arch-zerlegungs-schnitt-planer Plant die Zerlegung eines Monolithen: Schnittkandidaten, Risikorangfolge und Naht-Beschreibung je Schritt.