Architecture Intelligence fuer AI-native Teams

In den letzten sechs Monaten hat sich etwas grundlegend veraendert. KI-Agenten sind vom Schreiben einzelner Funktionen zum Schreiben ganzer Services uebergegangen. Claude Code, Cursor, Codex -- sie sind keine Assistenten mehr. Sie sind Teammitglieder. Sie oeffnen PRs, reviewen Code, liefern Features.

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

Ein Agent kann in zehn Minuten einen perfekt sauberen Go-Service schreiben. Aber er weiss nicht, dass das Team vor drei Monaten entschieden hat, die gesamte Inter-Service-Kommunikation ueber Kafka zu routen. Er weiss nicht, dass der Payment-Service keinen direkten Datenbankzugriff erlaubt. Er weiss 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 loesen. Und heute liefern wir das groesste Update seit dem Launch: Architecture Intelligence -- ein komplettes Oekosystem, 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 ueberspringen all das. Sie bekommen eine Aufgabe, schreiben Code, oeffnen 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 sorgfaeltig entworfene Architektur erodiert in Wochen.

Wir haben das erlebt. Ein Team mit einem makellosen C4-Modell im Januar hatte im Maerz einen Drift-Score von 40 %. Nicht weil sie aufgehoert hatten, sich darum zu kuemmern -- sondern weil ihre Agenten nicht wussten, dass die Architektur existiert.

Die Loesung: 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 urspruengliche archyl-developer Skill gab Agenten Zugang zu ueber 200 MCP-Tools. Aber es war ein Werkzeugkasten ohne Workflow. Heute fuegen wir neun spezialisierte Skills hinzu, die den gesamten Entwicklungszyklus abdecken:

Bevor du codest

archyl-preflight -- Fuehre diesen Skill aus, bevor du ein Feature implementierst. Er prueft 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 -- Fuehre diesen Skill nach dem Ship aus. Er analysiert, was du gerade gebaut hast, aktualisiert das C4-Modell, erstellt ADRs fuer Architekturentscheidungen und reicht Change Requests zur Pruefung durch den Architekten ein. Deine Dokumentation aktualisiert sich als Nebeneffekt deiner Arbeit.

Waehrend des Reviews

archyl-review -- Ein Architektur-Review-Bot. Er prueft den Diff deiner PR gegen die dokumentierte Architektur und liefert strukturiertes Feedback: Conformance-Verletzungen, Grenzueberschreitungen, nicht freigegebene Technologien, fehlende API-Contracts. Stell dir ESLint vor, aber fuer Architektur.

Fuer Transparenz

archyl-changelog -- Generiert eine lesbare Timeline aller Architektur-Aenderungen: neue Services, geaenderte Beziehungen, ADR-Entscheidungen, Drift-Entwicklung. Perfekt fuer Architektur-Review-Meetings.

archyl-dora -- Korreliert DORA-Metriken mit Architektur-Aenderungen. Hat eure Microservice-Zerlegung die Lead Time verbessert? Ging der Drift-Spike der Erhoehung 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 geschaetzt 23.000 $ eingespart, indem Nacharbeit reduziert wurde." Das sind die Daten, die Architektur-Budgets genehmigt bekommen.

Fuer Praevention

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

archyl-autofix -- Wenn Drift erkannt wird, schlaegt er spezifische Fixes vor. Entweder die Dokumentation aktualisieren, damit sie zum Code passt, oder Code-Aenderungen vorschlagen, um sich wieder an der Architektur auszurichten. Erstellt Change Requests fuer menschliches Review.

Fuer Koordination

archyl-orchestrate -- Wenn mehrere Agenten gleichzeitig an verschiedenen Services arbeiten, verhandelt dieser Skill API-Contracts, loest Abhaengigkeitskonflikte und stellt sicher, dass teamuebergreifende Aenderungen die Architektur nicht brechen.

6 GitHub Actions

Architektur-Governance gehoert in die CI. Wir liefern sechs GitHub Actions, die automatisch bei jeder PR und jedem Merge ausgefuehrt 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 fuer GitLab CI und Bitbucket Pipelines.

Conformance Rule Packs

Architektur-Governance von Grund auf einzurichten ist muehsam. Deshalb haben wir fuenf vorgefertigte Rule Packs gebaut, die ihr in Sekunden installieren koennt:

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

SDKs

Fuer Teams, die eigene Integrationen bauen, veroeffentlichen 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-gestuetzte APIs

Unter der Haube liefern wir drei neue Backend-Faehigkeiten:

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

Architecture Diff Analysis (POST /projects/:id/architecture-diff) -- Sende einen Git-Diff, erhalte ein strukturiertes C4-Modell-Delta zurueck. KI-gestuetzte Analyse, die neue Services, geaenderte Abhaengigkeiten und Architekturentscheidungen erkennt. Schlaegt 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 Produktivitaetsgewinne (eingesparte Stunden x Stundensatz), Zuverlaessigkeitsgewinne (vermiedene Incidents x Incident-Kosten) und rankt eure ADRs nach finanziellem Impact.

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

Der vollstaendige Kreislauf

So fuegt 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 hinzufuegen: Kopiert den Workflow oben nach .github/workflows/architecture.yml.

3. Euer erstes archyl.txt generieren: Fuehrt die generate-context Action aus oder fragt euren Agenten: "Generiere die Architektur-Kontextdatei fuer dieses Projekt."

4. Loslegen. Euer Agent kennt jetzt die Architektur.

Was kommt als Naechstes

Das ist das Fundament. Wir arbeiten an Frontend-Dashboards fuer Predictions und ROI, tieferer Integration mit weiteren Coding-Agenten und einem Community-Marketplace fuer 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 muessen. Archyl sorgt dafuer, dass sie es nicht allein tun muessen.

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