Plugin pour Agent de Code : Gerez Votre Architecture Sans Quitter Votre Terminal

Le mois dernier, j'ai regarde un developpeur de notre equipe faire quelque chose qui semblait ne pas devoir fonctionner.

Il etait en pleine session de refactoring dans Claude Code, en train de decouper un service monolithique en trois plus petits. A mi-chemin, il a tape : "Cree trois nouveaux containers dans Archyl — OrderService, InventoryService et NotificationService — sous le systeme ECommerce. Ajoute des relations 'calls' entre OrderService et les deux autres."

Dix secondes plus tard, le modele C4 dans Archyl avait trois nouveaux containers, correctement relies par des relations, places exactement la ou ils devaient etre dans l'architecture. Il n'a jamais change d'onglet. Il n'a jamais ouvert de navigateur. Il a juste continue a coder.

C'est a ce moment-la que j'ai realise que le plugin etait pret a etre livre.

Le Probleme du Changement de Contexte

La documentation d'architecture a un probleme fondamental d'experience utilisateur : elle vit dans un endroit different du code.

Vous etes dans votre IDE. Vous venez de restructurer un module, renommer trois services et separer une base de donnees en replicas de lecture et d'ecriture. Le code est termine. Maintenant vous devez mettre a jour l'architecture. Cela signifie ouvrir Archyl dans un navigateur, trouver le bon projet, naviguer vers le bon diagramme, mettre a jour les containers, ajouter des relations, peut-etre rediger un ADR pour expliquer pourquoi vous avez fait ce changement.

Ca prend cinq minutes. Mais ces cinq minutes ont un cout 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 developpeurs ne le font tout simplement... pas. Ils se disent qu'ils mettront a jour la documentation plus tard. Plus tard n'arrive jamais.

C'est pourquoi la derive d'architecture existe. Pas parce que les equipes 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 Developpeur 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 a l'agent comment utiliser les 200+ outils MCP d'Archyl.

Qu'est-ce que ca signifie en pratique ? Ca 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, verifiez si la documentation est toujours a jour :

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

Apres une reunion de conception, enregistrez la decision 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 gere les appels MCP, gere les IDs de projet et chaine les operations ensemble. Vous decrivez simplement ce que vous voulez en langage naturel.

Ce que le Plugin Couvre

Le plugin donne a votre agent des connaissances structurees dans sept domaines :

Modelisation C4 — Creez et gerez des systemes, containers, composants, elements de code et relations. L'agent comprend la hierarchie C4 et applique les conventions de nommage appropriees (PascalCase pour les systemes et containers, noms de symboles exacts pour les elements de code).

Documentation — Redigez des ADRs, creez des documents de projet, definissez des flux utilisateur et consultez les insights generes par l'IA. Les ADRs sont lies aux elements C4 qu'ils concernent, de sorte que les decisions architecturales restent connectees a l'architecture.

Gouvernance — Creez des regles de conformite, lancez des verifications de conformite et surveillez la derive d'architecture. L'agent peut mettre en place des garde-fous avant meme qu'une session de codage IA ne commence.

Operations — Suivez les releases a travers les environnements, documentez les contrats d'API (OpenAPI, gRPC, GraphQL), cartographiez les canaux d'evenements (Kafka, NATS, SQS) et gerez le radar technologique.

Collaboration — Ajoutez des commentaires, creez des demandes de changement (comme des PRs pour l'architecture) et gerez les tableaux blancs. Les discussions d'architecture se deroulent la ou se deroulent les discussions sur le code.

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

Integrations — Configurez des webhooks pour les notifications de changements d'architecture, gerez les widgets du marketplace et visualisez l'architecture globale de tous les projets de l'organisation.

Trois Etapes 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. Redemarrez votre agent et commencez a parler a 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 personnalises, pas de cablage manuel.

Pourquoi l'Open Source

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

Premierement, la transparence. Quand un plugin apprend a un agent IA comment interagir avec votre architecture, vous devriez pouvoir lire chaque instruction qu'il donne. La definition du skill, les fichiers de reference, les exemples de workflows — tout est la, en markdown.

Deuxiemement, les contributions. Archyl a plus de 200 outils MCP, et les meilleurs workflows emergent de l'utilisation reelle. Quand une equipe decouvre 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'ameliore parce que la communaute l'utilise.

Troisiemement, la portabilite. Le contenu du skill n'est pas verrouille 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 apparait le mois prochain avec le support des plugins, le contenu du skill se transfere directement.

Ce qui Change

Le changement est subtil mais significatif.

Avant le plugin, la documentation d'architecture etait une activite separee. Vous ecriviez du code, puis vous documentiez. Deux workflows, deux outils, deux modes mentaux. La documentation etait toujours en retard parce qu'elle etait toujours a distance.

Avec le plugin, la documentation d'architecture devient partie integrante de la conversation de code. Vous ne "mettez pas a jour la doc" — vous mentionnez ce qui a change et l'agent s'en occupe. L'architecture reste synchronisee non pas parce que quelqu'un a pense a la mettre a jour, mais parce que la mettre a jour est devenu sans effort.

C'est particulierement puissant dans les workflows agentiques. Quand un agent IA effectue des changements dans votre codebase, il peut simultanement mettre a jour l'architecture. La meme session qui refactorise le code met aussi a jour le modele C4, enregistre l'ADR et lance une verification de conformite. La gouvernance d'architecture devient une partie naturelle du flux de developpement, pas une reflexion apres coup.

Pour Commencer

Installez le plugin, connectez votre serveur MCP et essayez de demander a votre agent de decrire votre architecture. Puis demandez-lui de faire un changement. La premiere fois que vous mettrez a jour un modele C4 depuis une conversation dans le terminal, vous vous demanderez pourquoi ca a jamais fonctionne autrement.

Le plugin est disponible des maintenant. La documentation complete 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.