Skills pour agents de développement

Archyl fournit 11 skills pour agents de développement qui amènent l'intégralité de votre architecture dans votre agent de développement — Claude Code, Codex, Cursor ou tout autre outil compatible. Au lieu de basculer entre votre éditeur et le tableau de bord Archyl, votre agent peut valider les changements avant que vous ne codiez, documenter ce qui a été livré, relire les pull requests à la lumière de votre modèle C4 et anticiper la dérive architecturale — le tout depuis le terminal.

Les skills sont open source et disponibles sur github.com/archyl-com/agent-skills.

Le workflow d'architecture AI-native

Les 11 skills fonctionnent ensemble pour former une boucle d'architecture continue :

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

Prérequis

• Un compte Archyl avec accès API
• Une clé API (obtenez-en une depuis Profil > Clés API dans le tableau de bord Archyl)
• Claude Code, Codex, Cursor 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 configurez les mises à jour automatiques :

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

Étape 2 : Installer le plugin

/plugin install archyl-developer@archyl-marketplace

Le plugin archyl-developer installe les 11 skills et le hook du Guard. Redémarrez votre agent de développement 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

Les fichiers de skills sont compatibles avec tout agent prenant en charge le format de plugin. Vous pouvez également les utiliser directement depuis le dépôt agent-skills pour Cursor, Codex ou d'autres outils.

Configuration rapide

Le moyen le plus rapide de démarrer est le script de configuration. Il génère tous les fichiers de configuration dont votre agent a besoin.

Le script de configuration

Exécutez depuis la racine de votre projet :

npx archyl-setup

Cela crée trois fichiers :

Modèle : CLAUDE.md

Le fichier CLAUDE.md généré contient des instructions comme celles-ci :

# 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.

Vous pouvez personnaliser ces modèles pour les adapter au workflow de votre équipe.

Skills principales

archyl-developer

La skill de base. Elle donne à votre agent une connaissance structurée des plus de 200 outils MCP d'Archyl dans les domaines suivants :

Exemples de 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

À lancer avant de commencer à coder pour valider l'approche prévue par rapport à l'architecture existante. Preflight confronte votre plan au modèle C4, aux règles de conformité et aux ADRs récents pour repérer les violations au plus tôt.

Exemples de 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.

La skill signale les problèmes tels que les violations de dépendances, les conflits de nommage ou les approches qui contredisent des ADRs existants — avant que vous n'écriviez la moindre ligne de code.

archyl-postship

À lancer après la livraison pour mettre à jour automatiquement votre documentation d'architecture. Elle analyse ce qui a changé dans la codebase et :

• Met à jour le modèle C4 (nouveaux conteneurs, composants, relations)
• Crée des ADRs pour les décisions importantes
• Ouvre des demandes de changement pour relecture par l'équipe si nécessaire

Exemples de 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

Le protocole de session de travail pour coder sous gouvernance — la skill derrière l'Archyl Harness. Elle enseigne à votre agent la boucle complète : plan_work avant de commencer, start_work_session pour obtenir un contexte ciblé et des réservations consultatives, remember/recall pour le graphe de connaissances du projet, et finish_work_session avec un bilan qui peut ouvrir une demande de changement d'architecture.

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

Skills de revue et de gouvernance

archyl-review

Un bot de revue d'architecture structurée. Il analyse les diffs à la lumière de votre modèle C4, de vos règles de conformité et de vos ADRs pour produire des commentaires de revue de code qui tiennent compte de l'architecture.

Exemples de 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

Génère un changelog d'architecture — une chronologie des changements incluant les ADRs, les releases, les vérifications de conformité, les événements de dérive et les mises à jour du modèle.

Exemples de 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

Lorsqu'une dérive est détectée entre votre code et votre documentation d'architecture, autofix propose des corrections concrètes — sur le code ou sur le modèle — pour les réaligner.

Exemples de 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.

Skills d'analyse

archyl-dora

Met en corrélation les changements d'architecture et les métriques de performance de livraison DORA. Voyez comment les décisions architecturales influent sur la fréquence de déploiement, le délai de mise en production, le taux d'échec des changements et le temps moyen de rétablissement.

Exemples de 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

Calcule l'impact financier des décisions d'architecture. Estime le temps gagné, les incidents évités et l'évolution de la productivité des développeurs liés aux améliorations architecturales.

Exemples de 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

Anticipe les problèmes architecturaux avant qu'ils ne surviennent. S'appuie sur les tendances historiques pour prédire la dérive, les régressions DORA et les points chauds de complexité.

Exemples de 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?

Orchestration

archyl-orchestrate

Coordonne plusieurs agents qui travaillent sur la même codebase. Gère la négociation des contrats d'API entre services et la résolution des conflits de dépendances, et veille à ce que les agents n'apportent pas de changements d'architecture contradictoires.

Exemples de 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.

Cette skill est particulièrement utile dans les configurations multi-agents où différents agents sont responsables de différents services et doivent négocier des contrats partagés sans se marcher sur les pieds.

Packs de règles de conformité

Archyl fournit des packs de règles de conformité prêts à l'emploi pour les patterns d'architecture courants — microservices, événementiel, en couches, et plus encore. Ces packs de règles fonctionnent avec toutes les skills ci-dessus pour faire respecter votre architecture automatiquement.

Consultez le guide des règles de conformité pour en savoir plus sur les packs de règles disponibles et sur la création de règles personnalisées.

SDKs

Si vous souhaitez intégrer Archyl dans des outils sur mesure au-delà des agents de développement, des SDKs sont disponibles pour TypeScript, Python et Go.

Consultez la documentation du serveur MCP pour les détails des SDKs et la référence de l'API.

Comment ça fonctionne

Chaque skill fournit à votre agent de développement une connaissance structurée d'outils MCP Archyl spécifiques — 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 en s'appuyant sur les connaissances de la skill
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éé, modifié ou signalé

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

Les skills comprennent les 4 niveaux du modèle C4 :

Types de relations

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

Contribuer

Les skills sont 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
• Créant de nouveaux fichiers de skills pour d'autres cas d'usage

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