Diagrammi Cynefin in Confluence

Un diagramma Cynefin ordina le situazioni in cinque domini, ciascuno con il proprio modo di rispondere.

Ultimo aggiornamento

Quando usarlo

Usa un diagramma Cynefin per concordare come agire prima di agire: i problemi chiari seguono una regola, quelli complicati chiedono analisi, quelli complessi chiedono esperimenti, quelli caotici chiedono prima un’azione. I team lo usano per il triage degli incidenti e per decidere quanta pianificazione merita un lavoro.

Esempio

Questo è il codice del modello Triage playbook: gli incidenti ordinati nei domini Cynefin, con la prima risposta adatta a ciascuno.

cynefin-beta
  title Operations triage playbook

  clear
    "Reset second factor"
    "Follow the runbook"

  complicated
    "Slow query"
    "Expert analysis"

  complex
    "Intermittent concurrency bug"
    "Probe with logs and canary"

  chaotic
    "Full outage"
    "Roll back first"

  confusion
    "Unclear symptoms: classify first"

  chaotic --> complex : "Service stabilised"
  complex --> complicated : "Pattern found"
  complicated --> clear : "Runbook written"

Vellnar Diagrams lo disegna così:

Cambia una riga e il diagramma cambia con lei. A nessuno serve il file originale del disegno, perché non esiste: il codice è il diagramma.

Aggiungerlo a una pagina di Confluence

  1. Modifica una pagina di Confluence e scrivi /mermaid dove vuoi il diagramma.
  2. Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
  3. Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
  4. Scegli Save. Il diagramma compare nella pagina.

La documentazione spiega l’editor, le impostazioni e le esportazioni.

Modelli

Il pulsante Templates dell’editor ha un modello pronto per questo tipo:

  • Triage playbook: Gli incidenti ordinati nei domini Cynefin, con la prima risposta adatta a ciascuno.

Sintassi

Il codice inizia con cynefin-beta. La documentazione di Mermaid (in inglese) descrive ogni elemento della sintassi. Vellnar Diagrams lo disegna con Mermaid 12.3; se una riga ha un errore, l’editor segna la riga e tiene a schermo l’ultimo diagramma valido.

Altro

  • Mermaid in Confluence: come funzionano i diagrammi scritti come codice in una pagina, e tutti i tipi di diagramma.
  • Sicurezza: l’app non chiede nessun permesso e non manda nulla fuori da Atlassian.