About Process Mapping
Process Mapping is a skill for creating and analyzing business process diagrams. It supports business analysts and teams communicating workflows, with guidance spanning flowcharts, BPMN, swimlanes, value stream maps, and multiple levels of detail.
Key features
- 01Flowchart and BPMN guidance
- 02Swimlane and value stream maps
- 03Process levels from context to procedures
- 04Mermaid flow, sequence, and state diagrams
- 05Process analysis and validation practices
Use cases
- 01Documenting current and future processes
- 02Finding process bottlenecks and gaps
- 03Explaining cross-functional responsibilities
- 04Planning system changes and integrations
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ danhvb/ my-ba-skills --skill process-mappingAfter installing, type/process-mappingin Claude Code to confirm it loaded.
Details
From the project READMEProcess Mapping Skill
Purpose
Create clear, professional business process diagrams that visualize workflows, identify inefficiencies, and communicate processes to stakeholders and development teams.
When to Use
- Documenting current state (As-Is) processes
- Designing future state (To-Be) processes
- Identifying process gaps and inefficiencies
- Communicating workflows to stakeholders
- System design and integration planning
Process Mapping Types
1. Flowcharts
Best for: Simple, linear processes Symbols:
- ⬭ Oval: Start/End
- ▭ Rectangle: Process/Activity
- ◇ Diamond: Decision
- ▱ Parallelogram: Input/Output
- → Arrow: Flow direction
Example - Order Processing:
Start → Receive Order → Validate Order → [Valid?]
├── Yes → Process Payment → [Paid?]
│ ├── Yes → Ship Order → End
│ └── No → Notify Customer → End
└── No → Reject Order → End
2. BPMN 2.0 (Business Process Model and Notation)
Best for: Complex processes with multiple participants Key Elements:
- Events: Start (○), Intermediate (◎), End (◉)
- Activities: Tasks (▭), Sub-processes (▭+)
- Gateways: Exclusive (◇×), Parallel (◇+), Inclusive (◇○)
- Swimlanes: Pools and lanes for different actors
Example - Invoice Approval BPMN:
Pool: Invoice Approval Process
├── Lane: Requester
│ ├── Start Event
│ ├── Task: Submit Invoice
│ └── Task: Revise Invoice (if rejected)
├── Lane: Manager
│ ├── Task: Review Invoice
│ └── Gateway: Approve? (Yes/No)
├── Lane: Finance
│ ├── Task: Process Payment
│ └── End Event: Invoice Paid
3. Swimlane Diagrams
Best for: Cross-functional processes showing responsibilities Structure: Horizontal or vertical lanes for each role/department
Example - Customer Support:
| Customer | Support Agent | Technical Team | Manager |
|-----------------|------------------|------------------|-----------------|
| Submit Ticket | | | |
| ↓ | | | |
| | Receive & Triage | | |
| | ↓ | | |
| | [Can Resolve?] | | |
| | Yes: Resolve | | |
| | No: ────────────→| Investigate | |
| | | ↓ | |
| | | [Need Escalation?] |
| | | No: Fix & Return | |
| | | Yes: ───────────→| Approve Fix |
| | Update Customer |←─────────────────| |
| Receive Update |←─────────────────| | |
4. Value Stream Mapping
Best for: Lean process improvement, identifying waste Elements: Process steps, wait times, value-add vs. non-value-add
Process Levels
L0: Context Diagram
- High-level view of the entire system
- Shows external entities and interactions
- One page, executive summary level
L1: Process Area View
- Major process areas/modules
- Shows key inputs/outputs between areas
- 5-10 major processes
L2: Detailed Process Flow
- Step-by-step activities within a process
- Includes decisions and branches
- Shows roles responsible
L3: Procedural Steps
- Detailed procedures/work instructions
- Screen-by-screen guidance
- Used for training/SOPs
Mermaid Diagrams (Code-based)
Flowchart Example
flowchart TD
A[Start: Customer Order] --> B{Inventory Available?}
B -->|Yes| C[Reserve Inventory]
B -->|No| D[Backorder]
C --> E[Process Payment]
E --> F{Payment Successful?}
F -->|Yes| G[Create Shipment]
F -->|No| H[Notify Customer]
G --> I[Ship Order]
I --> J[End: Order Delivered]
D --> K[Notify Customer of Delay]
H --> L[End: Order Cancelled]
Sequence Diagram Example
sequenceDiagram
participant Customer
participant WebApp
participant PaymentAPI
participant OrderService
Customer->>WebApp: Submit Order
WebApp->>OrderService: Create Order
OrderService-->>WebApp: Order ID
WebApp->>PaymentAPI: Process Payment
PaymentAPI-->>WebApp: Payment Confirmed
WebApp->>OrderService: Confirm Order
OrderService-->>WebApp: Order Confirmed
WebApp-->>Customer: Order Confirmation
State Diagram Example (Order Status)
stateDiagram-v2
[*] --> Pending: Order Created
Pending --> Processing: Payment Confirmed
Pending --> Cancelled: Payment Failed
Processing --> Shipped: Shipment Created
Processing --> Cancelled: Customer Request
Shipped --> Delivered: Delivery Confirmed
Delivered --> Returned: Return Requested
Returned --> Refunded: Refund Processed
Delivered --> [*]
Refunded --> [*]
Cancelled --> [*]
Domain-Specific Process Examples
E-commerce: Checkout Flow
Start → View Cart → Enter Shipping → Select Shipping Method →
Enter Payment → Review Order → Place Order →
[Payment OK?] → Yes: Confirmation → End
→ No: Payment Error → Retry/Cancel
ERP: Purchase-to-Pay (P2P)
Requisition → Approval Workflow → Purchase Order →
Goods Receipt → Invoice Receipt → 3-Way Match →
[Match OK?] → Yes: Payment → End
→ No: Exception Handling
CRM: Lead-to-Close
Lead Capture → Lead Scoring → [Qualified?] →
Yes: Create Opportunity → Discovery → Proposal →
Negotiation → [Won?] → Yes: Close → Account Created
→ No: Lost Analysis
CDP: Data Activation Flow
Data Collection → Identity Resolution → Profile Unification →
Segmentation → Audience Building → Channel Activation →
Campaign Execution → Response Tracking → Analytics
Best Practices
Design Principles
✅ Do:
- Keep it simple and readable
- Use consistent notation throughout
- Include clear start and end points
- Show decision points clearly
- Document exceptions and error paths
- Use swimlanes for multi-role processes
- Add annotations for complex steps
- Version control diagrams
❌ Don't:
- Overcomplicate with too many details
- Mix notation styles
- Forget exception/error flows
- Skip validation with stakeholders
- Create without understanding the process first
Validation
- Walk through with process owners
- Verify with actual users
- Test with real scenarios
- Document assumptions
- Get stakeholder sign-off
Tools
Figma
- Design custom process diagrams
- Use component libraries for BPMN symbols
- Share for collaboration
Mermaid (Code-based)
- Embed in markdown documentation
- Version control friendly
- Quick diagrams in Lark/Notion
Lucidchart/Miro
- Professional BPMN diagrams
- Real-time collaboration
- Template libraries
Process Analysis Tips
- Identify bottlenecks: Where do things slow down?
- Find redundancies: What's duplicated?
- Spot handoff issues: Where do things fall between cracks?
- Question value: Does this step add value?
- Consider automation: What can be automated?
Next Steps
After process mapping:
- Gap analysis (see
gap-analysisskill) - Process optimization recommendations
- Requirements for system changes
- UAT scenarios based on process flows
References
- BPMN 2.0 Specification (OMG)
- Value Stream Mapping (Lean)
- Business Process Mapping best practices