Les agents IA ecrivent desormais la majorite du code. Mais qui s'assure qu'ils respectent l'architecture ? Aujourd'hui, nous lancons 10 skills pour agents, 6 GitHub Actions, des packs de regles de conformite, des SDKs et trois nouvelles APIs alimentees par l'IA -- tout ce dont vos agents ont besoin pour comprendre, valider et faire evoluer votre architecture automatiquement.

Architecture Intelligence pour les equipes AI-native

Quelque chose a change ces six derniers mois. Les agents IA sont passes de l'ecriture de fonctions a l'ecriture de services entiers. Claude Code, Cursor, Codex -- ce ne sont plus des assistants. Ce sont des membres de l'equipe. Ils ouvrent des PRs, font des revues de code, livrent des fonctionnalites.

Mais voici ce qui m'empeche de dormir : ces agents n'ont aucune idee de ce a quoi ressemble l'architecture.

Un agent peut ecrire un service Go parfaitement propre en dix minutes. Mais il ne sait pas que l'equipe a decide il y a trois mois de faire transiter toute la communication inter-services par Kafka. Il ne sait pas que le service de paiement interdit tout acces direct a la base de donnees. Il ne sait pas que Python a ete deplace en "hold" sur le radar technologique le trimestre dernier.

Le resultat ? Du drift architectural a la vitesse des machines.

Nous avons construit Archyl pour resoudre ce probleme. Et aujourd'hui, nous livrons la plus grosse mise a jour depuis le lancement : Architecture Intelligence -- un ecosysteme complet qui fait d'Archyl le systeme nerveux du developpement AI-native.

Le probleme : les agents codent vite, mais codent a l'aveugle

Quand un developpeur humain rejoint une equipe, il passe des jours a lire la documentation, poser des questions, construire un modele mental du systeme. Il apprend les regles -- ecrites et tacites. Il comprend les limites.

Les agents IA sautent toutes ces etapes. Ils recoivent une tache, ecrivent du code, ouvrent une PR. Si personne ne detecte la violation architecturale lors de la revue, elle est livree. Multipliez ca par dix agents travaillant sur dix services repartis sur trois equipes, et votre architecture soigneusement concue s'erode en quelques semaines.

Nous avons vu cela se produire. Une equipe avec un modele C4 impeccable en janvier avait un score de drift de 40 % en mars. Pas parce qu'elle avait cesse de s'en soucier -- mais parce que ses agents ne savaient pas que l'architecture existait.

La solution : l'architecture comme infrastructure

La documentation d'architecture ne devrait pas etre quelque chose que l'on maintient. Elle devrait etre quelque chose qui se maintient tout seul -- et que chaque agent consulte avant d'ecrire la moindre ligne de code.

C'est ce que nous avons construit. Voici ce que nous livrons aujourd'hui.

10 skills pour agents

Le skill original archyl-developer donnait aux agents acces a plus de 200 outils MCP. Mais c'etait une boite a outils sans workflow. Aujourd'hui, nous ajoutons neuf skills specialises qui couvrent l'ensemble du cycle de developpement :

Avant de coder

archyl-preflight -- Executez-le avant d'implementer une fonctionnalite. Il verifie votre approche par rapport au modele C4, aux regles de conformite, au radar technologique et aux contrats d'API. Vous obtenez un verdict clair PASS / WARN / FAIL avant d'ecrire la moindre ligne de code.

> Je m'apprete a ajouter un cache Redis au service utilisateur. Est-ce que c'est ok ?

Verification Preflight : AVERTISSEMENT
- Redis est approuve sur le radar technologique ✓
- Le service utilisateur existe dans le modele C4 ✓
- ⚠ Aucun conteneur de cache documente -- suggestion d'en creer un
- ⚠ La regle "Pas d'acces direct a la DB depuis les handlers" s'applique -- assurez-vous que le cache est accede via la couche service

Apres la livraison

archyl-postship -- Executez-le apres la livraison. Il analyse ce que vous venez de construire, met a jour le modele C4, cree des ADRs pour les decisions architecturales et soumet des Change Requests pour revue par l'architecte. Votre documentation se met a jour d'elle-meme comme effet de bord de votre travail.

Pendant la revue

archyl-review -- Un bot de revue d'architecture. Il verifie le diff de votre PR par rapport a l'architecture documentee et fournit un feedback structure : violations de conformite, franchissements de frontieres, technologies non approuvees, contrats d'API manquants. Pensez a ESLint, mais pour l'architecture.

Pour la visibilite

archyl-changelog -- Genere une timeline lisible de tous les changements d'architecture : nouveaux services, relations modifiees, decisions ADR, evolution du drift. Ideal pour les reunions de revue d'architecture.

archyl-dora -- Correle les metriques DORA avec les changements d'architecture. Votre decomposition en microservices a-t-elle ameliore le lead time ? Le pic de drift a-t-il precede l'augmentation du taux d'echec des changements ? Maintenant vous avez les donnees.

archyl-roi -- Quantifie l'impact financier des decisions architecturales. "Notre investissement dans les regles de conformite a permis d'economiser environ 23 000 $ le trimestre dernier en reduisant le retravail." C'est le genre de donnees qui fait approuver les budgets d'architecture.

Pour la prevention

archyl-predict -- Prevoit les risques architecturaux avant qu'ils ne se materialisent. "Au rythme actuel, votre score de drift depassera 50 % d'ici mai. Le PaymentService a 12 dependances entrantes -- envisagez une decomposition."

archyl-autofix -- Quand du drift est detecte, propose des correctifs specifiques. Soit mettre a jour la documentation pour correspondre au code, soit suggerer des modifications de code pour se realigner sur l'architecture. Cree des Change Requests pour revue humaine.

Pour la coordination

