Presets
plugin:@miragon/rules/recommended-for-modeling— for purely business/technical models, and for modeler applications that surface linting to their users. Layout hints only: bpmnlint'sstandard-sizeand the layout rules atwarn, the naming/id rules off — a modeler is never blocked on execution-only conventions. The oneerroris a gateway drawn without its marker, because that diagram is misdrawn.plugin:@miragon/rules/recommended-for-automation— for developers automating processes, locally and in CI, on models wired up to a Camunda engine. The naming and layout rules on but as a non-blockingwarn(standard-sizetoo), so ids and layout get flagged without failing the build. The scheme and engine-specific rules stay off.plugin:@miragon/rules/strict— every Miragon rule aterror, engine-agnostic. The gate to opt into when you want findings to fail the build. Not covered by semver: a minor release may add rules or widen what they report. See the semantic versioning policy.
Severity per rule
| Rule | recommended-for-modelinglayout hints only | recommended-for-automationeverything, non-blocking | strictfails the build |
|---|---|---|---|
| Naming | |||
no-generated-idsIDs generated rather than chosen (Activity_0049ryx, StartEvent_1) | off | warn | error |
element-id-namingIDs that don't follow the type-prefix + case convention | off | warn | error |
worker-topic-namingA worker topic (C7 external task topic, C8 job type) off the configured scheme | off | off | error |
message-name-namingA message name off the configured scheme | off | off | error |
| Layout | |||
flow-through-elementA sequence flow routed through an unrelated shape's body | warn | warn | error |
flow-connection-sideA sequence flow docked onto the wrong side of a shape | warn | warn | error |
flow-target-alignmentA flow's target drawn off the row, sloping the main path | warn | warn | error |
flow-crossingTwo sequence flows whose drawn paths cross each other | warn | warn | error |
flow-orthogonalA sequence flow that runs diagonally instead of horizontal and vertical | warn | warn | error |
boundary-event-marker-overlapA boundary event drawn over a marker or icon of its host activity | warn | warn | error |
exclusive-gateway-marker-visibleAn exclusive gateway drawn without its X marker | error | warn | error |
| Automation | |||
async-continuationsCamunda 7 save points missing where Camunda recommends them, or redundant | off | off | error |
| Bundled from bpmnlint | |||
bpmnlint/standard-sizeElements resized away from the BPMN standard size | warn | warn | off |
Only strict reports at error, so only strict can fail a build on a Miragon finding. strict is not covered by semver: a minor release may add rules or widen what they report. Pin the exact version, or build your own config from a recommended-for-* preset if your build must stay green across minors. Override any single rule in your own .bpmnlintrc. This one extends the structural rules and the modeling preset, raises no-generated-ids to error and silences flow-crossing:
json
{
"extends": [
"bpmnlint:recommended",
"plugin:@miragon/rules/recommended-for-modeling"
],
"rules": {
"@miragon/rules/no-generated-ids": "error",
"@miragon/rules/flow-crossing": "off"
}
}