Claude Code Plugins

Community-maintained marketplace

Feedback

Process modeling using BPMN notation and flowchart patterns. Creates process diagrams with activities, gateways, events, swimlanes, and decision points for workflow documentation.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name process-modeling
description Process modeling using BPMN notation and flowchart patterns. Creates process diagrams with activities, gateways, events, swimlanes, and decision points for workflow documentation.
allowed-tools Read, Glob, Grep, Task, Skill

Process Modeling

When to Use This Skill

Use this skill when:

  • Process Modeling tasks - Working on process modeling using bpmn notation and flowchart patterns. creates process diagrams with activities, gateways, events, swimlanes, and decision points for workflow documentation
  • Planning or design - Need guidance on Process Modeling approaches
  • Best practices - Want to follow established patterns and standards

Overview

Create and document business processes using BPMN (Business Process Model and Notation) and flowchart notation. Visualize activities, decisions, events, and participant interactions for process understanding and improvement.

What is Process Modeling?

Process modeling creates visual representations of how work flows through an organization. It documents:

  • Activities: What work is performed
  • Sequence: Order of activities
  • Decisions: Choice points and conditions
  • Participants: Who performs each step
  • Events: What triggers and ends the process

BPMN Core Elements

Activities (Rectangles)

Type Symbol Description
Task Rectangle Atomic work unit
Sub-Process Rectangle with + Contains child process
Call Activity Rectangle with thick border Invokes reusable process

Task Types:

Type Description
User Task Human interaction required
Service Task Automated system action
Script Task Script/code execution
Business Rule Task Decision table evaluation
Send Task Message sent
Receive Task Message received
Manual Task Physical work without system

Events (Circles)

Position Symbol Description
Start Thin circle Process trigger
Intermediate Double circle Mid-process event
End Thick circle Process termination

Event Types:

Type Trigger
None Unspecified start/end
Message Message received/sent
Timer Time-based trigger
Error Error condition
Signal Broadcast signal
Terminate Process termination

Gateways (Diamonds)

Type Symbol Description
Exclusive (XOR) Diamond with X One path based on condition
Parallel (AND) Diamond with + All paths execute
Inclusive (OR) Diamond with O One or more paths
Event-Based Diamond with circle Wait for events

Connectors

Type Symbol Description
Sequence Flow Solid arrow Order of activities
Message Flow Dashed arrow Messages between pools
Association Dotted line Artifacts to elements

Swimlanes

Type Description
Pool Represents a participant (organization/system)
Lane Subdivisions within a pool (roles/departments)

Workflow

Phase 1: Define Scope

Step 1: Identify Process Boundaries

## Process Definition

**Process Name:** [Name]
**Purpose:** [Why this process exists]
**Scope:**
  - **Starts When:** [Trigger event]
  - **Ends When:** [Completion criteria]
  - **Includes:** [In-scope activities]
  - **Excludes:** [Out-of-scope activities]

**Participants:**
| Pool | Lanes (Roles) |
|------|---------------|
| [Org/System] | [Role 1], [Role 2] |

Step 2: Choose Model Type

Type When to Use
As-Is Documenting current state
To-Be Designing future state
High-Level Overview, communication
Detailed Implementation, automation

Phase 2: Model the Process

Step 1: Identify Main Path (Happy Path)

  1. Start event (trigger)
  2. Main sequence of activities
  3. End event (completion)

Step 2: Add Decision Points

For each decision:

  • Type of gateway (XOR/AND/OR)
  • Conditions for each path
  • Reconvergence point

Step 3: Add Exception Paths

  • Error handling
  • Timeout scenarios
  • Escalation paths

Step 4: Add Participants

  • Assign activities to lanes
  • Model inter-participant communication
  • Add message flows between pools

Phase 3: Validate and Document

Step 1: Validate Completeness

Check Question
All paths connected Do all activities have incoming and outgoing flows?
No dead ends Do all paths reach an end event?
Gateways balanced Are split gateways matched with joins?
Roles assigned Is every activity in a lane?
Triggers defined Does every start event have a clear trigger?

Step 2: Add Documentation

## Process: [Name]

### Overview

[Brief description of process purpose and flow]

### Triggers

| Event | Description | Frequency |
|-------|-------------|-----------|
| [Trigger] | [What causes it] | [How often] |

### Activities

| # | Activity | Role | System | Duration |
|---|----------|------|--------|----------|
| 1 | [Activity name] | [Role] | [System] | [Time] |

### Decision Points

| # | Decision | Conditions | Paths |
|---|----------|------------|-------|
| 1 | [Decision] | [Criteria] | [Path A], [Path B] |

### Exceptions

| Exception | Handling |
|-----------|----------|
| [Error] | [How handled] |

Output Formats

Mermaid Flowchart (BPMN-Style)

flowchart TD
    Start((Start))
    Task1[Receive Order]
    Gateway1{Valid Order?}
    Task2[Process Payment]
    Task3[Reject Order]
    Task4[Ship Product]
    End1((Complete))
    End2((Rejected))

    Start --> Task1
    Task1 --> Gateway1
    Gateway1 -->|Yes| Task2
    Gateway1 -->|No| Task3
    Task2 --> Task4
    Task4 --> End1
    Task3 --> End2

