Coding-Agent-Plugin: Verwalte deine Architektur, ohne dein Terminal zu verlassen

Letzten Monat habe ich einem Entwickler in unserem Team bei etwas zugesehen, das sich anfühlte, als sollte es eigentlich nicht funktionieren.

Er steckte mitten in einer Refactoring-Session in Claude Code und teilte einen monolithischen Service in drei kleinere auf. Mittendrin tippte er: "Erstelle drei neue Container in Archyl — OrderService, InventoryService und NotificationService — unter dem ECommerce-System. Füge 'calls'-Beziehungen zwischen OrderService und den beiden anderen hinzu."

Zehn Sekunden später hatte das C4 model in Archyl drei neue Container, korrekt mit Beziehungen verdrahtet, genau dort platziert, wo sie in der Architektur hingehören. Er hat nie den Tab gewechselt. Er hat nie einen Browser geöffnet. Er hat einfach weiterprogrammiert.

Da wusste ich, dass das Plugin bereit zum Ausliefern war.

Das Kontextwechsel-Problem

Architekturdokumentation hat ein fundamentales UX-Problem: Sie lebt an einem anderen Ort als der Code.

Du bist in deiner IDE. Du hast gerade ein Modul umstrukturiert, drei Services umbenannt und eine Datenbank in Read- und Write-Replicas aufgeteilt. Der Code ist fertig. Jetzt musst du die Architektur aktualisieren. Das bedeutet: Archyl im Browser öffnen, das richtige Projekt finden, zum richtigen Diagramm navigieren, die Container aktualisieren, Beziehungen hinzufügen, vielleicht ein ADR schreiben, um zu erklären, warum du die Änderung vorgenommen hast.

Es dauert fünf Minuten. Aber diese fünf Minuten haben versteckte Kosten: Kontextwechsel. Dein Gehirn muss den Code verlassen, in einen visuellen Diagrammmodus wechseln, sich erinnern, was du gerade getan hast, es in Architekturkonzepte übersetzen und dann zum Programmieren zurückkehren. Die meisten Entwickler tun es einfach... nicht. Sie sagen sich, dass sie die Dokumentation später aktualisieren werden. Später kommt nie.

Deshalb gibt es Architecture Drift. Nicht weil Teams sich nicht um Dokumentation kümmern, sondern weil das Tool am falschen Ort zur falschen Zeit ist.

Architektur in deiner Konversation

Das Archyl Developer Plugin bringt deine gesamte Architektur in den Kontext deines Coding-Agents. Es ist ein Plugin für Claude Code (und kompatibel mit Codex und anderen Agents), das dem Agent beibringt, wie er alle 200+ MCP-Tools von Archyl nutzen kann.

Was bedeutet das in der Praxis? Es bedeutet, dass du Folgendes tun kannst:

Während des Refactorings sagst du deinem Agent, er soll die Architektur aktualisieren:

I just split the PaymentService into PaymentProcessor and PaymentGateway.
Update the architecture — remove the old container, create the two new ones,
and move all existing relationships to the appropriate new container.

Während eines Code-Reviews fragst du nach dem architektonischen Kontext:

Get the full C4 model and tell me which components depend on the UserRepository.
Are there any conformance rules I should know about before changing the data layer?

Bei der Arbeitsplanung prüfst du, ob die Dokumentation noch aktuell ist:

What's the current drift score? Show me which elements have drifted
and what the AI thinks is out of date.

Nach einem Design-Meeting hältst du die Entscheidung fest, ohne dein Terminal zu verlassen:

Create an ADR: we decided to migrate from REST to gRPC for all internal
service communication. Context: latency requirements from the mobile team.
Link it to the ApiGateway and all backend service containers.

Der Agent übernimmt die MCP-Aufrufe, verwaltet Projekt-IDs und verkettet Operationen. Du beschreibst einfach in natürlicher Sprache, was du willst.

Was das Plugin abdeckt

Das Plugin gibt deinem Agent strukturiertes Wissen über sieben Bereiche:

C4 Modeling — Erstelle und verwalte Systeme, Container, Komponenten, Code-Elemente und Beziehungen. Der Agent versteht die C4-Hierarchie und setzt korrekte Namenskonventionen durch (PascalCase für Systeme und Container, exakte Symbolnamen für Code-Elemente).

Dokumentation — Schreibe ADRs, erstelle Projektdokumente, definiere User Flows und überprüfe KI-generierte Insights. ADRs werden mit den C4-Elementen verknüpft, die sie betreffen, sodass Architekturentscheidungen mit der Architektur verbunden bleiben.

Governance — Erstelle Konformitätsregeln, führe Compliance-Checks durch und überwache Architecture Drift. Der Agent kann Leitplanken einrichten, bevor eine KI-Coding-Session überhaupt beginnt.

