Cómo funciona

Un hilo de Slack: el diagrama, el código fuente y el porqué.

Arialine es una app de Slack. Tú describes un sistema y ella lo dibuja. Habla con @arialine en el hilo para actualizarlo. Cada cambio es una versión numerada con un enlace al mensaje exacto que lo originó. Esta página recorre el flujo completo.

Pruébalo sin instalar nada

Primero, recorre tú mismo el flujo completo.

Crea un tablero, aplica una propuesta, deshazla y abre el archivo HTML real; después, lee abajo cómo funciona cada 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.

↓Pulsa enviar para mencionar a Arialine

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

Crear

Siete formas de crear un tablero

Las siete producen lo mismo: un mensaje raíz en el canal con una vista previa PNG, un archivo .html interactivo y los controles History, Branch y Export. Show source se abre desde Export. Las versiones posteriores aparecen en el hilo; el registro de decisiones se publica aparte, en segundo plano. En Slack Free se queda en el hilo del tablero sin ocupar la pestaña Canvas del canal.

  • @mención + descripción

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

    +
    Dirígete a Aria, Arialine o @arialine: create a checkout funnel with a retry queue and DLQ after 3 tries
  • Mención tras una conversación

    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 conversación relevante de las últimas 72 horas y pregunta qué tema quieres cuando dos son igual de plausibles
  • Pegar Mermaid

    Priya Nair9:14 AM

    @Arialine render this
    flowchart LR
      A[Checkout] --> B{Paid?}
      B -->|yes| C[Ship]
    @arialine seguido de Mermaid pegado: Arialine lo valida y lo renderiza
  • Adjuntar un archivo .mmd

    Sam Moreau2:03 PM

    @Arialine make this a boardMMDpayments.mmdMermaid
    @arialine con un adjunto .mmd/.mermaid
  • Compartir un archivo .mmd

    Sam Moreau2:03 PM

    MMDpayments.mmdMermaid

    ArialineAPP2:03 PM

    🟢 payments · v1 · built from payments.mmd
    Sube el archivo a un canal: Arialine crea el tablero automáticamente (se puede desactivar)
  • Atajo «Render as diagram»

    Priya Nair9:20 AM

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

    Arialine

    Render as diagram

    Render as canvas

    Pasa el cursor o mantén pulsado un mensaje → 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
    Escribe /arialine (o menú ⚡ → New diagram) y pega Mermaid o describe el diagrama: el Mermaid válido se renderiza sin IA
02

Anatomía

Dos archivos en un mensaje ancla

Arialine publica dos archivos juntos: un .html interactivo y un .png. El .png es la vista previa que ves en Slack en cualquier dispositivo. Abre el .html en un navegador para desplazarte, hacer zoom y usar los paneles Decisions, Source y History.

El mensaje raíz es el ancla: con cada cambio sus archivos se sustituyen por la versión más reciente, así que al principio del hilo siempre está el diagrama actual. Las respuestas de versión que hay debajo guardan cada .png + .html anterior: nada se pierde.

03

Editar

Habla con @arialine en el hilo

Dirígete a Aria, Arialine o @arialine y di «añade una capa de caché entre el gateway y la base de datos» o «quita el paso del SMS». Arialine reescribe el Mermaid, lo renderiza, sustituye los archivos del mensaje raíz y publica una respuesta de versión de una línea: v2 — added Redis caching layer — by @you, con los botones ↩︎ Undo this change y ⏪ Rewind to here.

También puedes reaccionar con 📌 a cualquier mensaje para proponerlo como cambio. Arialine lee ese mensaje en el contexto de la conversación y publica una tarjeta con Apply, Edit proposal y Dismiss.

04

Versiones

Deshaz un cambio o rebobina todo el tablero

El historial es acumulativo. Deshacer un cambio o volver a una versión anterior es, a su vez, una versión nueva registrada. Nunca se sobrescribe nada, así que las auditorías y retrospectivas siempre coinciden con la realidad.

Pregunta en el hilo «¿por qué hay una cola dead-letter?» y Arialine responde a partir del registro de decisiones: cita el mensaje, indica quién lo dijo y enlaza a la publicación original de Slack.

05

Ramas y lluvia de ideas

Explora alternativas sin tocar el original

Pulsa Branch en el mensaje raíz (o di @arialine branch this at v3 called experiment) para derivar cualquier versión a un tablero nuevo. La rama tiene su propio hilo y registro de decisiones, y enlaza con la versión de origen.

Menciona @arialine brainstorm … o pide ideas a Arialine de forma explícita. Genera 2–3 alternativas del diagrama actual, cada una como vista previa con dos botones: Adopt to this board (sustituye el diagrama actual como nueva versión) o Branch to new board (deja el original intacto).

06

Registro

Un Canvas de Slack que explica por qué el diagrama es como es

Cuando Slack lo permite, cada tablero tiene un Canvas de registro con dos secciones. Timeline muestra todas las versiones, de la más reciente a la más antigua, con su diagrama. Decisions es el registro: qué cambió, quién lo decidió y un enlace a cada mensaje de origen. En Slack Free, el mismo registro se mantiene como un mensaje en el hilo del tablero.

El registro es el archivo histórico; el HTML es el diagrama que exploras. Juntos responden a «¿cómo es hoy?» y a «¿cómo llegamos hasta aquí?», también para quien se una al equipo dentro de seis meses.

07

Markdown a Canvas

Comparte un .md y obtén un Canvas nativo de Slack con Mermaid renderizado

Slack no renderiza Markdown en los mensajes, y los archivos .md subidos se muestran como texto plano. Arialine convierte el .md compartido en un auténtico Canvas de Slack, con títulos, listas y tablas, y cada bloque de código mermaid se convierte en una imagen de diagrama incrustada. Un documento, totalmente legible en Slack.

08

Insértalo donde quieras

Coloca un diagrama en cualquier Canvas que tu equipo ya lea

Pide a Arialine que añada la versión actual de un tablero a cualquier Canvas de Slack al que tenga acceso: un documento de proyecto, el Canvas de un canal o de una reunión. Arialine renderiza la última versión, la sube y la incrusta al final del Canvas.

09

Slack AI (MCP)

Controla Arialine desde el asistente integrado de Slack

Arialine ofrece un servidor Model Context Protocol, así que Slackbot puede crear, editar, derivar y consultar tus tableros en tu nombre. Pide «convierte esta conversación en un diagrama con Arialine»: Slackbot llama a la herramienta adecuada, Arialine publica el tablero y el registro anota quién lo pidió.

¿Quieres la guía completa?

La documentación cubre cada atajo, cada comando de barra y cada ajuste de administración.

Lleva Arialine a tu próxima conversación de diseño.

Instálalo en un clic. Empieza en un solo canal: Arialine solo participa donde lo invitas y, por defecto, evita generar ruido.