Coding-Agent-Skills

Archyl liefert 11 Coding-Agent-Skills, die Ihre gesamte Architektur in Ihren Coding-Agent bringen — Claude Code, Codex, Cursor oder jedes kompatible Tool. Anstatt zwischen Ihrem Editor und dem Archyl-Dashboard zu wechseln, kann Ihr Agent Änderungen validieren, bevor Sie mit dem Programmieren beginnen, dokumentieren, was ausgeliefert wurde, Pull Requests gegen Ihr C4-Modell prüfen und Architektur-Drift vorhersagen — alles aus dem Terminal.

Die Skills sind Open Source und verfügbar unter github.com/archyl-com/agent-skills.

Der KI-native Architektur-Workflow

Die 11 Skills greifen ineinander und bilden eine kontinuierliche Architekturschleife:

preflight → code → review → CI (GitHub Actions) → postship → generate context
    ↑                                                              |
    └──────────────────────────────────────────────────────────────┘

Voraussetzungen

• Ein Archyl-Konto mit API-Zugang
• Ein API-Schlüssel (erhältlich unter Profil > API-Schlüssel im Archyl-Dashboard)
• Claude Code, Codex, Cursor oder ein kompatibler Coding-Agent

Installation

Schritt 1: Den Marketplace hinzufügen

Führen Sie den folgenden Befehl in Claude Code aus:

/plugin marketplace add archyl-com/agent-skills

Konfigurieren Sie anschließend die automatischen Updates:

1. Führen Sie /plugin aus
2. Wählen Sie Marketplaces
3. Wählen Sie archyl-marketplace
4. Wählen Sie Enable auto-update

Schritt 2: Das Plugin installieren

/plugin install archyl-developer@archyl-marketplace

Das Plugin archyl-developer installiert alle 11 Skills und den Guard-Hook. Starten Sie Ihren Coding-Agent nach der Installation neu.

Schritt 3: Den MCP-Server konfigurieren

Fügen 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 tatsächlichen API-Schlüssel aus dem Archyl-Dashboard.

Andere Coding-Agenten

Die Skill-Dateien sind mit jedem Agent kompatibel, der das Plugin-Format unterstützt. Für Cursor, Codex oder andere Tools können Sie sie auch direkt aus dem agent-skills-Repository verwenden.

Schnelleinrichtung

Am schnellsten starten Sie mit dem Setup-Skript. Es erzeugt alle Konfigurationsdateien, die Ihr Agent benötigt.

Das Setup-Skript

Führen Sie es im Stammverzeichnis Ihres Projekts aus:

npx archyl-setup

Dabei entstehen drei Dateien:

Vorlage: CLAUDE.md

Die generierte CLAUDE.md enthält Anweisungen wie diese:

# Architecture

This project is documented in Archyl (project ID: `proj_xxx`).

## Before coding
Run `/archyl-preflight` to validate your approach against the architecture.

## After shipping
Run `/archyl-postship` to update the C4 model and create ADRs.

## Architecture rules
Always run `/archyl-review` before requesting a code review.

Sie können diese Vorlagen an den Workflow Ihres Teams anpassen.

Kern-Skills

archyl-developer

Der grundlegende Skill. Er gibt Ihrem Agent strukturiertes Wissen über Archyls 200+ MCP-Tools in folgenden Bereichen:

Beispiel-Prompts:

Create a new system called PaymentPlatform with containers for
the API server, a PostgreSQL database, and a React frontend.

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.

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

archyl-preflight

Führen Sie diesen Skill vor dem Programmieren aus, um Ihren geplanten Ansatz gegen die bestehende Architektur zu validieren. Preflight prüft Ihren Plan gegen das C4-Modell, die Konformitätsregeln und aktuelle ADRs, damit Verstöße früh auffallen.

Beispiel-Prompts:

/archyl-preflight I'm planning to add a new Redis cache between the
API server and the database to reduce read latency.

/archyl-preflight We want to split the UserService into separate
authentication and profile services.

Der Skill meldet Probleme wie Abhängigkeitsverstöße, Namenskonflikte oder Ansätze, die bestehenden ADRs widersprechen — bevor Sie eine einzige Zeile Code schreiben.

archyl-postship

Führen Sie diesen Skill nach dem Ausliefern aus, um Ihre Architekturdokumentation automatisch zu aktualisieren. Er analysiert, was sich in der Codebasis geändert hat, und:

• aktualisiert das C4-Modell (neue Container, Komponenten, Beziehungen)
• erstellt ADRs für wesentliche Entscheidungen
• öffnet bei Bedarf Änderungsanträge zur Prüfung durch das Team

Beispiel-Prompts:

/archyl-postship We just shipped the Redis caching layer.
Update the architecture to reflect the new cache container
and its relationships.

/archyl-postship Document the authentication service split
we shipped this sprint.

archyl-harness

Das Arbeitssession-Protokoll für das Programmieren unter Governance — der Skill hinter dem Archyl Harness. Er bringt Ihrem Agent die komplette Schleife bei: plan_work vor dem Start, start_work_session für fokussierten Kontext und Advisory Leases, remember/recall für den Wissensgraphen des Projekts und finish_work_session mit einem Ergebnis, das einen Architektur-Änderungsantrag eröffnen kann.

Work under the harness: plan, declare a session, respect the
guardrails, and finish with an honest summary.

Review- und Governance-Skills

archyl-review

Ein strukturierter Bot für Architektur-Reviews. Er analysiert Diffs gegen Ihr C4-Modell, Ihre Konformitätsregeln und ADRs und liefert architekturbewusste Code-Review-Kommentare.

