Come funziona

Un thread di Slack: il diagramma, il codice sorgente e le motivazioni.

Arialine è un'app per Slack. Tu descrivi un sistema, lei lo disegna. Parla con @arialine nel thread per aggiornarlo. Ogni modifica è una versione numerata con un link al messaggio esatto che l'ha generata. Questa pagina mostra l'intero flusso.

Provalo senza installare nulla

Prima prova tu stesso l'intero flusso.

Crea un board, applica una proposta, annullala e apri il vero file HTML, poi leggi qui sotto come funziona ogni parte.

# architecture

Priya Nair10:38 AM
Before tomorrow's review — can someone sketch how checkout hands off to fulfillment? I keep losing track of where the order gets written.
Dana Okafor10:40 AM
+1, a diagram in this thread would save us 20 minutes of explaining.

↓Premi invio per menzionare Arialine

@Arialine draw checkout-review: Checkout API → Payment processor → Fulfillment worker → Orders database
01

Crea

Sette modi per creare un board

Tutti e sette producono lo stesso risultato: un messaggio principale nel canale con un'anteprima PNG, un file .html interattivo e i controlli History, Branch ed Export. Show source si apre da Export. Le versioni successive compaiono nel thread; il registro delle decisioni viene pubblicato a parte, in background. Su Slack Free resta nel thread del board senza occupare la scheda Canvas del canale.

  • @menzione + descrizione

    @Arialine create a checkout funnel with a retry queue and a DLQ after 3 tries

    +
    Rivolgiti ad Aria, Arialine o @arialine: create a checkout funnel with a retry queue and DLQ after 3 tries
  • Menzione dopo una discussione

    Dana Okafor10:52 AM

    @Arialine turn this into a diagram
    14 repliesLast reply today at 10:51 AM
    @arialine turn this into a diagram: usa la discussione pertinente delle ultime 72 ore e chiede quale argomento intendi quando due sono ugualmente plausibili
  • Incolla Mermaid

    Priya Nair9:14 AM

    @Arialine render this
    flowchart LR
      A[Checkout] --> B{Paid?}
      B -->|yes| C[Ship]
    @arialine seguito da Mermaid incollato: Arialine lo convalida e lo renderizza
  • Allega un file .mmd

    Sam Moreau2:03 PM

    @Arialine make this a boardMMDpayments.mmdMermaid
    @arialine con un allegato .mmd/.mermaid
  • Condividi semplicemente un file .mmd

    Sam Moreau2:03 PM

    MMDpayments.mmdMermaid

    ArialineAPP2:03 PM

    🟢 payments · v1 · built from payments.mmd
    Carica il file in un canale: Arialine crea il board automaticamente (disattivabile)
  • Scorciatoia «Render as diagram»

    Priya Nair9:20 AM

    Order service writes to Postgres, then publishes OrderCreated to Kafka.

    Arialine

    Render as diagram

    Render as canvas

    Passa sopra un messaggio o tienilo premuto → More actions → Render as diagram
  • /arialine o ‘New diagram’
    New diagram

    Post in channel

    # architecture

    Paste Mermaid or describe the diagram

    flowchart LR
      API --> Queue --> Worker
    CancelCreate
    Digita /arialine (o menu ⚡ → New diagram), poi incolla Mermaid o descrivi il diagramma: il Mermaid valido viene renderizzato senza IA
02

Anatomia

Due file su un messaggio àncora

Arialine pubblica due file insieme: un .html interattivo e un .png. Il .png è l'anteprima che vedi in Slack su ogni dispositivo. Apri il .html nel browser per spostarti, zoomare e usare i pannelli Decisions, Source e History.

Il messaggio principale è l'àncora: a ogni modifica i suoi file vengono sostituiti con l'ultimo render, quindi in cima al thread c'è sempre il diagramma attuale. Le risposte di versione sottostanti conservano ogni .png + .html precedente: non si perde nulla.

03

Modifica

Parla con @arialine nel thread

