Gli agenti AI ora scrivono la maggior parte del codice. Ma chi si assicura che rispettino l'architettura? Oggi lanciamo 10 skill per agenti, 6 GitHub Actions, pack di regole di conformità, SDK e tre nuove API potenziate dall'AI — tutto ciò di cui i tuoi agenti hanno bisogno per comprendere, validare e far evolvere la tua architettura automaticamente.

Architecture Intelligence per i Team AI-Native

Qualcosa è cambiato negli ultimi sei mesi. Gli agenti AI sono passati dallo scrivere funzioni allo scrivere interi servizi. Claude Code, Cursor, Codex — non sono più assistenti. Sono membri del team. Aprono PR, fanno review del codice, rilasciano feature.

Ma ecco cosa mi tiene sveglio la notte: questi agenti non hanno idea di come sia l'architettura.

Un agente può scrivere un servizio Go perfettamente pulito in dieci minuti. Ma non sa che il team ha deciso tre mesi fa di instradare tutte le comunicazioni inter-servizio attraverso Kafka. Non sa che il payment service è off-limits per l'accesso diretto al database. Non sa che Python è stato spostato in "hold" sul technology radar lo scorso trimestre.

Il risultato? Drift architetturale alla velocità delle macchine.

Abbiamo costruito Archyl per risolvere questo problema. E oggi rilasciamo il più grande aggiornamento dal lancio: Architecture Intelligence — un ecosistema completo che rende Archyl il sistema nervoso dello sviluppo AI-native.

Il Problema: Gli Agenti Scrivono Codice Velocemente, Ma alla Cieca

Quando uno sviluppatore umano entra in un team, passa giorni a leggere documentazione, fare domande, costruire un modello mentale del sistema. Impara le regole — scritte e non scritte. Comprende i confini.

Gli agenti AI saltano tutto questo. Ricevono un task, scrivono codice, aprono una PR. Se nessuno intercetta la violazione architetturale durante la review, finisce in produzione. Moltiplicate questo per dieci agenti che lavorano su dieci servizi in tre team, e la vostra architettura accuratamente progettata si erode in settimane.

L'abbiamo visto succedere. Un team con un modello C4 impeccabile a gennaio aveva un drift score del 40% a marzo. Non perché avevano smesso di curarsene — perché i loro agenti non sapevano che l'architettura esistesse.

La Soluzione: L'Architettura come Infrastruttura

La documentazione dell'architettura non dovrebbe essere qualcosa che si mantiene. Dovrebbe essere qualcosa che si mantiene da sola — e che ogni agente consulta prima di scrivere una singola riga di codice.

È quello che abbiamo costruito. Ecco cosa rilasciamo oggi.

10 Skill per Agenti

La skill originale archyl-developer dava agli agenti accesso a oltre 200 tool MCP. Ma era una cassetta degli attrezzi senza un workflow. Oggi aggiungiamo nove skill specializzate che coprono l'intero ciclo di vita dello sviluppo:

Prima di scrivere codice

archyl-preflight — Eseguilo prima di implementare qualsiasi feature. Verifica il tuo approccio pianificato rispetto al modello C4, alle regole di conformità, al technology radar e ai contratti API. Ottieni un verdetto chiaro PASS / WARN / FAIL prima di scrivere una singola riga di codice.

> Sto per aggiungere una cache Redis al user service. Va bene?

Controllo Preflight: WARNING
- Redis è approvato sul technology radar ✓
- Lo user service esiste nel modello C4 ✓
- ⚠ Nessun container cache documentato — si consiglia di crearne uno
- ⚠ La regola "No Direct DB Access from Handlers" si applica — assicurati che la cache sia accessibile attraverso il service layer

Dopo il rilascio

archyl-postship — Eseguilo dopo il rilascio. Analizza ciò che hai appena costruito, aggiorna il modello C4, crea ADR per le decisioni architetturali e crea Change Request per la review dell'architetto. La tua documentazione si aggiorna da sola come effetto collaterale del lavoro.

Durante la review

archyl-review — Un bot per la review architetturale. Controlla il diff della tua PR rispetto all'architettura documentata e fornisce feedback strutturato: violazioni di conformità, attraversamenti di confini, tecnologie non approvate, contratti API mancanti. Come ESLint, ma per l'architettura.

Per la visibilità

archyl-changelog — Genera una timeline leggibile di tutti i cambiamenti architetturali: nuovi servizi, relazioni modificate, decisioni ADR, evoluzione del drift. Perfetto per le riunioni di review dell'architettura.

archyl-dora — Correla le metriche DORA con i cambiamenti architetturali. La tua decomposizione in microservizi ha migliorato il lead time? Il picco di drift ha preceduto l'aumento del change failure rate? Ora hai i dati.

archyl-roi — Quantifica l'impatto finanziario delle decisioni architetturali. "Il nostro investimento nelle regole di conformità ha fatto risparmiare circa $23.000 lo scorso trimestre riducendo il rework." Questo è il tipo di dati che fa approvare i budget per l'architettura.

Per la prevenzione

archyl-predict — Prevede i rischi architetturali prima che si materializzino. "Al ritmo attuale, il tuo drift score supererà il 50% entro maggio. Il PaymentService ha 12 dipendenze in entrata — considera una decomposizione."

