Cynefin diagrams in Confluence

A Cynefin diagram sorts situations into five domains, each with its own way to respond.

Last updated

When to use it

Use a Cynefin diagram to agree on how to act before acting: clear problems follow a rule, complicated ones need analysis, complex ones need experiments, chaotic ones need action first. Teams use it for incident triage and for deciding how much planning a piece of work deserves.

Example

This is the code of the Triage playbook template: incidents sorted into Cynefin domains with the matching first response.

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 draws it like this:

Change a line and the diagram changes with it. Nobody needs the original drawing file, because there is none: the code is the diagram.

Add it to a Confluence page

  1. Edit a Confluence page and type /mermaid where the diagram should go.
  2. Select Mermaid diagram. The editor opens with the template list.
  3. Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
  4. Choose Save. The diagram appears on the page.

The documentation covers the editor, the settings and the exports.

Templates

The Templates button in the editor has one Cynefin diagram ready to use:

  • Triage playbook: Incidents sorted into Cynefin domains with the matching first response.

Syntax

The code of a Cynefin diagram starts with cynefin-beta. The Mermaid documentation describes every element of the syntax. Vellnar Diagrams draws it with Mermaid 12.3; if a line has an error, the editor marks the line and keeps the last valid diagram on screen.

More

  • Mermaid in Confluence: how diagrams as code work in a page, and every diagram type.
  • Security: the app asks for no permissions and sends nothing outside Atlassian.