Plugin pour agent de développement

Le Plugin Développeur Archyl vous permet de gérer l'intégralité de votre modèle d'architecture C4 directement depuis votre agent de développement — Claude Code, Codex ou tout autre outil compatible. Au lieu de basculer entre votre éditeur et le tableau de bord Archyl, vous pouvez créer des systèmes, des conteneurs, des composants, des ADRs, des règles de conformité et bien plus encore sans quitter votre terminal.

Le plugin est open source et disponible sur github.com/archyl-com/agent-skills.

Ce que vous pouvez faire

Le plugin donne à votre agent une connaissance approfondie des plus de 200 outils MCP d'Archyl dans les domaines suivants :

Prérequis

• Un compte Archyl avec accès API
• Une clé API (obtenez-en une depuis Paramètres → Clés API dans le tableau de bord Archyl)
• Claude Code, Codex ou un agent de développement compatible

Installation

Étape 1 : Ajouter le Marketplace

Exécutez la commande suivante dans Claude Code :

/plugin marketplace add archyl-com/agent-skills

Puis ouvrez le gestionnaire de plugins pour configurer les mises à jour automatiques :

1. Exécutez /plugin
2. Sélectionnez Marketplaces
3. Choisissez archyl-marketplace dans la liste
4. Sélectionnez Enable auto-update ou Disable auto-update

Étape 2 : Installer le plugin

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

Redémarrez Claude Code après l'installation.

Étape 3 : Configurer le serveur MCP

Ajoutez le serveur MCP Archyl au fichier .mcp.json de votre projet :

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

Remplacez arch_your_api_key_here par votre clé API réelle obtenue depuis le tableau de bord Archyl.

Autres agents de développement

Le contenu du plugin est compatible avec tout agent supportant le format de plugin. Vous pouvez également utiliser les fichiers de compétences directement depuis le répertoire du plugin archyl-developer dans le dépôt.

Workflows courants

Une fois installé, vous pouvez demander à votre agent de développement d'effectuer des tâches d'architecture en langage naturel. Voici quelques workflows courants :

Documenter un nouveau projet

Demandez à votre agent de structurer votre modèle d'architecture :

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.

L'agent appellera les outils MCP appropriés (create_project, create_system, create_container) et reliera le tout.

Analyser l'architecture existante

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.

Appliquer des règles d'architecture

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

Enregistrer des décisions d'architecture

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.

Vérifier les performances de déploiement

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

Gérer le radar technologique

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

Comment ça fonctionne

Le plugin fournit à votre agent de développement une connaissance structurée de chaque outil MCP d'Archyl — incluant les paramètres, les valeurs attendues et les bonnes pratiques. Lorsque vous demandez à votre agent d'effectuer une tâche d'architecture, il :

1. Identifie les outils MCP à appeler
2. Construit les paramètres corrects (identifiants de projet, types d'éléments, types de relations)
3. Enchaîne plusieurs appels pour les workflows complexes
4. Retourne un résumé de ce qui a été créé ou modifié

L'agent commence toujours par appeler list_projects pour découvrir les projets disponibles et obtenir le projectId nécessaire aux opérations suivantes.

Référence du modèle C4

Le plugin comprend les 4 niveaux du modèle C4 :

Conventions de nommage

L'agent suit ces règles de nommage lors de la création d'éléments :

• Systems : PascalCase, descriptif (PaymentPlatform, NotificationService)
• Containers : PascalCase avec indication de type (ApiServer, PostgresDatabase, RedisCache)
• Components : PascalCase, orienté module (AuthService, PaymentProcessor)
• Éléments de code : Noms de symboles exacts tels qu'ils apparaissent dans le code source

Types de relations

Lors de la connexion d'éléments, l'agent utilise le type de relation approprié :

Contribuer

Le plugin est open source. Vous pouvez contribuer en :

• Corrigeant les noms d'outils, paramètres ou descriptions
• Ajoutant la couverture de nouvelles fonctionnalités Archyl
• Améliorant les exemples de workflows
• Ajoutant des fichiers de référence pour les domaines manquants

Consultez le guide de contribution pour plus de détails.