Beispiel-Prompts:

/archyl-review Review the current branch against the architecture.
Flag any conformance violations or undocumented dependencies.

/archyl-review Check if PR #42 introduces any new cross-system
dependencies that aren't in the C4 model.

archyl-changelog

Erstellt ein Architektur-Changelog — eine Zeitleiste der Änderungen, einschließlich ADRs, Releases, Konformitätsprüfungen, Drift-Ereignissen und Modellaktualisierungen.

Beispiel-Prompts:

/archyl-changelog Show the architecture timeline for the last month.

/archyl-changelog What changed in the PaymentPlatform system
since the v2.0 release?

archyl-autofix

Wird Drift zwischen Ihrem Code und Ihrer Architekturdokumentation erkannt, schlägt Autofix konkrete Korrekturen vor — entweder am Code oder am Modell —, um beide wieder in Einklang zu bringen.

Beispiel-Prompts:

/archyl-autofix We have drift on the PaymentService container.
Propose fixes to resolve it.

/archyl-autofix Show all current drift issues and suggest
the fastest path to zero drift.

Intelligence-Skills

archyl-dora

Setzt Architekturänderungen in Beziehung zu den DORA-Metriken für die Delivery-Performance. So sehen Sie, wie sich Architekturentscheidungen auf Deployment-Frequenz, Lead Time, Change Failure Rate und Mean Time to Recovery auswirken.

Beispiel-Prompts:

/archyl-dora Show DORA metrics for the last quarter.
Did the microservice split improve deployment frequency?

/archyl-dora Correlate recent architecture changes
with our change failure rate trend.

archyl-roi

Berechnet die finanziellen Auswirkungen von Architekturentscheidungen. Schätzt eingesparte Zeit, verhinderte Incidents und Veränderungen der Entwicklerproduktivität durch Architekturverbesserungen.

Beispiel-Prompts:

/archyl-roi What's the estimated ROI of our migration
from monolith to microservices?

/archyl-roi Calculate the cost of our current architectural
drift vs the cost of fixing it.

archyl-predict

Sagt künftige Architekturprobleme voraus, bevor sie auftreten. Nutzt historische Trends, um Drift, DORA-Regressionen und Komplexitäts-Hotspots vorherzusagen.

Beispiel-Prompts:

/archyl-predict Which components are most likely to drift
in the next 30 days?

/archyl-predict Based on current trends, will our deployment
frequency regress this quarter? Which services are at risk?

Orchestrierung

archyl-orchestrate

Koordiniert mehrere Agenten, die an derselben Codebasis arbeiten. Übernimmt die Aushandlung von API-Verträgen zwischen Services und die Auflösung von Abhängigkeitskonflikten und stellt sicher, dass Agenten keine widersprüchlichen Architekturänderungen vornehmen.

Beispiel-Prompts:

/archyl-orchestrate Two agents are modifying services that share
an API contract. Coordinate the changes to avoid conflicts.

/archyl-orchestrate Agent A is adding a new field to the
UserService API. Check if Agent B's PaymentService integration
will break.

Dieser Skill ist besonders nützlich in Multi-Agent-Setups, in denen verschiedene Agenten verschiedene Services verantworten und gemeinsame Verträge aushandeln müssen, ohne sich gegenseitig in die Quere zu kommen.

Regelpakete für Konformitätsregeln

Archyl liefert vorgefertigte Regelpakete für gängige Architekturmuster — Microservices, ereignisgesteuerte Architektur, Schichtenarchitektur und mehr. Diese Regelpakete arbeiten mit allen oben genannten Skills zusammen, um Ihre Architektur automatisch durchzusetzen.

Details zu den verfügbaren Regelpaketen und zum Erstellen eigener Regeln finden Sie im Leitfaden zu Konformitätsregeln.

SDKs

Wenn Sie Archyl über Coding-Agenten hinaus in eigene Tools integrieren möchten, stehen SDKs für TypeScript, Python und Go zur Verfügung.

SDK-Details und die API-Referenz finden Sie in der Dokumentation zum MCP-Server.

Funktionsweise

Jeder Skill versorgt Ihren Coding-Agent mit strukturiertem Wissen über bestimmte Archyl-MCP-Tools — einschließlich Parameter, erwarteter Werte und Best Practices. Wenn Sie Ihren Agent bitten, eine Architekturaufgabe auszuführen, geht er so vor:

1. Ermittelt, welche MCP-Tools anhand des Skill-Wissens aufzurufen sind
2. Stellt die korrekten Parameter zusammen (Projekt-IDs, Elementtypen, Beziehungstypen)
3. Verkettet mehrere Aufrufe für komplexe Workflows
4. Gibt eine Zusammenfassung dessen zurück, was erstellt, geändert oder gemeldet wurde

Der Agent beginnt immer mit dem Aufruf von list_projects, um die verfügbaren Projekte zu ermitteln und die projectId für nachfolgende Operationen zu erhalten.

C4-Modell-Referenz

Die Skills verstehen alle 4 Ebenen des C4-Modells:

Beziehungstypen

Beim Verbinden von Elementen verwendet der Agent den passenden Beziehungstyp:

Mitwirken

Die Skills sind Open Source. Sie können beitragen, indem Sie:

• Tool-Namen, Parameter oder Beschreibungen korrigieren
• Abdeckung für neue Archyl-Funktionen hinzufügen
• Workflow-Beispiele verbessern
• neue Skill-Dateien für weitere Anwendungsfälle erstellen

Details finden Sie im Contributing Guide.