archyl-autofix — Quando viene rilevato del drift, propone fix specifici. Aggiorna la documentazione per allinearla al codice, oppure suggerisce modifiche al codice per riallinearsi all'architettura. Crea Change Request per la review umana.

Per il coordinamento

archyl-orchestrate — Quando più agenti lavorano su servizi diversi contemporaneamente, questa skill negozia i contratti API, risolve i conflitti di dipendenze e assicura che i cambiamenti cross-team non rompano l'architettura.

6 GitHub Actions

La governance architetturale appartiene alla CI. Rilasciamo sei GitHub Actions che vengono eseguite automaticamente su ogni PR e merge:

Action	Trigger	Cosa fa
conformance-check	PR	Esegue le regole di conformità sui file modificati, annota le violazioni inline
drift-score	PR	Calcola il drift score, lo pubblica come commento PR, fallisce sotto la soglia
generate-context	Push su main	Genera `archyl.txt` — un briefing architetturale ottimizzato in token per gli agenti
auto-cr	Push su main	Crea automaticamente Architecture Change Request dai diff dei merge
release	Deploy	Traccia i rilasci in Archyl con environment e versione
sync	Push su main	Sincronizza il DSL `archyl.yaml` per mantenere l'architettura come codice

La configurazione consigliata è un unico file:

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 }}

Non sei su GitHub? Forniamo anche template per GitLab CI e Bitbucket Pipelines.

Pack di Regole di Conformità

Configurare la governance architetturale da zero è noioso. Quindi abbiamo costruito cinque pack di regole preconfigurate che puoi installare in pochi secondi:

Pack	Regole	Cosa impone
Microservices	10	Niente DB condivisi, deployabilità indipendente, comunicazione delimitata
Clean Architecture	9	Confini tra layer, isolamento del dominio, pattern port/adapter
Event-Driven	8	Conformità dei canali, requisiti di schema, dead letter queue
API-First	8	Requisiti di contratto, versionamento, documentazione dell'autenticazione
Security Baseline	8	Imposizione del gateway, gestione dei secret, controlli di accesso

Installa tramite la skill dell'agente: "Installa il pack di regole di conformità microservices." Fatto.

SDK

Per i team che costruiscono integrazioni personalizzate, pubblichiamo SDK ufficiali:

npm install @archyl/sdk    # Node.js 18+, zero dipendenze
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);

Tre Nuove API Potenziate dall'AI

Sotto il cofano, rilasciamo tre nuove funzionalità backend:

Predictive Analytics (GET /projects/:id/predict) — Analisi statistica reale. Regressione lineare sui drift score, traiettorie delle metriche DORA, tassi di decadimento della conformità e rilevamento degli hotspot di complessità tramite analisi di accoppiamento fan-in/fan-out. Non sensazioni — matematica.

Architecture Diff Analysis (POST /projects/:id/architecture-diff) — Invia un diff git, ottieni un delta strutturato del modello C4. Analisi potenziata dall'AI che rileva nuovi servizi, dipendenze modificate e decisioni architetturali. Suggerisce ADR quando vengono rilevate decisioni significative.

ROI Computation (GET /projects/:id/roi) — Quantifica i ritorni sugli investimenti architetturali. Divide le metriche DORA prima/dopo, calcola i guadagni di produttività (ore risparmiate × costo orario), i guadagni di affidabilità (incidenti evitati × costo per incidente), e classifica i tuoi ADR per impatto finanziario.

Tutte e tre sono disponibili come tool MCP, quindi ogni skill dell'agente può chiamarle direttamente.

Il Ciclo Completo

Ecco come si incastra tutto:

L'agente riceve il task
       │
       ▼
  archyl-preflight ──── valida l'approccio rispetto all'architettura
       │
       ▼
  L'agente scrive codice
       │
       ▼
  archyl-review ──────── review della PR rispetto al modello C4
       │
       ▼
  CI: conformance-check ─ blocca le violazioni
  CI: drift-score ──────── impone l'allineamento
       │
       ▼
  Merge su main
       │
       ▼
  CI: auto-cr ──────────── crea una Change Request
  CI: generate-context ─── aggiorna archyl.txt
       │
       ▼
  archyl-postship ──────── aggiorna modello C4 + ADR
       │
       ▼
  Il prossimo agente legge archyl.txt ← il ciclo si ripete

L'architettura non viene mantenuta. Si mantiene da sola.

Per Iniziare

1. Installa le skill:

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

2. Aggiungi le GitHub Actions: Copia il workflow qui sopra in .github/workflows/architecture.yml.

3. Genera il tuo primo archyl.txt: Esegui la generate-context action oppure chiedi al tuo agente: "Genera il file di contesto architetturale per questo progetto."

4. Inizia a scrivere codice. Il tuo agente ora conosce l'architettura.

Cosa Ci Riserva il Futuro

Questa è la base. Stiamo lavorando su dashboard frontend per le previsioni e il ROI, integrazioni più profonde con più agenti di coding, e un marketplace della community per i pack di regole di conformità.

La documentazione dell'architettura è sempre stata la cosa che i team volevano fare ma che non riuscivano mai a portare a termine. Quando gli agenti scrivono il codice, l'architettura diventa l'unica cosa che gli umani devono possedere. Archyl si assicura che non debbano farlo da soli.

Tutto ciò che abbiamo rilasciato oggi è open source. Ci farebbe piacere ricevere il vostro feedback.

Architecture Intelligence per i Team AI-Native - Archyl Blog