Architecture Intelligence für AI-native Teams

In den letzten sechs Monaten hat sich etwas grundlegend verändert. KI-Agenten sind vom Schreiben einzelner Funktionen zum Schreiben ganzer Services übergegangen. Claude Code, Cursor, Codex -- sie sind keine Assistenten mehr. Sie sind Teammitglieder. Sie öffnen PRs, reviewen Code, liefern Features.

Aber hier ist, was mich nachts wach hält: Diese Agenten haben keine Ahnung, wie die Architektur aussieht.

Ein Agent kann in zehn Minuten einen perfekt sauberen Go-Service schreiben. Aber er weiß nicht, dass das Team vor drei Monaten entschieden hat, die gesamte Inter-Service-Kommunikation über Kafka zu routen. Er weiß nicht, dass der Payment-Service keinen direkten Datenbankzugriff erlaubt. Er weiß nicht, dass Python letztes Quartal auf dem Technology Radar auf "Hold" gesetzt wurde.

Das Ergebnis? Architecture Drift mit Maschinengeschwindigkeit.

Wir haben Archyl gebaut, um dieses Problem zu lösen. Und heute liefern wir das größte Update seit dem Launch: Architecture Intelligence -- ein komplettes Ökosystem, das Archyl zum Nervensystem der AI-nativen Entwicklung macht.

Das Problem: Agenten coden schnell, aber blind

Wenn ein menschlicher Entwickler in ein Team kommt, verbringt er Tage damit, Dokumentation zu lesen, Fragen zu stellen und ein mentales Modell des Systems aufzubauen. Er lernt die Regeln -- geschriebene und ungeschriebene. Er versteht die Grenzen.

KI-Agenten überspringen all das. Sie bekommen eine Aufgabe, schreiben Code, öffnen eine PR. Wenn niemand die Architekturverletzung im Review entdeckt, wird sie ausgeliefert. Multipliziert das mit zehn Agenten, die an zehn Services in drei Teams arbeiten, und eure sorgfältig entworfene Architektur erodiert in Wochen.

Wir haben das erlebt. Ein Team mit einem makellosen C4-Modell im Januar hatte im März einen Drift-Score von 40 %. Nicht weil sie aufgehört hatten, sich darum zu kümmern -- sondern weil ihre Agenten nicht wussten, dass die Architektur existiert.

Die Lösung: Architektur als Infrastruktur

Architekturdokumentation sollte nicht etwas sein, das man pflegt. Sie sollte etwas sein, das sich selbst pflegt -- und das jeder Agent konsultiert, bevor er eine einzige Zeile Code schreibt.

Das haben wir gebaut. Hier ist, was wir heute ausliefern.

10 Agent Skills

Der ursprüngliche archyl-developer Skill gab Agenten Zugang zu 181 MCP-Tools. Aber es war ein Werkzeugkasten ohne Workflow. Heute fügen wir neun spezialisierte Skills hinzu, die den gesamten Entwicklungszyklus abdecken:

Bevor du codest

archyl-preflight -- Führe diesen Skill aus, bevor du ein Feature implementierst. Er prüft deinen geplanten Ansatz gegen das C4-Modell, Conformance Rules, den Technology Radar und API-Contracts. Du bekommst ein klares PASS / WARN / FAIL Ergebnis, bevor du eine einzige Zeile Code schreibst.

> Ich moechte dem User-Service einen Redis-Cache hinzufuegen. Ist das in Ordnung?

Preflight-Check: WARNUNG
- Redis ist auf dem Technology Radar freigegeben ✓
- User-Service existiert im C4-Modell ✓
- ⚠ Kein bestehender Cache-Container dokumentiert -- Empfehlung: einen erstellen
- ⚠ Die Regel "Kein direkter DB-Zugriff aus Handlern" gilt -- stelle sicher, dass der Cache ueber die Service-Schicht angesprochen wird

Nach dem Ship

archyl-postship -- Führe diesen Skill nach dem Ship aus. Er analysiert, was du gerade gebaut hast, aktualisiert das C4-Modell, erstellt ADRs für Architekturentscheidungen und reicht Change Requests zur Prüfung durch den Architekten ein. Deine Dokumentation aktualisiert sich als Nebeneffekt deiner Arbeit.

Während des Reviews

archyl-review -- Ein Architektur-Review-Bot. Er prüft den Diff deiner PR gegen die dokumentierte Architektur und liefert strukturiertes Feedback: Conformance-Verletzungen, Grenzüberschreitungen, nicht freigegebene Technologien, fehlende API-Contracts. Stell dir ESLint vor, aber für Architektur.

Für Transparenz

archyl-changelog -- Generiert eine lesbare Timeline aller Architektur-Änderungen: neue Services, geaenderte Beziehungen, ADR-Entscheidungen, Drift-Entwicklung. Perfekt für Architektur-Review-Meetings.

archyl-dora -- Korreliert DORA-Metriken mit Architektur-Änderungen. Hat eure Microservice-Zerlegung die Lead Time verbessert? Ging der Drift-Spike der Erhöhung der Change Failure Rate voraus? Jetzt habt ihr die Daten.

archyl-roi -- Quantifiziert die finanzielle Auswirkung von Architekturentscheidungen. "Unsere Investition in Conformance Rules hat letztes Quartal geschätzt 23.000 $ eingespart, indem Nacharbeit reduziert wurde." Das sind die Daten, die Architektur-Budgets genehmigt bekommen.

Für Prävention

