Ecosistema e strumenti

Panoramica

L’ecosistema Goa comprende librerie e strumenti complementari che rispondono a esigenze comuni nello sviluppo di servizi e sistemi ad agenti. Questi progetti sono pensati per funzionare perfettamente con Goa e Goa-AI, ma possono essere utilizzati anche in modo indipendente.

Librerie e strumenti complementari

Modello - Diagrammi di architettura come codice

Model fornisce un DSL Go per descrivere l’architettura del software utilizzando il modello C4. Invece di disegnare diagrammi con strumenti grafici, si definisce l’architettura nel codice:

var _ = Design("My System", "System description", func() {
    var System = SoftwareSystem("My System", "Does something useful")
    
    Person("User", "A user of the system", func() {
        Uses(System, "Uses")
    })
    
    Views(func() {
        SystemContextView(System, "Context", "System context diagram", func() {
            AddAll()
            AutoLayout(RankLeftRight)
        })
    })
})

Benefici:

• Documentazione dell’architettura a controllo di versione
• Generazione automatica di diagrammi (SVG, JSON)
• Editor grafico interattivo per il posizionamento
• Plugin Goa per progetti combinati di API e architettura

Per saperne di più: Documentazione del modello

Pulse - Infrastruttura di eventi distribuiti

Pulse fornisce primitive per la costruzione di sistemi distribuiti guidati dagli eventi. È indipendente dal trasporto e funziona con o senza servizi Goa:

• Streaming: Instradamento di eventi pub/sub tra microservizi
• Pools di lavoratori: Lavoratori dedicati con hashing coerente per l’invio di lavori
• Mappe replicate: Stato condiviso e coerente tra i nodi

// Publish events to a stream
stream.Add(ctx, "user.created", userEvent)

// Subscribe to events
reader.Subscribe(ctx, func(event *Event) error {
    return processEvent(event)
})

**Casi d’uso

• Elaborazione asincrona di eventi
• Code di lavoro in background
• Caching distribuito
• Notifiche in tempo reale

Per saperne di più: Documentazione Pulse

Indizio - Osservabilità dei microservizi

Clue fornisce strumentazione per i servizi Goa costruiti su OpenTelemetry. Copre i tre pilastri dell’osservabilità:

// Configure OpenTelemetry
cfg := clue.NewConfig(ctx, "myservice", "1.0.0", metricExporter, spanExporter)
clue.ConfigureOpenTelemetry(ctx, cfg)

// Context-based logging
log.Info(ctx, "processing request", log.KV{"user_id", userID})

// Health checks
checker := health.NewChecker(health.NewPinger("db", dbAddr))

Caratteristiche:

• Tracciamento distribuito con propagazione automatica dell’intervallo di tempo
• Registrazione strutturata con buffering intelligente
• Raccolta ed esportazione di metriche
• Endpoint di controllo dello stato di salute
• Endpoint di debug per la risoluzione dei problemi in fase di esecuzione

Per saperne di più: Documentazione Clue

Chorus - Coordinamento multi-agente via MCP

Chorus è un server MCP costruito con Goa-AI e Pulse che permette a più coding agent di coordinarsi tra terminali e famiglie di modelli tramite #channels e messaggi diretti @agent:

# Installa Chorus, registra http://localhost:9440/mcp e avvia il servizio in background
curl -fsSL https://raw.githubusercontent.com/goadesign/chorus/main/scripts/install.sh | sh

# Oppure installa la skill dell'agente tramite la Skills CLI
npx skills add goadesign/chorus --skill chorus

Caratteristiche:

• Cinque tool MCP (who, join, leave, send, read) su un singolo endpoint POST /mcp
• Watermark di lettura per agente in pulse/rmap e log di messaggi limitati in pulse/streaming
• Consegna aggregata dei messaggi non letti su send e risposte compatte in testo semplice
• Listener di sistema in background (chorus watch) che attende fino all’arrivo di un DM, una menzione o una risposta

Per saperne di più: Documentazione Chorus

Guide alla documentazione

Sezione totale: ~8.600 gettoni

Iniziare

Scegliere la libreria o lo strumento che corrisponde alle proprie esigenze:

• Necessitate di documentazione sull’architettura? Iniziate con Model
• Costruire sistemi guidati dagli eventi? Iniziate con Pulse
• Aggiungere l’osservabilità ai servizi Goa? Iniziate con Clue
• Coordinare più coding agent? Iniziate con Chorus

Tutte le librerie e gli strumenti sono disponibili tramite go get / go install:

go get goa.design/model
go get goa.design/pulse
go get goa.design/clue
go install github.com/goadesign/chorus/cmd/chorus@latest