Coding-Agent-Plugin

Das Archyl Developer Plugin ermoeglicht es Ihnen, Ihr gesamtes C4-Architekturmodell direkt aus Ihrem Coding-Agent heraus zu verwalten -- Claude Code, Codex oder jedes kompatible Tool. Anstatt zwischen Ihrem Editor und dem Archyl-Dashboard zu wechseln, koennen Sie Systeme, Container, Komponenten, ADRs, Konformitaetsregeln und mehr erstellen, ohne Ihr Terminal zu verlassen.

Das Plugin ist Open Source und verfuegbar unter github.com/archyl-com/agent-skills.

Was Sie tun koennen

Das Plugin gibt Ihrem Agent tiefgreifendes Wissen ueber Archyls 200+ MCP-Tools in folgenden Bereichen:

Voraussetzungen

• Ein Archyl-Konto mit API-Zugang
• Ein API-Schluessel (erhaeltlich unter Einstellungen -> API-Schluessel im Archyl-Dashboard)
• Claude Code, Codex oder ein kompatibler Coding-Agent

Installation

Schritt 1: Den Marketplace hinzufuegen

Fuehren Sie den folgenden Befehl in Claude Code aus:

/plugin marketplace add archyl-com/agent-skills

Oeffnen Sie dann den Plugin-Manager, um automatische Updates zu konfigurieren:

1. Fuehren Sie /plugin aus
2. Waehlen Sie Marketplaces
3. Waehlen Sie archyl-marketplace aus der Liste
4. Waehlen Sie Enable auto-update oder Disable auto-update

Schritt 2: Das Plugin installieren

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

Starten Sie Claude Code nach der Installation neu.

Schritt 3: Den MCP-Server konfigurieren

Fuegen Sie den Archyl MCP-Server zur .mcp.json Ihres Projekts hinzu:

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

Ersetzen Sie arch_your_api_key_here durch Ihren tatsaechlichen API-Schluessel aus dem Archyl-Dashboard.

Andere Coding-Agents

Der Plugin-Inhalt ist mit jedem Agent kompatibel, der das Plugin-Format unterstuetzt. Sie koennen die Skill-Dateien auch direkt aus dem archyl-developer Plugin-Verzeichnis im Repository verwenden.

Gaengige Arbeitsablaeufe

Nach der Installation koennen Sie Ihren Coding-Agent bitten, Architekturaufgaben in natuerlicher Sprache auszufuehren. Hier sind einige gaengige Arbeitsablaeufe:

Ein neues Projekt dokumentieren

Bitten Sie Ihren Agent, Ihr Architekturmodell aufzubauen:

Create a new Archyl project for our e-commerce platform.
Add the main systems: WebApp, PaymentService, and PostgreSQL Database.
Then create containers for the API server and React frontend inside WebApp.

Der Agent ruft die entsprechenden MCP-Tools auf (create_project, create_system, create_container) und verbindet alles miteinander.

Bestehende Architektur analysieren

Get the full C4 model for my project and summarize the architecture.
Check the drift score — is the documentation still accurate?
Show me any open architecture insights.

Architekturregeln durchsetzen

Create a conformance rule that prevents any container from having
more than 10 direct dependencies. Then run a conformance check.

Architekturentscheidungen festhalten

Create an ADR titled "Migrate from REST to gRPC for internal services".
Set it as proposed, explain the context around latency requirements,
and link it to the ApiGateway and PaymentService containers.

Deployment-Performance pruefen

Show me the DORA metrics for the last month.
What's our deployment frequency and lead time trend?

Technology Radar verwalten

Show me the current technology radar.
Add "Temporal" as an adopted workflow orchestration technology
and tag it on the OrderProcessing container.

Funktionsweise

Das Plugin versorgt Ihren Coding-Agent mit strukturiertem Wissen ueber jedes Archyl MCP-Tool -- einschliesslich Parameter, erwarteter Werte und Best Practices. Wenn Sie Ihren Agent bitten, eine Architekturaufgabe auszufuehren, geschieht Folgendes:

1. Es werden die passenden MCP-Tools identifiziert
2. Die korrekten Parameter werden zusammengestellt (Projekt-IDs, Elementtypen, Beziehungstypen)
3. Mehrere Aufrufe werden fuer komplexe Arbeitsablaeufe verkettet
4. Eine Zusammenfassung des Erstellten oder Geaenderten wird zurueckgegeben

Der Agent beginnt immer mit dem Aufruf von list_projects, um verfuegbare Projekte zu ermitteln und die projectId fuer nachfolgende Operationen zu erhalten.

C4-Modell-Referenz

Das Plugin versteht alle 4 Ebenen des C4 model:

Namenskonventionen

Der Agent befolgt diese Benennungsregeln beim Erstellen von Elementen:

• Systems: PascalCase, beschreibend (PaymentPlatform, NotificationService)
• Containers: PascalCase mit Typhinweis (ApiServer, PostgresDatabase, RedisCache)
• Components: PascalCase, modulorientiert (AuthService, PaymentProcessor)
• Code-Elemente: Exakte Symbolnamen aus dem Quellcode

Beziehungstypen

Beim Verbinden von Elementen verwendet der Agent den passenden Beziehungstyp:

Mitwirken

Das Plugin ist Open Source. Sie koennen beitragen, indem Sie:

• Tool-Namen, Parameter oder Beschreibungen korrigieren
• Abdeckung fuer neue Archyl-Funktionen hinzufuegen
• Workflow-Beispiele verbessern
• Referenzdateien fuer fehlende Bereiche hinzufuegen

Details finden Sie im Contributing Guide.