Operations — Verfolge Releases über Umgebungen hinweg, dokumentiere API-Verträge (OpenAPI, gRPC, GraphQL), mappe Event-Kanäle (Kafka, NATS, SQS) und verwalte das Technology Radar.

Zusammenarbeit — Füge Kommentare hinzu, erstelle Change Requests (wie PRs für Architektur) und verwalte Whiteboards. Architekturdiskussionen finden dort statt, wo auch die Code-Diskussionen stattfinden.

Historie — Erstelle Snapshots, reise durch Architekturversionen und vergleiche Änderungen. Wenn jemand fragt "Wie sah die Architektur vor der Migration aus?", kann der Agent antworten.

Integrationen — Konfiguriere Webhooks für Architekturänderungs-Benachrichtigungen, verwalte Marketplace-Widgets und sieh die globale Architektur über alle Projekte in der Organisation.

Drei Schritte zur Einrichtung

Die Einrichtung ist unkompliziert:

1. Füge den Marketplace hinzu und installiere das Plugin:

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

2. Füge den MCP-Server zu deiner .mcp.json hinzu:

{
    "mcpServers": {
        "archyl": {
            "type": "http",
            "url": "https://api.archyl.com/mcp",
            "headers": {
                "X-API-Key": "arch_your_api_key_here"
            }
        }
    }
}

3. Starte deinen Agent neu und sprich mit deiner Architektur.

Das war's. Das Plugin lädt automatisch und der Agent weiß, wie er jedes Tool nutzen kann. Keine Konfigurationsdateien, keine benutzerdefinierten Prompts, keine manuelle Verdrahtung.

Warum Open Source

Das Plugin ist vollständig Open Source unter github.com/archyl-com/agent-skills. Es gibt mehrere Gründe dafür.

Erstens, Transparenz. Wenn ein Plugin einem KI-Agent beibringt, wie er mit deiner Architektur interagieren soll, solltest du jede Anweisung lesen können, die es ihm gibt. Die Skill-Definition, die Referenzdateien, die Workflow-Beispiele — alles ist dort, in einfachem Markdown.

Zweitens, Beiträge. Archyl hat über 200 MCP-Tools, und die besten Workflows entstehen aus echter Nutzung. Wenn ein Team ein Muster entdeckt, das funktioniert — sagen wir, einen Workflow zum Auditieren der Architektur vor einem großen Release — kann es dieses zurückgeben. Das Plugin wird besser, weil die Community es nutzt.

Drittens, Portabilität. Der Skill-Inhalt ist nicht an Claude Code gebunden. Er funktioniert mit jedem Agent, der das Plugin-Format unterstützt. Die .claude-plugin- und .codex-plugin-Manifeste sind beide enthalten. Wenn nächsten Monat ein neuer Coding-Agent mit Plugin-Unterstützung erscheint, lässt sich der Skill-Inhalt direkt übertragen.

Was sich ändert

Die Veränderung ist subtil, aber bedeutsam.

Vor dem Plugin war Architekturdokumentation eine separate Aktivität. Du hast Code geschrieben, dann dokumentiert. Zwei Workflows, zwei Tools, zwei mentale Modi. Dokumentation hinkte immer hinterher, weil sie immer einen Schritt entfernt war.

Mit dem Plugin wird Architekturdokumentation Teil der Coding-Konversation. Du "aktualisierst die Doku" nicht — du erwähnst, was sich geändert hat, und der Agent erledigt den Rest. Die Architektur bleibt synchron, nicht weil jemand daran gedacht hat, sie zu aktualisieren, sondern weil das Aktualisieren mühelos wurde.

Das ist besonders mächtig in agentischen Workflows. Wenn ein KI-Agent Änderungen an deiner Codebasis vornimmt, kann er gleichzeitig die Architektur aktualisieren. Dieselbe Session, die den Code refactored, aktualisiert auch das C4 model, erfasst das ADR und führt einen Konformitätscheck durch. Architecture Governance wird ein natürlicher Teil des Entwicklungsflusses, keine nachträgliche Überlegung.

Leg los

Installiere das Plugin, verbinde deinen MCP-Server und frag deinen Agent, deine Architektur zu beschreiben. Dann bitte ihn, eine Änderung vorzunehmen. Wenn du das erste Mal ein C4 model aus einer Terminal-Konversation heraus aktualisierst, wirst du dich fragen, warum es jemals anders funktioniert hat.

Das Plugin ist ab sofort verfügbar. Die vollständige Dokumentation findest du in unseren Guides, und der Quellcode ist auf GitHub.

Deine Architektur sollte nicht in einem anderen Tab leben. Jetzt muss sie das auch nicht mehr.