Gérez votre modèle C4 depuis Claude Code et le terminal

Le mois dernier, j'ai regardé un développeur de notre équipe faire quelque chose qui semblait ne pas devoir fonctionner.

Il était en pleine session de refactoring dans Claude Code, en train de découper un service monolithique en trois plus petits. À mi-chemin, il a tapé : "Crée trois nouveaux containers dans Archyl — OrderService, InventoryService et NotificationService — sous le système ECommerce. Ajoute des relations 'calls' entre OrderService et les deux autres."

Dix secondes plus tard, le modèle C4 dans Archyl avait trois nouveaux containers, correctement reliés par des relations, places exactement là où ils devaient être dans l'architecture. Il n'a jamais changé d'onglet. Il n'a jamais ouvert de navigateur. Il a juste continue à coder.

C'est à ce moment-là que j'ai realise que le plugin était prêt à être livré.

Le Problème du Changement de Contexte

La documentation d'architecture a un problème fondamental d'expérience utilisateur : elle vit dans un endroit différent du code.

Vous êtes dans votre IDE. Vous venez de restructurer un module, renommer trois services et séparer une base de données en replicas de lecture et d'écriture. Le code est terminé. Maintenant vous devez mettre à jour l'architecture. Cela signifie ouvrir Archyl dans un navigateur, trouver le bon projet, naviguer vers le bon diagramme, mettre à jour les containers, ajouter des relations, peut-être rédiger un ADR pour expliquer pourquoi vous avez fait ce changement.

Ça prend cinq minutes. Mais ces cinq minutes ont un coût cache : le changement de contexte. Votre cerveau doit quitter le code, entrer dans un mode de diagramme visuel, se souvenir de ce que vous venez de faire, le traduire en concepts d'architecture, puis revenir au code. La plupart des développeurs ne le font tout simplement... pas. Ils se disent qu'ils mettront à jour la documentation plus tard. Plus tard n'arrive jamais.

C'est pourquoi la dérive d'architecture existe. Pas parce que les équipes ne se soucient pas de la documentation, mais parce que l'outil est au mauvais endroit au mauvais moment.

L'Architecture dans Votre Conversation

Le Plugin Développeur Archyl place toute votre architecture dans le contexte de votre agent de code. C'est un plugin pour Claude Code (et compatible avec Codex et d'autres agents) qui apprend à l'agent comment utiliser les 181 outils MCP d'Archyl.

Qu'est-ce que ça signifie en pratique ? Ça veut dire que vous pouvez faire ceci :

Pendant un refactoring, dites a votre agent de mettre a jour l'architecture :

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.

Pendant une revue de code, interrogez le contexte architectural :

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?

Pendant la planification de travail, vérifiez si la documentation est toujours à jour :

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

Après une réunion de conception, enregistrez la décision sans quitter votre terminal :

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.

L'agent gère les appels MCP, gère les IDs de projet et chaîne les opérations ensemble. Vous décrivez simplement ce que vous voulez en langage naturel.

Ce que le Plugin Couvre

Le plugin donne à votre agent des connaissances structurées dans sept domaines :

Modélisation C4 — Créez et gérez des systèmes, containers, composants, éléments de code et relations. L'agent comprend la hiérarchie C4 et applique les conventions de nommage appropriées (PascalCase pour les systèmes et containers, noms de symboles exacts pour les éléments de code).

Documentation — Rédigez des ADRs, créez des documents de projet, définissez des flux utilisateur et consultez les insights générés par l'IA. Les ADRs sont liés aux éléments C4 qu'ils concernent, de sorte que les décisions architecturales restent connectées à l'architecture.

Gouvernance — Créez des règles de conformité, lancez des vérifications de conformité et surveillez la dérive d'architecture. L'agent peut mettre en place des garde-fous avant même qu'une session de codage IA ne commence.