Swimlane Diagram

flowchart TD
    subgraph Customer
        A[Place Order]
        G[Receive Product]
    end

    subgraph Sales
        B[Review Order]
        C{Approved?}
    end

    subgraph Warehouse
        D[Pick Items]
        E[Pack Order]
        F[Ship Order]
    end

    A --> B
    B --> C
    C -->|Yes| D
    C -->|No| A
    D --> E
    E --> F
    F --> G

Narrative Summary

## Process: Order Fulfillment

**Version:** 1.0
**Date:** [ISO Date]
**Owner:** [Name]

### Summary

This process handles customer orders from receipt to delivery.

### Flow Description

1. **Start**: Customer places order (online or phone)
2. **Review Order**: Sales validates order details
3. **Decision**: Is order valid?
   - Yes: Proceed to fulfillment
   - No: Return to customer for correction
4. **Pick Items**: Warehouse locates products
5. **Pack Order**: Items packaged for shipping
6. **Ship Order**: Handed to carrier
7. **End**: Customer receives product

### Metrics

| Metric | Current | Target |
|--------|---------|--------|
| Cycle Time | 3 days | 2 days |
| Error Rate | 5% | 1% |
| Automation | 40% | 70% |

### Improvement Opportunities

1. Automate order validation
2. Parallel picking for multi-item orders
3. Real-time tracking integration

Structured Data (YAML)

process_model:
  name: "Order Fulfillment"
  version: "1.0"
  date: "2025-01-15"
  type: "as_is"  # or "to_be"
  owner: "Operations"

  boundaries:
    trigger: "Customer places order"
    end_state: "Customer receives product"
    scope:
      includes:
        - "Order receipt"
        - "Payment processing"
        - "Fulfillment"
        - "Shipping"
      excludes:
        - "Returns"
        - "Customer support"

  participants:
    - pool: "Company"
      lanes:
        - name: "Sales"
          activities: ["Review Order"]
        - name: "Warehouse"
          activities: ["Pick Items", "Pack Order", "Ship Order"]
    - pool: "Customer"
      lanes:
        - name: "Buyer"
          activities: ["Place Order", "Receive Product"]

  elements:
    events:
      - id: "start_1"
        type: "start"
        name: "Order Received"
        trigger: "message"

      - id: "end_1"
        type: "end"
        name: "Order Complete"

    activities:
      - id: "task_1"
        type: "user_task"
        name: "Review Order"
        lane: "Sales"
        duration: "15 minutes"

      - id: "task_2"
        type: "service_task"
        name: "Process Payment"
        lane: "Sales"
        system: "Payment Gateway"

    gateways:
      - id: "gw_1"
        type: "exclusive"
        name: "Order Valid?"
        conditions:
          - path: "task_2"
            condition: "Order validated"
          - path: "task_reject"
            condition: "Validation failed"

  sequence_flows:
    - from: "start_1"
      to: "task_1"
    - from: "task_1"
      to: "gw_1"
    - from: "gw_1"
      to: "task_2"
      condition: "valid"

  metrics:
    cycle_time:
      current: "3 days"
      target: "2 days"
    automation_rate:
      current: 40
      target: 70

Common Process Patterns

Sequential Process

Activities in strict order, one after another.

flowchart LR
    A[Step 1] --> B[Step 2] --> C[Step 3] --> D[Step 4]

Parallel Split and Join

Activities that can occur simultaneously.

flowchart TD
    A[Start] --> B{Parallel Split}
    B --> C[Task A]
    B --> D[Task B]
    B --> E[Task C]
    C --> F{Join}
    D --> F
    E --> F
    F --> G[End]

Exclusive Decision

Only one path taken based on condition.

flowchart TD
    A[Review] --> B{Decision}
    B -->|Approve| C[Process]
    B -->|Reject| D[Notify]
    C --> E[End]
    D --> E

Loop/Iteration

Repeat activities until condition met.

flowchart TD
    A[Start] --> B[Process]
    B --> C{Complete?}
    C -->|No| B
    C -->|Yes| D[End]

Exception Handling

Handle errors and exceptions.

flowchart TD
    A[Process] --> B{Success?}
    B -->|Yes| C[Continue]
    B -->|Error| D[Handle Error]
    D --> E{Recoverable?}
    E -->|Yes| A
    E -->|No| F[Escalate]

Best Practices

Practice Description
Start simple Begin with happy path, add complexity
One start, one end Per pool, ideally
Name activities Use verb-noun format (e.g., "Review Order")
Label gateways Show the decision question
Label conditions Describe each outgoing path
Balance gateways Split and join with matching types
Avoid crossing lines Rearrange for clarity
Document exceptions Show error handling paths

Integration

Upstream

  • stakeholder-analysis - Process participants
  • domain-storytelling - Current process discovery
  • capability-mapping - Capability context

Downstream

  • value-stream-mapping - Value flow analysis
  • Requirements - Process requirements
  • System design - Automation opportunities

Related Skills

  • value-stream-mapping - Lean perspective on process flow
  • data-modeling - Data entities in processes
  • journey-mapping - Customer experience perspective
  • capability-mapping - Process-capability alignment

Version History

  • v1.0.0 (2025-12-26): Initial release