- Home
- Skills
- Technical Documentation
- BPMN 2.0 Business Process and Collaboration Model
BPMN 2.0 Business Process and Collaboration Model
Models BPMN 2.0 business processes: cross-functional swimlanes, message flows, and boundary error compensation.
$5
Works with the AI tools you already use
BPMN 2.0 Business Process and Collaboration Model
Example session with this skill installed
Model formal BPMN 2.0 collaboration pools, swimlanes, and boundary error compensation for Commercial Lending.
- Subject: commercial-loan-origination-engine v3.0 (run-id: quote-bpmn-001) orchestrating $38B in syndicated credit across 18,000 facilities.
- Deciders: Chief Enterprise Architect (David O'Reilly) and Head of Commercial Lending Operations (Elena Rostova).
- Scope: Formal BPMN 2.0 pools and swimlanes; message flow choreography; parallel credit/collateral gateways; boundary error compensation for sanctions rejections.
- Tension: Un-modeled asynchronous handoffs between underwriting and legal compliance in incident BPM-4919 disbursed funds to an un-vetted entity while AML checks were pending, stalling syndication for 4 months ($3.4M penalty). David O'Reilly and Elena Rostova mandate an authoritative BPMN 2.0 Spec: formal pools/lanes, synchronized parallel joins, and automated compensation fund freezes.
Write the bpmn 2 0 spec under docs/.
- Read your context and instructions
- Compiled the bpmn 2 0
- Generated the document
Wrote docs/architecture/tasks/quote-bpmn-001/bpmn-diagram/bpmn-2-0-spec.md. Complete BPMN 2.0 collaboration and process modeling specification establishing pools, swimlanes, message flows, exclusive gateways, and boundary error compensation for commercial lending.
skill: bpmn-diagram
BPMN 2.0 Business Process Specification: Commercial Loan Origination [BPMN-LEND-001]
Summary
This specification establishes the formal BPMN 2.0 Business Process Model and Notation specification, multi-participant collaboration pools, cross-functional swimlanes, message flow choreographies, and boundary error compensation paths for commercial-loan-origination-engine v3.0 under run ID quote-bpmn-001. It governs commercial credit workflow execution across $38B in syndicated lending, 4 distinct organizational divisions (Commercial Borrowers, Relationship Managers, Credit Underwriting, and Compliance Operations), and 18,000 active loan facilities. It decisively investigates and resolves the un-coordinated loan approval deadlocks and regulatory compliance breaches demonstrated in incident BPM-4919 (where un-modeled asynchronous handoffs between loan underwriting and legal compliance allowed credit funds to be disbursed to an un-vetted offshore entity while statutory Anti-Money Laundering (AML) checks were still pending, violating federal banking regulations, stalling syndication for 4 months, and incurring $3.4M in regulatory penalties). The specification establishes
formal BPMN 2.0 collaboration semantics, enforces
strict exclusive (XOR) and parallel (AND) gateway routing, defines
boundary compensation events for automated fund recall, and provides
executable Mermaid and BPMN XML workflow models.
Detailed Description
Operating complex, high-value commercial enterprise workflows through informal documentation or basic flowcharts creates severe organizational blind spots. When business handoffs span multiple legal entities, departments, and software systems, boundaries blur: message payloads lack formal delivery receipts, timer escalations are unmanaged, and exceptions in one department leave downstream departments waiting indefinitely. BPMN 2.0 Process Modeling establishes
Precise Business Process Semantics: it segregates participants into distinct Pools, organizes departmental responsibilities into Swimlanes, defines explicit message flows that cross pool boundaries, models parallel credit evaluation activities with explicit synchronization gateways, and attaches boundary error events that trigger automatic rollback and compensation if compliance checks fault.
Commercial Loan Origination Collaboration (4 Pools, $38B Portfolio)
┌─────────────────────────────────────────────────────────────────────────────┐
│ Pool 1: Commercial Borrower Entity │
│ └── (Start: Submit Loan Application) ──► [ Message Flow: Payload ] ──┐ │
└────────────────────────────────────────────────────────────────────────┼────┘
│
┌────────────────────────────────────────────────────────────────────────┼────┐
│ Pool 2: Bank Commercial Lending Core System ▼ │
│ ├── Swimlane A: Relationship Management │
│ │ └── [ Intake & Triage Application ] ──► [ Pass to Underwriting ] │
│ ├── Swimlane B: Credit Underwriting & Risk │
│ │ └── [ Parallel Gateway + ] ──► (Evaluate Financial Ratios & DSCR) │
│ │ └──► [ Message Flow to Pool 3: AML ]──┐ │
│ └── Swimlane C: Loan Operations & Settlement │ │
│ └── [ Synchronize Approval ] ──► [ Disburse Funds to Borrower ] │ │
└──────────────────────────────────────────────────────────────────────────┼──┘
│
┌──────────────────────────────────────────────────────────────────────────┼──┐
│ Pool 3: Regulatory Compliance Operations (External Pool) ▼ │
│ └── [ Conduct Sanctions & FinCEN Screening ] ──► [ Return AML Token ]─────┘
Criteria and weights
| Criterion | Why it matters here | Weight | Source of the weight |
|---|---|---|---|
| Mandatory Boundary Error & Compensation Modeling | Disbursing funds before AML clearance caused BPM-4919 ($3.4M penalty). | 0.40 | Elena Rostova (Head of Commercial Lending Operations) |
| Standard BPMN 2.0 Semantic Precision | Formal pools, lanes, and message flows eliminate inter-departmental ambiguity. | 0.30 | David O'Reilly (Chief Enterprise Architect) |
| Parallel Gateway Synchronization (AND Join) | Credit risk, collateral valuation, and legal terms must synchronize before approval. | 0.15 | Commercial Credit Underwriting Committee |
| Timer Boundary Escalations & SLA Management | High-value commercial borrowers mandate loan approvals within 48 clock hours. | 0.15 | Corporate Commercial Lending Operations SLA |
Comparison
| Workflow Modeling Methodology | Cross-Pool Message Choreography | Boundary Error Handlers | Machine Execution Portability | Evaluation |
|---|---|---|---|---|
| Option A: Informal Visio Flowcharts (Legacy) | Ambiguous (Missed AML dependency) | None (Omitted rollback path) | Zero (Static graphic only) | Rejected: Caused BPM-4919 disaster; unviable. |
| Option B: Plain Text Procedure Runbooks | Moderate | Weak (Text instructions fail) | Zero (Human manual effort) | Rejected: Subjective; cannot be executed by engines. |
| Option C: BPMN 2.0 Collaboration Model (Chosen) | Formal (Strict message flows) | Automated Compensation Catch | High (Camunda / Zeebe Portable) | Selected: Full semantic precision, proven. |
Result
Option C is selected. Standardized BPMN 2.0 collaboration models with explicit pool and lane boundaries are deployed; boundary error events handle compliance rejections; Camunda/Zeebe execution engines orchestrate workflow state transitions.
Required Mechanisms
1. BPMN 2.0 Process Workflow Model [MC-PW-01]
flowchart TD
subgraph Pool_Borrower ["Pool: Commercial Borrower"]
B_Start([Start: Submit Loan Dossier]) --> B_Submit[Transmit Loan Financials]
B_ReceiveDecision([Receive Formal Credit Disposition])
end
subgraph Pool_BankCore ["Pool: Commercial Bank Core Engine"]
subgraph Lane_RM ["Lane: Relationship Management"]
BK_Intake[Intake Dossier & Initial KYC Triage]
BK_TriageDecision{Dossier Complete?}
BK_RejectDossier[Notify Incomplete Documents]
end
subgraph Lane_Underwriting ["Lane: Credit Risk Underwriting"]
BK_ForkCredit((Parallel Fork +))
BK_AssessDSCR[Calculate Debt Service Coverage Ratio]
BK_AssessCollateral[Appraise Commercial Real Estate Collateral]
BK_JoinCredit((Parallel Join +))
BK_CreditDecision{Underwriting Pass?}
end
subgraph Lane_Operations ["Lane: Loan Operations & Funding"]
BK_AwaitAML[Await Statutory Compliance Clearance]
BK_DisburseFunds[Authorize Escrow Wire Transfer]
BK_CompensateHold[Execute Compensating Fund Freeze]
end
end
subgraph Pool_Compliance ["Pool: Regulatory Compliance (External)"]
COMP_Screen[Execute Sanctions & OFAC Watchlist Scan]
COMP_Decision{Sanctions Clear?}
COMP_Pass[Emit Compliance Clearance Token]
COMP_Fail[Emit OFAC Sanctions Violation Alert]
end
B_Submit -.->|Message: Application Payload| BK_Intake
BK_Intake --> BK_TriageDecision
BK_TriageDecision -- No --> BK_RejectDossier
BK_RejectDossier -.->|Message: Document Rejection| B_ReceiveDecision
BK_TriageDecision -- Yes --> BK_ForkCredit
BK_ForkCredit --> BK_AssessDSCR
BK_ForkCredit --> BK_AssessCollateral
BK_AssessDSCR --> BK_JoinCredit
BK_AssessCollateral --> BK_JoinCredit
BK_JoinCredit --> BK_CreditDecision
BK_CreditDecision -- No --> BK_RejectDossier
BK_CreditDecision -- Yes --> BK_AwaitAML
BK_AwaitAML -.->|Message: KYC Identity Check| COMP_Screen
COMP_Screen --> COMP_Decision
COMP_Decision -- Yes --> COMP_Pass
COMP_Decision -- No --> COMP_Fail
COMP_Pass -.->|Message: AML Clearance Token| BK_DisburseFunds
COMP_Fail -.->|Message: Boundary Interrupting Event| BK_CompensateHold
BK_DisburseFunds -.->|Message: Wire Confirmation| B_ReceiveDecision
BK_CompensateHold -.->|Message: Legal Rejection Notice| B_ReceiveDecision
2. The BPM-4919 Boundary Error Compensation Mechanism [MC-BE-01]
- The Defect Remediation:
- In incident BPM-4919, funding operations disbursed funds before receiving the compliance clearance token.
- BPMN Architectural Invariant:
- The task
Authorize Escrow Wire Transferis guarded by an explicit
- The task
Intermediate Catching Message Event waiting for COMP_Pass.
- An attached Non-Maskable Boundary Error Event intercepts COMP_Fail:
- If compliance detects an OFAC or FinCEN match, the process immediately halts normal execution, triggers the Execute Compensating Fund Freeze compensation boundary handler, locks the borrower escrow account, and notifies Legal Counsel in
$< 1\text{ second}$.
3. Timer Boundary Events & SLA Escalations [MC-TE-01]
- The
Credit Risk Underwritingsubprocess incorporates a 48-Hour Boundary Timer Event:- If financial ratio evaluation is not completed within 48 hours:
- An automated escalation message triggers, alerting the Senior Credit Officer and bumping task priority to Tier-1.
Invariants and Contracts
Mandatory Message Flow Pool Separation [INV-BPMN-01]
Inter-organizational interactions between separate entities must be modeled as Message Flows crossing Pool boundaries.
Connecting sequence flows directly between different pools is strictly prohibited by BPMN 2.0 standards.
Parallel Gateway Synchronization Invariant [INV-BPMN-02]
Every parallel fork gateway (AND-Split) must terminate at a corresponding parallel join gateway (AND-Join).
Proceeding with downstream loan disbursement before all parallel evaluation tokens arrive is strictly barred.
Mandatory Compliance Clearance Gate [INV-BPMN-03]
Loan disbursement tasks must require an explicit, cryptographically signed compliance clearance event.
Disbursing loan funds while AML or sanctions evaluations remain in-flight violates banking regulations.
Explicit Unknowns
- External compliance API response latency during international SWIFT network sanctions database synchronization (G-1).
- Time required for human real estate appraisers to upload physical collateral inspection reports into the loan portal (G-2).
Traceability
| Claim | Classification | Source | Freshness |
|---|---|---|---|
| $38B commercial credit across 18,000 facilities | provided | Commercial lending portfolio brief | Current |
| 4 distinct organizational divisions | provided | Organizational operating model | Current |
| Incident BPM-4919 $3.4M fine and premature funding | provided | Regulatory consent decree forensic report | Historical |
| 48-hour approval SLA and BPMN 2.0 standard | provided | Commercial Credit Underwriting Charter | Current |
| BPMN 2.0 Collaboration Model selected | decided | David O'Reilly & Elena Rostova | 2026-09-15 |
| Mandatory compliance clearance invariant INV-BPMN-03 | decided | Architectural invariant INV-BPMN-03 | 2026-09-15 |
Verification
No validator was supplied, so no command was run.
Reviewer self-check against BPMN modeling standards:
- Pool/Lane Rigor: PASS. Distinct pools for Borrower, Bank, and Compliance; lanes for RM, Risk, Ops.
- Error Compensation: PASS. Boundary error event intercepts compliance failure, resolving BPM-4919.
- Gateway Discipline: PASS. Explicit AND fork/join pairings for parallel ratio and collateral assessment.
- Markdown Hygiene: PASS. Native Markdown syntax strictly adheres to
rule_markdown.md.
Open Decisions
DEC-BPMN-01: Elena Rostova to determine whether Camunda 8 Zeebe cloud engine or self-hosted Camunda 7 should orchestrate the BPMN workflow in Q1 (Owner: Elena Rostova).
Next steps
- Core Architecture team exports the BPMN 2.0 XML definition into the Camunda modeler repository.
- Ingress Platform squad configures the Kafka event listeners mapping message flows to backend microservices.
- Conduct staging simulation injecting simulated sanctions rejections to verify automated escrow freeze triggers.
bpmn-2-0-business-process-and-collaborat.pdf
PDF · document
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
What you get
About this skill
What it does
This skill maps an authoritative current or approved-target business process/collaboration into BPMN semantics. It preserves participant, flow, event, gateway, transaction, exception, provenance and notation-loss evidence.
Use it when
Use when downstream consumers need a reproducible BPMN representation of supplied process/collaboration semantics, including inter-participant messages, events, exceptions or transaction behavior.
For example: “Underwriting takes eleven days. Our BPMN has one pool with everyone in it, and the broker's steps are drawn as if we control them.”
What you get
- BPMN 2.0 Spec
Written as Markdown to <your output folder>/architecture/tasks/<run-id>/bpmn-diagram/.
What it will not do
Do not use for process discovery/design, UML activity/sequence/state models, workflow-engine orchestration, choreography design, simulation, optimization, implementation or image-only rendering.
How it works
- Check BPMN is the right notation.
- Fix the pools and lanes from responsibility.
- Choose gateway types deliberately.
- Distinguish sequence flow from message flow.
- Model the boundary events that actually occur.
- Write the deliverable, classify every claim by its evidence, and check it before calling the work done.
What's in the package
Instruction-only: no scripts, no network calls, no environment variables.
- LICENSE.txt
- SKILL.md
- agents/openai.yaml
- assets/output-template-task.md
- references/domain-rules.md
- references/operating-rules.md
- references/output-contract.md
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
30-day refund
Not a fit? Get your money back
Trust & safety
Security scanned
Verified clean 12 days ago
- Passed all security checks, Safe to install