Як це працює

Одна гілка Slack — діаграма, код і обґрунтування.

Arialine — це застосунок для Slack. Ви описуєте систему, він її малює. Звертайтеся до @arialine у гілці, щоб оновити діаграму. Кожна зміна стає пронумерованою версією з посиланням на повідомлення, що її спричинило. Тут показано весь процес.

Спробуйте — без встановлення

Спершу пройдіть увесь процес самі.

Створіть дошку, застосуйте пропозицію, скасуйте її та відкрийте справжній HTML-файл — а нижче прочитайте, як працює кожна частина.

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

↓Натисніть «Надіслати», щоб згадати Arialine

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

Створення

Сім способів створити дошку

Усі сім дають однаковий результат: кореневе повідомлення в каналі з PNG-превʼю, інтерактивним файлом .html і кнопками History, Branch та Export. Show source відкривається через Export. Наступні версії зʼявляються в гілці; журнал рішень публікується окремо у фоновому режимі. На Slack Free він лишається в гілці дошки й не займає вкладку Canvas каналу.

  • @згадка + опис

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

    +
    Звернення до Aria, Arialine або @arialine: create a checkout funnel with a retry queue and DLQ after 3 tries
  • Згадка після обговорення

    Dana Okafor10:52 AM

    @Arialine turn this into a diagram
    14 repliesLast reply today at 10:51 AM
    @arialine turn this into a diagram — використовує доречне обговорення за останні 72 години й уточнює тему, якщо дві однаково ймовірні
  • Вставити Mermaid

    Priya Nair9:14 AM

    @Arialine render this
    flowchart LR
      A[Checkout] --> B{Paid?}
      B -->|yes| C[Ship]
    @arialine і вставлений код Mermaid — Arialine перевіряє та рендерить його
  • Прикріпити файл .mmd

    Sam Moreau2:03 PM

    @Arialine make this a boardMMDpayments.mmdMermaid
    @arialine з вкладенням .mmd/.mermaid
  • Просто поділитися файлом .mmd

    Sam Moreau2:03 PM

    MMDpayments.mmdMermaid

    ArialineAPP2:03 PM

    🟢 payments · v1 · built from payments.mmd
    Киньте файл у канал — Arialine автоматично створить дошку (можна вимкнути)
  • Ярлик «Render as diagram»

    Priya Nair9:20 AM

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

    Arialine

    Render as diagram

    Render as canvas

    Наведіть курсор або довго натисніть на повідомлення → More actions → Render as diagram
  • /arialine або ‘New diagram’
    New diagram

    Post in channel

    # architecture

    Paste Mermaid or describe the diagram

    flowchart LR
      API --> Queue --> Worker
    CancelCreate
    Введіть /arialine (або меню ⚡ → New diagram), потім вставте Mermaid чи опишіть діаграму — коректний Mermaid відображається без ШІ
02

Будова

Два файли в одному опорному повідомленні

Arialine публікує два файли разом — інтерактивний .html і .png. .png — це превʼю, яке ви бачите в Slack на будь-якому пристрої. Відкрийте .html у браузері, щоб масштабувати й переміщувати діаграму та переглядати панелі Decisions, Source і History.

Кореневе повідомлення — це опора: після кожної зміни його файли замінюються найновішим рендером, тож на початку гілки завжди актуальна діаграма. Відповіді з версіями нижче зберігають кожну попередню пару .png + .html — нічого не губиться.

03

Редагувати

Звертайтеся до @arialine у гілці

Зверніться до Aria, Arialine або @arialine і скажіть «додай шар кешування між шлюзом і базою даних» чи «прибери крок із SMS». Arialine переписує Mermaid, рендерить його, замінює файли в кореневому повідомленні й публікує однорядкову відповідь із версією: v2 — added Redis caching layer — by @you з кнопками ↩︎ Undo this change і ⏪ Rewind to here.

Також можна поставити реакцію 📌 на будь-яке повідомлення, щоб запропонувати його як зміну. Arialine читає позначене повідомлення в контексті розмови й публікує картку з кнопками Apply, Edit proposal і Dismiss.

04

Версії

Скасуйте одну зміну або поверніть усю дошку назад

Історія накопичувальна. Скасування однієї зміни чи повернення до попередньої версії саме стає новою версією. Нічого не перезаписується, тож аудити й ретроспективи завжди відповідають дійсності.

Запитайте в гілці «навіщо тут dead-letter-черга?», і Arialine відповість із журналу рішень — з цитатою, автором і посиланням на оригінальне повідомлення в Slack.

05

Відгалуження та брейншторм

Досліджуйте альтернативи, не чіпаючи оригінал

Натисніть Branch у кореневому повідомленні (або скажіть @arialine branch this at v3 called experiment), щоб відгалузити будь-яку версію в нову дошку. Відгалуження має власну гілку повідомлень і журнал рішень та посилається на вихідну версію.

Згадайте @arialine brainstorm … або прямо попросіть Arialine допомогти з ідеями. Він створить 2–3 альтернативні варіанти поточної діаграми — кожен як превʼю з двома кнопками: Adopt to this board (замінює поточну діаграму новою версією) або Branch to new board (оригінал лишається без змін).

06

Журнал

Canvas у Slack, який пояснює, чому діаграма саме така

Там, де Slack це дозволяє, кожна дошка отримує Canvas-журнал із двома розділами. Timeline показує всі версії від найновішої з відповідною діаграмою. Decisions — це журнал: що змінилося, хто вирішив і посилання на кожне джерельне повідомлення. На Slack Free той самий журнал ведеться як повідомлення в гілці дошки.

Журнал — це архів, а HTML-файл — діаграма, яку можна досліджувати. Разом вони відповідають і на «як це виглядає сьогодні?», і на «як ми до цього дійшли?» — навіть для тих, хто приєднається до команди через пів року.

07

Markdown у Canvas

Поділіться файлом .md — отримайте Canvas у Slack із відрендереним Mermaid

Slack не рендерить Markdown у повідомленнях, а завантажені файли .md показуються як звичайний текст. Arialine перетворює .md на повноцінний Canvas у Slack — із заголовками, списками й таблицями, — а кожен блок коду mermaid стає вбудованим зображенням діаграми. Один документ, який зручно читати просто в Slack.

08

Будь-де

Додайте діаграму на будь-який Canvas, який уже читає команда

Попросіть Arialine додати поточну версію дошки в будь-який доступний йому Canvas у Slack — документ проєкту, Canvas каналу чи зустрічі. Arialine відрендерить останню версію, завантажить її та вставить у кінець Canvas.

09

Slack AI (MCP)

Керуйте Arialine через вбудованого асистента Slack

Arialine надає сервер Model Context Protocol, тож Slackbot може створювати, редагувати, відгалужувати й переглядати ваші дошки від вашого імені. Попросіть «перетвори це обговорення на діаграму за допомогою Arialine» — Slackbot викличе потрібний інструмент, Arialine опублікує дошку, а журнал зафіксує, хто про це попросив.

Потрібна повна інструкція?

У документації описано кожен ярлик, кожну slash-команду й кожне налаштування адміністратора.

Додайте Arialine до наступного обговорення дизайну.

Встановіть одним кліком. Почніть з одного каналу: Arialine працює лише там, куди ви його запросили, і за замовчуванням не створює зайвого шуму.