Skip to content
3

@miragon/rules/exclusive-gateway-marker-visible โ€‹

Reports an exclusive gateway drawn without its X marker.

Examples โ€‹

An order review that branches on whether the order is approved. The two pictures share the same model; only the gateway's DI attribute differs.

exclusive-gateway-marker-visible/invalid.bpmn

Invalid model: an exclusive gateway rendered without its X marker

Valid model: an exclusive gateway rendered with its X marker

1 finding
  • gateway_approved Exclusive gateway is drawn without its X marker โ€” set isMarkerVisible="true"

Invalid: gateway_approved is drawn as an empty diamond

Valid: the same gateway with its X marker visible

The same, as XML. ๐Ÿ‘Ž wrong:

xml
<bpmndi:BPMNShape id="gateway_approved_di" bpmnElement="gateway_approved">
  <dc:Bounds x="520" y="175" width="50" height="50" />
</bpmndi:BPMNShape>

๐Ÿ‘ right:

xml
<bpmndi:BPMNShape id="gateway_approved_di" bpmnElement="gateway_approved" isMarkerVisible="true">
  <dc:Bounds x="520" y="175" width="50" height="50" />
</bpmndi:BPMNShape>

Why โ€‹

Whether the X is drawn depends on isMarkerVisible on the gateway's BPMNShape, and the BPMN specification defaults that attribute to false. Without it the gateway renders as an empty diamond. A stakeholder reading the diagram then has to guess whether the branches are exclusive, and the model looks different from every other diagram the team draws in the Camunda Modeler, which always writes the attribute.

Why this matters for agentic BPMN โ€‹

Agents and generators write the DI layer from scratch and leave out attributes that are optional in the schema. The semantic model stays correct, so the XML review shows nothing; the missing marker appears only once the diagram is rendered.

Typical AI artifact without this rule: a bpmndi:BPMNShape for a decision gateway with bounds but without isMarkerVisible="true", rendered as a blank diamond.

What this rule guarantees: every exclusive gateway shows its X marker.

Scope โ€‹

The rule reads the DI layer of every diagram: each BPMNShape whose element is a bpmn:ExclusiveGateway must carry isMarkerVisible="true". A missing attribute and an explicit false are both reported.

It does not report other gateway types (parallel, inclusive, event-based, complex), since their marker is always drawn and the attribute has no effect on them.

Further reading โ€‹