Como funciona

Uma thread do Slack: o diagrama, o código-fonte e o porquê.

O Arialine é um app do Slack. Você descreve um sistema e ele desenha. Converse com @arialine na thread para atualizá-lo. Cada alteração vira uma versão numerada com link para a mensagem exata que a causou. Esta página mostra o fluxo completo.

Teste sem instalar nada

Primeiro, percorra o fluxo completo.

Crie um quadro, aplique uma proposta, desfaça-a e abra o arquivo HTML real; depois, leia abaixo como cada parte funciona.

# 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.

↓Clique em enviar para mencionar o Arialine

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

Criar

Sete formas de criar um quadro

As sete geram o mesmo resultado: uma mensagem raiz no canal com prévia em PNG, um arquivo .html interativo e os controles History, Branch e Export. Show source fica em Export. As versões seguintes aparecem na thread; o registro de decisões é publicado separadamente, em segundo plano. No Slack Free ele fica na thread do quadro, sem ocupar a aba Canvas do canal.

  • @menção + descrição

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

    +
    Fale com Aria, Arialine ou @arialine: create a checkout funnel with a retry queue and DLQ after 3 tries
  • Menção depois de uma conversa

    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 a discussão relevante das últimas 72 horas e pergunta qual tema você quer quando dois são igualmente plausíveis
  • Colar Mermaid

    Priya Nair9:14 AM

    @Arialine render this
    flowchart LR
      A[Checkout] --> B{Paid?}
      B -->|yes| C[Ship]
    @arialine seguido de Mermaid colado: o Arialine valida e renderiza
  • Anexar um arquivo .mmd

    Sam Moreau2:03 PM

    @Arialine make this a boardMMDpayments.mmdMermaid
    @arialine com um anexo .mmd/.mermaid
  • Só compartilhar um arquivo .mmd

    Sam Moreau2:03 PM

    MMDpayments.mmdMermaid

    ArialineAPP2:03 PM

    🟢 payments · v1 · built from payments.mmd
    Envie o arquivo para um canal: o Arialine cria o quadro automaticamente (dá para desativar)
  • Atalho “Render as diagram”

    Priya Nair9:20 AM

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

    Arialine

    Render as diagram

    Render as canvas

    Passe o mouse ou toque e segure uma mensagem → More actions → Render as diagram
  • /arialine ou ‘New diagram’
    New diagram

    Post in channel

    # architecture

    Paste Mermaid or describe the diagram

    flowchart LR
      API --> Queue --> Worker
    CancelCreate
    Digite /arialine (ou menu ⚡ → New diagram) e cole Mermaid ou descreva o diagrama — Mermaid válido é renderizado sem IA
02

Anatomia

Dois arquivos em uma mensagem âncora

O Arialine publica dois arquivos juntos: um .html interativo e um .png. O .png é a prévia que você vê no Slack em qualquer dispositivo. Abra o .html no navegador para mover, dar zoom e usar os painéis Decisions, Source e History.

A mensagem raiz é a âncora: a cada alteração, seus arquivos são trocados pela renderização mais recente, então o topo da thread sempre mostra o diagrama atual. As respostas de versão abaixo guardam cada .png + .html anterior: nada se perde.

03

Editar

Converse com @arialine na thread

Fale com Aria, Arialine ou @arialine e diga “adicione uma camada de cache entre o gateway e o banco de dados” ou “remova a etapa de SMS”. O Arialine reescreve o Mermaid, renderiza, substitui os arquivos da mensagem raiz e publica uma resposta de versão de uma linha: v2 — added Redis caching layer — by @you, com os botões ↩︎ Undo this change e ⏪ Rewind to here.

Você também pode reagir com 📌 a qualquer mensagem para propô-la como alteração. O Arialine lê essa mensagem no contexto da conversa e publica um cartão com Apply, Edit proposal e Dismiss.

04

Versões

Desfaça uma alteração ou volte o quadro inteiro

O histórico é cumulativo. Desfazer uma alteração ou voltar a uma versão anterior também gera uma nova versão registrada. Nada é sobrescrito, então auditorias e retrospectivas sempre batem com a realidade.

Pergunte na thread “por que existe uma fila dead-letter?” e o Arialine responde a partir do registro de decisões, citando a mensagem, dizendo quem escreveu e com link para a publicação original no Slack.

05

Branches e brainstorming

Explore alternativas sem mexer no original

Clique em Branch na mensagem raiz (ou diga @arialine branch this at v3 called experiment) para derivar qualquer versão em um quadro novo. O branch tem thread e registro de decisões próprios e aponta para a versão de origem.

Mencione @arialine brainstorm … ou peça ideias ao Arialine explicitamente. Ele cria 2–3 alternativas para o diagrama atual, cada uma como prévia com dois botões: Adopt to this board (substitui o diagrama atual como nova versão) ou Branch to new board (mantém o original intacto).

06

Registro

Um Canvas do Slack que explica por que o diagrama é assim

Quando o Slack permite, cada quadro ganha um Canvas de registro com duas seções. Timeline lista todas as versões, da mais recente para a mais antiga, com o diagrama de cada uma. Decisions é o registro: o que mudou, quem decidiu e o link para cada mensagem de origem. No Slack Free, o mesmo registro fica como mensagem na thread do quadro.

O registro é o arquivo histórico; o HTML é o diagrama que você explora. Juntos, respondem a “como está hoje?” e “como chegamos aqui?”, inclusive para quem entrar no time daqui a seis meses.

07

Markdown para Canvas

Compartilhe um .md e receba um Canvas nativo do Slack com o Mermaid renderizado

O Slack não renderiza Markdown nas mensagens, e arquivos .md enviados aparecem como texto simples. O Arialine converte o .md compartilhado em um Canvas do Slack de verdade, com títulos, listas e tabelas, e cada bloco de código mermaid vira uma imagem de diagrama incorporada. Um documento totalmente legível no Slack.

08

Incorpore em qualquer lugar

Coloque um diagrama em qualquer Canvas que o time já lê

Peça ao Arialine para adicionar a versão atual de um quadro a qualquer Canvas do Slack ao qual ele tenha acesso: documento de projeto, Canvas de canal ou de reunião. O Arialine renderiza a versão mais recente, envia e incorpora no fim do Canvas.

09

Slack AI (MCP)

Comande o Arialine pelo assistente nativo do Slack

O Arialine oferece um servidor Model Context Protocol, então o Slackbot pode criar, editar, derivar e consultar seus quadros por você. Peça “transforme esta conversa em um diagrama com o Arialine”: o Slackbot aciona a ferramenta certa, o Arialine publica o quadro e o registro anota quem pediu.

Quer o guia completo?

A documentação cobre cada atalho, cada comando de barra e cada configuração de administração.

Leve o Arialine para a sua próxima discussão de design.

Instale com um clique. Comece em um único canal: o Arialine só participa onde você o convida e, por padrão, evita gerar ruído.