Opérations — Suivez les releases à travers les environnements, documentez les contrats d'API (OpenAPI, gRPC, GraphQL), cartographiez les canaux d'événements (Kafka, NATS, SQS) et gérez le radar technologique.

Collaboration — Ajoutez des commentaires, créez des demandes de changement (comme des PRs pour l'architecture) et gérez les tableaux blancs. Les discussions d'architecture se déroulent là où se déroulent les discussions sur le code.

Historique — Prenez des snapshots, voyagez dans le temps à travers les versions de l'architecture et comparez les changements. Quand quelqu'un demande "à quoi ressemblait l'architecture avant la migration ?", l'agent peut répondre.

Intégrations — Configurez des webhooks pour les notifications de changements d'architecture, gérez les widgets du marketplace et visualisez l'architecture globale de tous les projets de l'organisation.

Trois Étapes pour la Mise en Place

La mise en place est simple :

1. Ajoutez le marketplace et installez le plugin :

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

2. Ajoutez le serveur MCP 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"
            }
        }
    }
}

3. Redémarrez votre agent et commencez à parler à votre architecture.

C'est tout. Le plugin se charge automatiquement et l'agent sait comment utiliser chaque outil. Pas de fichiers de configuration, pas de prompts personnalisés, pas de câblage manuel.

Pourquoi l'Open Source

Le plugin est entièrement open source sur github.com/archyl-com/agent-skills. Il y a plusieurs raisons à cela.

Premièrement, la transparence. Quand un plugin apprend à un agent IA comment interagir avec votre architecture, vous devriez pouvoir lire chaque instruction qu'il donne. La définition du skill, les fichiers de référence, les exemples de workflows — tout est la, en markdown.

Deuxièmement, les contributions. Archyl a 181 outils MCP, et les meilleurs workflows emergent de l'utilisation réelle. Quand une équipe découvre un pattern qui fonctionne — par exemple, un workflow pour auditer l'architecture avant une release majeure — elle peut le contribuer en retour. Le plugin s'améliore parce que la communauté l'utilise.

Troisièmement, la portabilité. Le contenu du skill n'est pas verrouillé dans Claude Code. Il fonctionne avec n'importe quel agent qui supporte le format plugin. Les manifestes .claude-plugin et .codex-plugin sont tous les deux inclus. Si un nouvel agent de code apparaît le mois prochain avec le support des plugins, le contenu du skill se transfère directement.

Ce qui Change

Le changement est subtil mais significatif.

Avant le plugin, la documentation d'architecture était une activité séparée. Vous écriviez du code, puis vous documentiez. Deux workflows, deux outils, deux modes mentaux. La documentation était toujours en retard parce qu'elle était toujours à distance.

Avec le plugin, la documentation d'architecture devient partie intégrante de la conversation de code. Vous ne "mettez pas à jour la doc" — vous mentionnez ce qui a changé et l'agent s'en occupe. L'architecture reste synchronisée non pas parce que quelqu'un a pensé à la mettre à jour, mais parce que la mettre à jour est devenu sans effort.

C'est particulièrement puissant dans les workflows agentiques. Quand un agent IA effectue des changements dans votre codebase, il peut simultanément mettre à jour l'architecture. La même session qui refactorise le code met aussi à jour le modèle C4, enregistre l'ADR et lance une vérification de conformité. La gouvernance d'architecture devient une partie naturelle du flux de développement, pas une réflexion après coup.

Pour Commencer

Installez le plugin, connectez votre serveur MCP et essayez de demander à votre agent de décrire votre architecture. Puis demandez-lui de faire un changement. La première fois que vous mettrez à jour un modèle C4 depuis une conversation dans le terminal, vous vous demanderez pourquoi ça a jamais fonctionné autrement.

Le plugin est disponible des maintenant. La documentation complète se trouve dans nos guides, et le code source est sur GitHub.

Votre architecture ne devrait pas vivre dans un autre onglet. Maintenant, elle n'a plus a le faire.