BPMN for Mermaid

Embedded from okhp3.github.io/mermaid-diagram-bpmn — open in a new tab for the full experience

What bpmn-beta looks like

The canonical purchase order approval flow — three participants, a gateway, and a rejection path — in 20 lines of text. No XML, no drag-and-drop, no proprietary format.

bpmn-beta
accTitle: Purchase Order Approval

pool company "Company" {
  lane requester "Requester" {
    start     s1  "Need Identified"
    task:user t1  "Submit Purchase Request"
  }

  lane manager "Manager" {
    task:user t2  "Review Request"
    xor       g1  "Approved?"
    end       e2  "Rejected"
  }

  lane procurement "Procurement" {
    task:service t3  "Create Purchase Order"
    end          e1  "PO Issued"
  }

  s1 --> t1
  t1 --> t2
  t2 --> g1
  g1 --> t3: "yes"
  g1 --> e2: "no"
  t3 --> e1
}

Paste this into the live playground → okhp3.github.io/mermaid-diagram-bpmn

Where to find the project

BP-SKILL

What it is

Skills are the AI analogue of SOPs -- executable, version-controlled, platform-portable instruction sets that auto-activate on semantic match. The Agent Skills open standard (agentskills.io) defines the SKILL.md format. Claude Code, OpenAI Codex, GitHub Copilot, Gemini CLI, Cursor, and VS Code all support it as of May 2026.

The public Agent Skills ecosystem has over 89,000 skills. Zero implement a BABOK knowledge area. BP-SKILL is the first standards-conformant, lifecycle-complete business process agent skill suite.

Why bpmn-beta is the visual output layer, not the whole product

Most process work never reaches the diagram. Discovery, elicitation, stakeholder mapping, narrative documentation, gap analysis, controls definition, SOP generation, RACI matrices, and SIPOC charts all come before the diagram -- and most of them come after it too. bpmn-beta covers the visual modeling step. BP-SKILL covers the lifecycle.

The 15 skills -- grouped by layer

The standards it aligns to

Install the suite

curl -L https://okhp3.github.io/mermaid-diagram-bpmn/downloads/bp-skill-suite-v0.3.zip \
  -o bp-skill-suite-v0.3.zip && unzip bp-skill-suite-v0.3.zip -d skills/

Or browse individual skills: okhp3.github.io/mermaid-diagram-bpmn/skills →

What's working, what's not

What the project does

What this is — and isn't

Where the project is

The prototype validates the core thesis. The next phase closes the gap to a complete External Diagram plugin that can be proposed upstream.

• ✓

  Prototype Shipped

  Hand-written line parser, heuristic topological layout, hand-written SVG renderer (no bpmn-js), five canonical example diagrams (linear process, gateway decision, pool/lane collaboration, multi-event order, parallel split), six-page React app (Home, Playground, DSL Reference, Architecture, Roadmap, About). Validates the core thesis: a Mermaid-native readable BPMN DSL can render BPMN-correct shapes without bpmn-js.

• →

  v0.1 — Pools, Lanes & Plugin API In Progress

  Pools and lanes implementation (required for Descriptive Conformance subset claim), complete v1 element set, port to Mermaid External Diagram API, Langium grammar prototype for the parser. Target: demo-ready for Mermaid community engagement on issue #7699.

• ○

  v1.0 — Full Plugin Planned

  Langium grammar (replaces hand-written parser), npm publication, accessibility (accTitle/accDescr + ARIA metadata), theme integration, full test suite (Vitest), Mermaid PR gates (size <200 KB, tests, docs).

• ○

  Upstream Proposal Future

  Mermaid core PR after v1.0 syntax stabilizes and community feedback from issue #7699 is incorporated. Requires maintainer acceptance, full docs, and a parity test corpus between the hand-written and Langium parsers.

• ✓

  BP-SKILL v0.3 -- 15-skill Agent Skill Suite Shipped

  15 SKILL.md files, 9 variable layer templates, Process Narrative Specification schema, eval suite, agent skills browser in the React app, full suite download. Proposed domain extension to agentskills.io.

• ○

  agentskills.io Formal Submission Planned

  Submit BP-SKILL as a formal domain extension proposal to the Agent Skills community governance repository.

• ○

  IIBA / ABPMP Practitioner Outreach Planned

  Publish BP-SKILL practitioner articles in IIBA and ABPMP community publications to build awareness in the business analysis community.