archyl-orchestrate -- Quand plusieurs agents travaillent sur differents services simultanement, ce skill negocie les contrats d'API, resout les conflits de dependances et s'assure que les changements inter-equipes ne cassent pas l'architecture.

6 GitHub Actions

La gouvernance architecturale a sa place dans la CI. Nous livrons six GitHub Actions qui s'executent automatiquement sur chaque PR et merge :

Action	Declencheur	Ce qu'elle fait
conformance-check	PR	Execute les regles de conformite sur les fichiers modifies, annote les violations en ligne
drift-score	PR	Calcule le score de drift, poste en commentaire de PR, echoue en dessous du seuil
generate-context	Push sur main	Genere `archyl.txt` -- un briefing architectural optimise en tokens pour les agents
auto-cr	Push sur main	Cree automatiquement des Change Requests d'architecture a partir des diffs de merge
release	Deploy	Suit les releases dans Archyl avec l'environnement et la version
sync	Push sur main	Synchronise le DSL `archyl.yaml` pour maintenir l'architecture as code

La configuration recommandee tient en un seul fichier :

name: Architecture
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  pr-checks:
    if: github.event_name == 'pull_request'
    uses: archyl-com/actions/.github/workflows/archyl-pr.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
      drift-threshold: 70
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

  main-update:
    if: github.event_name == 'push'
    uses: archyl-com/actions/.github/workflows/archyl-main.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

Pas sur GitHub ? Nous fournissons aussi des templates pour GitLab CI et Bitbucket Pipelines.

Packs de regles de conformite

Mettre en place une gouvernance architecturale de zero est fastidieux. Nous avons donc construit cinq packs de regles pre-configures que vous pouvez installer en quelques secondes :

Pack	Regles	Ce qu'il impose
Microservices	10	Pas de bases de donnees partagees, deploiement independant, communication bornee
Clean Architecture	9	Frontieres entre couches, isolation du domaine, patterns port/adaptateur
Event-Driven	8	Conformite des canaux, exigences de schemas, dead letter queues
API-First	8	Exigences de contrats, versioning, documentation de l'authentification
Security Baseline	8	Application des gateways, gestion des secrets, controles d'acces

Installation via le skill agent : "Installe le pack de regles de conformite microservices." C'est fait.

SDKs

Pour les equipes qui construisent des integrations personnalisees, nous publions des SDKs officiels :

npm install @archyl/sdk    # Node.js 18+, zero dependances
pip install archyl-sdk     # Python 3.10+

const archyl = new ArchylClient({ apiKey: 'arch_...', organizationId: 'uuid' });
const drift = await archyl.governance.computeDrift(projectId);
const predictions = await archyl.projects.getPredictions(projectId);

Trois nouvelles APIs alimentees par l'IA

Sous le capot, nous livrons trois nouvelles capacites backend :

Predictive Analytics (GET /projects/:id/predict) -- Une vraie analyse statistique. Regression lineaire sur les scores de drift, trajectoires des metriques DORA, taux de degradation de la conformite et detection de hotspots de complexite via l'analyse de couplage fan-in/fan-out. Pas du feeling -- des maths.

Architecture Diff Analysis (POST /projects/:id/architecture-diff) -- Envoyez un diff git, recevez un delta de modele C4 structure. Analyse alimentee par l'IA qui detecte les nouveaux services, les dependances modifiees et les decisions architecturales. Suggere des ADRs quand des decisions significatives sont detectees.

ROI Computation (GET /projects/:id/roi) -- Quantifie le retour sur investissement de l'architecture. Separe vos metriques DORA avant/apres, calcule les gains de productivite (heures economisees x cout horaire), les gains de fiabilite (incidents evites x cout par incident), et classe vos ADRs par impact financier.

Les trois sont disponibles en tant qu'outils MCP, afin que chaque skill agent puisse les appeler directement.

La boucle complete

Voici comment tout s'articule :

L'agent recoit une tache
       │
       ▼
  archyl-preflight ──── valide l'approche par rapport a l'architecture
       │
       ▼
  L'agent ecrit le code
       │
       ▼
  archyl-review ──────── revise la PR par rapport au modele C4
       │
       ▼
  CI: conformance-check ─ bloque les violations
  CI: drift-score ──────── impose l'alignement
       │
       ▼
  Merge sur main
       │
       ▼
  CI: auto-cr ──────────── soumet une Change Request
  CI: generate-context ─── met a jour archyl.txt
       │
       ▼
  archyl-postship ──────── met a jour le modele C4 + les ADRs
       │
       ▼
  Le prochain agent lit archyl.txt ← le cycle se repete

L'architecture n'est pas maintenue. Elle se maintient d'elle-meme.

Pour commencer

1. Installez les skills :

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

2. Ajoutez les GitHub Actions : Copiez le workflow ci-dessus dans .github/workflows/architecture.yml.

3. Generez votre premier archyl.txt : Lancez l'action generate-context ou demandez a votre agent : "Genere le fichier de contexte architectural pour ce projet."

4. Commencez a coder. Votre agent connait desormais l'architecture.

Et apres

Ce n'est que le debut. Nous travaillons sur des dashboards frontend pour les predictions et le ROI, une integration plus poussee avec davantage d'agents de codage, et une marketplace communautaire pour les packs de regles de conformite.

La documentation d'architecture a toujours ete ce que les equipes avaient l'intention de faire mais ne faisaient jamais. Quand les agents ecrivent le code, l'architecture devient la seule chose que les humains doivent posseder. Archyl fait en sorte qu'ils n'aient pas a le faire seuls.

Tout ce que nous avons livre aujourd'hui est open source. Vos retours sont les bienvenus.

Architecture Intelligence pour les equipes AI-native - Archyl Blog