bpmn-modeler

Internal architecture of the modeler engine and its hosts — the host-agnostic `libs/modeler-core` package (domain/service/vscode-free infrastructure) consumed by the `apps/vscode-plugin` extension host, the IntelliJ plugin (via `apps/modeler-bridge`), and the Theia/Electron standalone. Covers the feature-folder + four-layer split (domain, infrastructure, service, controller), host-capability ports + hexagonal engine ports, deployment subsystem (Camunda 7 & 8), per-feature register() composition root, WebviewMessageRouter dispatch, EditorSessionParticipant lifecycle, EditorSessionStore + VsCodeEditorHandle, echo-prevention session guards, codeLink + template-marketplace features, webview message protocol (Query/Command), and the ArchUnitTS architecture tests. Use this skill when working on extension-host or modeler-core code — implementing features, fixing bugs, reviewing PRs, refactoring services, adding message types, understanding editor tracking, tracing webview message flow, integrating external systems,

Interact with the BPMN modeler webview running in a browser using Playwright MCP tools. Use this skill whenever the user asks to test, inspect, or interact with the BPMN modeler in a browser — including adding/modifying BPMN elements, checking the properties panel, verifying UI behavior, or debugging the webview. Also trigger when the user mentions "open the modeler in a browser", "add a task/event/gateway", "check the properties panel", or any visual/interactive testing of the BPMN webview.

The IntelliJ host for the BPMN modeler (apps/intellij-plugin, Kotlin/Gradle) and the apps/modeler-bridge stdio JSON-RPC Bun binary that runs the unmodified @miragon/bpmn-modeler-core out-of-process. Covers the Gradle build/run order (build:libs → build:bpmn-webview → bridge compile → ./gradlew runIde), webview bundle staging and the blank-webview trap, the version-keyed bridge-binary cache trap and the -Dmiragon.bridge dev override, the JCEF editor + JBCefJSQuery message relay, the RPC method contract and host-replicated mirrors (document/settings/deployment), plugin.xml extension points, and the process supervisor. Use this skill whenever working on the IntelliJ plugin, the modeler-bridge, JCEF editors/tool windows, plugin.xml, Gradle tasks, RPC adapters, a blank IntelliJ webview, verifyPlugin, or debugging the IntelliJ↔bridge seam. See the architecture skill for the host-agnostic core these two consume.

VS Code CustomTextEditorProvider pattern — registration, document sync, lifecycle, disposables, the generic ModelerEditorController + EditorSessionParticipant pattern, BPMN/DMN differences. Use this skill whenever working on the editor controller, document synchronization, CustomTextEditorProvider, webview lifecycle, editor registration, resolveCustomTextEditor, EditorSessionStore, session participants, or understanding how BPMN/DMN files are opened and edited. Also consult this skill when debugging issues with editor state, hidden webviews, tab switching, or disposable cleanup — even if the user doesn't mention "custom editors" explicitly.

VS Code UX guidelines for this project — how to choose between notifications, status bar, quick picks, and output channels; how clipboard access works between sandboxed webviews and the extension host; webview theming; accessibility; and setContext for keybinding visibility. Use this skill whenever you are adding user-facing feedback (messages, errors, progress), wiring clipboard in webviews, implementing copy/paste, choosing how to surface information to the user, adding keyboard shortcuts or when-clause visibility, working on theming, or considering accessibility. Also use when deciding between notification types or between notifications vs. status bar vs. output channel.

VS Code webview internals — HTML serving, CSP, postMessage protocol, state persistence, theming. Use when working on webview HTML, postMessage, CSP, theme handling, vscode.getState/setState, acquireVsCodeApi, webview.asWebviewUri, retainContextWhenHidden, nonce generation, content security policy, or the Query/Command message protocol between extension host and webview.

bpmn-js modeler internals — EventBus, services, copy-paste architecture, clipboard polyfill, modeler lifecycle. Use when working on bpmn-webview, diagram interactions, copy-paste, clipboard, or element templates.

Add or complete translations for the BPMN/DMN modeler UI in the miranum-ide project. Use this skill whenever the user wants to add a new language, translate missing keys for an existing locale, update translations, or register a new locale in the i18n system. Also trigger when the user mentions locale codes, language names, or talks about translating modeler UI strings in this repository.