archyl-predict -- Prognostiziert Architekturrisiken, bevor sie eintreten. "Bei der aktuellen Rate wird euer Drift-Score bis Mai 50 % überschreiten. Der PaymentService hat 12 eingehende Abhängigkeiten -- zieht eine Zerlegung in Betracht."

archyl-autofix -- Wenn Drift erkannt wird, schlägt er spezifische Fixes vor. Entweder die Dokumentation aktualisieren, damit sie zum Code passt, oder Code-Änderungen vorschlagen, um sich wieder an der Architektur auszurichten. Erstellt Change Requests für menschliches Review.

Für Koordination

archyl-orchestrate -- Wenn mehrere Agenten gleichzeitig an verschiedenen Services arbeiten, verhandelt dieser Skill API-Contracts, löst Abhängigkeitskonflikte und stellt sicher, dass teamübergreifende Änderungen die Architektur nicht brechen.

6 GitHub Actions

Architektur-Governance gehört in die CI. Wir liefern sechs GitHub Actions, die automatisch bei jeder PR und jedem Merge ausgeführt werden:

Das empfohlene Setup besteht aus einer einzigen Datei:

name: Architecture
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  pr-checks:
    if: github.event_name == 'pull_request'
    uses: archyl-com/actions/.github/workflows/archyl-pr.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
      drift-threshold: 70
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

  main-update:
    if: github.event_name == 'push'
    uses: archyl-com/actions/.github/workflows/archyl-main.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

Nicht auf GitHub? Wir liefern auch Templates für GitLab CI und Bitbucket Pipelines.

Conformance Rule Packs

Architektur-Governance von Grund auf einzurichten ist mühsam. Deshalb haben wir fünf vorgefertigte Rule Packs gebaut, die ihr in Sekunden installieren könnt:

Installation über den Agent Skill: "Installiere das Microservices Conformance Rule Pack." Fertig.

SDKs

Für Teams, die eigene Integrationen bauen, veröffentlichen wir offizielle SDKs:

npm install @archyl/sdk    # Node.js 18+, zero dependencies
pip install archyl-sdk     # Python 3.10+

const archyl = new ArchylClient({ apiKey: 'arch_...', organizationId: 'uuid' });
const drift = await archyl.governance.computeDrift(projectId);
const predictions = await archyl.projects.getPredictions(projectId);

Drei neue KI-gestützte APIs

Unter der Haube liefern wir drei neue Backend-Fähigkeiten:

Predictive Analytics (GET /projects/:id/predict) -- Echte statistische Analyse. Lineare Regression auf Drift-Scores, DORA-Metrik-Trajektorien, Conformance-Verfallsraten und Erkennung von Komplexitäts-Hotspots durch Fan-in/Fan-out-Kopplungsanalyse. Kein Bauchgefühl -- Mathematik.

Architecture Diff Analysis (POST /projects/:id/architecture-diff) -- Sende einen Git-Diff, erhalte ein strukturiertes C4-Modell-Delta zurück. KI-gestützte Analyse, die neue Services, geaenderte Abhängigkeiten und Architekturentscheidungen erkennt. Schlägt ADRs vor, wenn signifikante Entscheidungen erkannt werden.

ROI Computation (GET /projects/:id/roi) -- Quantifiziert den Return on Investment der Architektur. Teilt eure DORA-Metriken in Vorher/Nachher auf, berechnet Produktivitätsgewinne (eingesparte Stunden x Stundensatz), Zuverlässigkeitsgewinne (vermiedene Incidents x Incident-Kosten) und rankt eure ADRs nach finanziellem Impact.

Alle drei sind als MCP-Tools verfügbar, sodass jeder Agent Skill sie direkt aufrufen kann.

Der vollständige Kreislauf

So fügt sich alles zusammen:

Agent erhaelt Aufgabe
       │
       ▼
  archyl-preflight ──── validiert Ansatz gegen die Architektur
       │
       ▼
  Agent schreibt Code
       │
       ▼
  archyl-review ──────── reviewt PR gegen C4-Modell
       │
       ▼
  CI: conformance-check ─ blockiert Verletzungen
  CI: drift-score ──────── erzwingt Alignment
       │
       ▼
  Merge auf main
       │
       ▼
  CI: auto-cr ──────────── reicht Change Request ein
  CI: generate-context ─── aktualisiert archyl.txt
       │
       ▼
  archyl-postship ──────── aktualisiert C4-Modell + ADRs
       │
       ▼
  Naechster Agent liest archyl.txt ← Kreislauf wiederholt sich

Architektur wird nicht gepflegt. Sie pflegt sich selbst.

Erste Schritte

1. Skills installieren:

/plugin marketplace add archyl-com/agent-skills
/plugin install archyl-preflight@archyl-com-agent-skills

2. GitHub Actions hinzufügen: Kopiert den Workflow oben nach .github/workflows/architecture.yml.

3. Euer erstes archyl.txt generieren: Führt die generate-context Action aus oder fragt euren Agenten: "Generiere die Architektur-Kontextdatei für dieses Projekt."

4. Loslegen. Euer Agent kennt jetzt die Architektur.

Was kommt als Nächstes

Das ist das Fundament. Wir arbeiten an Frontend-Dashboards für Predictions und ROI, tieferer Integration mit weiteren Coding-Agenten und einem Community-Marketplace für Conformance Rule Packs.

Architekturdokumentation war immer das, was Teams vorhatten, aber nie geschafft haben. Wenn Agenten den Code schreiben, wird Architektur das Einzige, was Menschen besitzen müssen. Archyl sorgt dafür, dass sie es nicht allein tun müssen.

Alles, was wir heute ausgeliefert haben, ist Open Source. Wir freuen uns auf euer Feedback.