Rivolgiti a Aria, Arialine o @arialine e scrivi «aggiungi un livello di cache tra il gateway e il database» oppure «togli il passaggio dell'SMS». Arialine riscrive il Mermaid, lo renderizza, sostituisce i file del messaggio principale e pubblica una risposta di versione di una riga: v2 — added Redis caching layer — by @you, con i pulsanti ↩︎ Undo this change e ⏪ Rewind to here.

Puoi anche reagire con 📌 a qualsiasi messaggio per proporlo come modifica. Arialine legge quel messaggio nel contesto della conversazione e pubblica una scheda con Apply, Edit proposal e Dismiss.

04

Versioni

Annulla una modifica o riporta indietro l'intero board

La cronologia è incrementale. Annullare una singola modifica o tornare a una versione precedente crea a sua volta una nuova versione tracciata. Nulla viene mai sovrascritto, quindi audit e retrospettive corrispondono sempre alla realtà.

Chiedi nel thread «perché c'è una coda dead-letter?» e Arialine risponde dal registro delle decisioni, citando il messaggio, indicando chi l'ha scritto e collegandosi al post originale di Slack.

05

Branch e brainstorming

Esplora alternative senza toccare l'originale

Fai clic su Branch nel messaggio principale (o scrivi @arialine branch this at v3 called experiment) per derivare qualsiasi versione in un board nuovo. Il branch ha il proprio thread e il proprio registro delle decisioni, con un link alla versione di origine.

Menziona @arialine brainstorm … o chiedi esplicitamente ad Arialine delle idee. Produce 2–3 varianti del diagramma attuale, ognuna come anteprima con due pulsanti: Adopt to this board (sostituisce il diagramma attuale con una nuova versione) oppure Branch to new board (lascia intatto l'originale).

06

Registro

Un Canvas di Slack che spiega perché il diagramma è fatto così

Dove Slack lo consente, ogni board ha un Canvas di registro con due sezioni. Timeline elenca tutte le versioni dalla più recente, ognuna con il suo diagramma. Decisions è il registro: cosa è cambiato, chi ha deciso e un link a ogni messaggio di origine. Su Slack Free lo stesso registro è tenuto come messaggio nel thread del board.

Il registro è l'archivio; il file HTML è il diagramma da esplorare. Insieme rispondono sia a «com'è oggi?» sia a «come ci siamo arrivati?», anche per chi entrerà nel team tra sei mesi.

07

Da Markdown a Canvas

Condividi un file .md e ottieni un Canvas nativo di Slack con il Mermaid renderizzato

Slack non renderizza il Markdown nei messaggi e i file .md caricati appaiono come testo semplice. Arialine converte il .md condiviso in un vero Canvas di Slack, con titoli, elenchi e tabelle, e ogni blocco di codice mermaid diventa un'immagine del diagramma incorporata. Un documento, perfettamente leggibile in Slack.

08

Inseriscilo ovunque

Inserisci un diagramma in qualsiasi Canvas che il team legge già

Chiedi ad Arialine di aggiungere la versione attuale di un board a qualsiasi Canvas di Slack a cui ha accesso: un documento di progetto, il Canvas di un canale o di una riunione. Arialine renderizza l'ultima versione, la carica e la incorpora alla fine del Canvas.

09

Slack AI (MCP)

Guida Arialine dall'assistente integrato di Slack

Arialine espone un server Model Context Protocol, così Slackbot può creare, modificare, derivare e consultare i tuoi board al posto tuo. Chiedi «trasforma questa discussione in un diagramma con Arialine»: Slackbot richiama lo strumento giusto, Arialine pubblica il board e il registro annota chi l'ha chiesto.

Vuoi la guida completa?

La documentazione copre ogni scorciatoia, ogni comando slash e ogni impostazione di amministrazione.

Porta Arialine nella tua prossima discussione di progettazione.

Installalo con un clic. Inizia da un solo canale: Arialine interviene solo dove lo inviti e, per impostazione predefinita, resta discreto.