Plugin per Agente di Programmazione - Archyl Docs

Installa e utilizza il plugin per agente di programmazione di Archyl per gestire la tua architettura direttamente da Claude Code, Codex o qualsiasi agente di programmazione compatibile

Plugin per Agente di Programmazione

Il Plugin Sviluppatore Archyl ti consente di gestire l'intero modello architetturale C4 model direttamente dal tuo agente di programmazione -- Claude Code, Codex o qualsiasi strumento compatibile. Invece di passare continuamente dal tuo editor alla dashboard di Archyl, puoi creare sistemi, container, componenti, ADR, regole di conformita e molto altro senza uscire dal terminale.

Il plugin e open source ed e disponibile su github.com/archyl-com/agent-skills.

Cosa Puoi Fare

Il plugin fornisce al tuo agente una conoscenza approfondita degli oltre 200 strumenti MCP di Archyl nei seguenti ambiti:

Ambito Funzionalita
Modellazione C4 Crea e gestisci sistemi, container, componenti, elementi di codice e relazioni
Documentazione Architecture Decision Record, documentazione di progetto, flussi utente/sistema, insight generati dall'IA
Governance Regole di conformita, rilevamento della deriva, metriche DORA, mappatura della proprieta
Operazioni Rilasci, ambienti, contratti API, canali di eventi, technology radar
Collaborazione Commenti, richieste di modifica, lavagne, gestione del team
Cronologia Snapshot, viaggio nel tempo, confronto architetturale, log di audit
Integrazioni Webhook, widget del marketplace, viste architetturali globali

Prerequisiti

  • Un account Archyl con accesso API
  • Una chiave API (ottienila da Impostazioni -> Chiavi API nella dashboard di Archyl)
  • Claude Code, Codex o un agente di programmazione compatibile

Installazione

Passo 1: Aggiungi il Marketplace

Esegui il seguente comando in Claude Code:

/plugin marketplace add archyl-com/agent-skills

Poi apri il gestore dei plugin per configurare gli aggiornamenti automatici:

  1. Esegui /plugin
  2. Seleziona Marketplace
  3. Scegli archyl-marketplace dalla lista
  4. Seleziona Enable auto-update o Disable auto-update

Passo 2: Installa il Plugin

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

Riavvia Claude Code dopo l'installazione.

Passo 3: Configura il Server MCP

Aggiungi il server MCP di Archyl al file .mcp.json del tuo progetto:

{
    "mcpServers": {
        "archyl": {
            "type": "http",
            "url": "https://api.archyl.com/mcp",
            "headers": {
                "X-API-Key": "arch_your_api_key_here"
            }
        }
    }
}

Sostituisci arch_your_api_key_here con la tua chiave API effettiva dalla dashboard di Archyl.

Altri Agenti di Programmazione

Il contenuto del plugin e compatibile con qualsiasi agente che supporti il formato plugin. Puoi anche utilizzare direttamente i file delle competenze dalla directory del plugin archyl-developer nel repository.

Flussi di Lavoro Comuni

Una volta installato, puoi chiedere al tuo agente di programmazione di eseguire attivita architetturali in linguaggio naturale. Ecco alcuni flussi di lavoro comuni:

Documentare un Nuovo Progetto

Chiedi al tuo agente di costruire lo scheletro del tuo modello architetturale:

Create a new Archyl project for our e-commerce platform.
Add the main systems: WebApp, PaymentService, and PostgreSQL Database.
Then create containers for the API server and React frontend inside WebApp.

L'agente invochera gli strumenti MCP appropriati (create_project, create_system, create_container) e colleghera il tutto.

Analizzare l'Architettura Esistente

Get the full C4 model for my project and summarize the architecture.
Check the drift score — is the documentation still accurate?
Show me any open architecture insights.

Applicare Regole Architetturali

Create a conformance rule that prevents any container from having
more than 10 direct dependencies. Then run a conformance check.

Registrare Decisioni Architetturali

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.

Verificare le Prestazioni di Deployment

Show me the DORA metrics for the last month.
What's our deployment frequency and lead time trend?

Gestire il Technology Radar

Show me the current technology radar.
Add "Temporal" as an adopted workflow orchestration technology
and tag it on the OrderProcessing container.

Come Funziona

Il plugin fornisce al tuo agente di programmazione una conoscenza strutturata di ogni strumento MCP di Archyl, inclusi parametri, valori attesi e best practice. Quando chiedi al tuo agente di eseguire un'attivita architetturale, esso:

  1. Identifica quali strumenti MCP invocare
  2. Costruisce i parametri corretti (ID progetto, tipi di elemento, tipi di relazione)
  3. Concatena piu chiamate per flussi di lavoro complessi
  4. Restituisce un riepilogo di cio che e stato creato o modificato

L'agente inizia sempre invocando list_projects per scoprire i progetti disponibili e ottenere il projectId necessario per le operazioni successive.

Riferimento al C4 Model

Il plugin comprende tutti e 4 i livelli del C4 model:

Livello Elemento Esempio
1 System "Payment Platform", "Email Service"
2 Container "API Server", "PostgreSQL Database", "React Frontend"
3 Component "AuthService", "PaymentProcessor", "UserRepository"
4 Code "PaymentGateway interface", "processPayment()"

Convenzioni di Denominazione

L'agente segue queste regole di denominazione quando crea gli elementi:

  • Systems: PascalCase, descrittivo (PaymentPlatform, NotificationService)
  • Containers: PascalCase con indicazione del tipo (ApiServer, PostgresDatabase, RedisCache)
  • Components: PascalCase, orientato al modulo (AuthService, PaymentProcessor)
  • Code Elements: Nomi esatti dei simboli dal codice sorgente

Tipi di Relazione

Quando collega gli elementi, l'agente utilizza il tipo di relazione appropriato:

Tipo Caso d'Uso
uses Dipendenza generica tra sistemi
calls Chiamate sincrone HTTP/gRPC
sends_to / consumes_from Messaggistica asincrona (code, eventi)
reads_from / writes_to Accesso al database
implements / extends Ereditarieta a livello di codice

Contribuire

Il plugin e open source. Puoi contribuire:

  • Correggendo nomi di strumenti, parametri o descrizioni
  • Aggiungendo copertura per nuove funzionalita di Archyl
  • Migliorando gli esempi di flussi di lavoro
  • Aggiungendo file di riferimento per domini mancanti

Consulta la guida per contribuire per i dettagli.