Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
aj-geddes avatar

Process Mapping

  • 476 installs
  • 305 repo stars
  • Updated March 4, 2026
  • aj-geddes/useful-ai-prompts

process-mapping is a Claude Code skill that helps developers map end-to-end business processes, actors, handoffs, and bottlenecks to clarify scope before designing software, automation, or organizational changes.

About

process-mapping is a prompt skill from aj-geddes/useful-ai-prompts for documenting how work actually flows across people, systems, and handoffs before writing code. The skill structures discovery of actors, steps, decision points, bottlenecks, and failure modes so engineering scope reflects real operations instead of assumptions. Developers reach for process-mapping when a feature request spans multiple teams, when automation targets are unclear, or when a refactor must mirror an existing operational workflow. The output is a shared process view that informs API boundaries, state machines, and integration priorities. process-mapping suits technical leads and engineers asked to translate business workflows into software requirements without skipping operational detail.

  • Current-state flows
  • Actor handoff mapping
  • Bottleneck identification
  • Swimlane diagrams
  • Scope input artifacts

Process Mapping by the numbers

  • 476 all-time installs (skills.sh)
  • Ranked #772 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill process-mapping

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs476
repo stars305
Last updatedMarch 4, 2026
Repositoryaj-geddes/useful-ai-prompts

How do you map business processes before building software?

Map end-to-end business processes, actors, handoffs, and bottlenecks to clarify scope before designing software, automation, or org changes.

Who is it for?

Developers and tech leads who must translate messy operational workflows into clear software scope before implementation.

Skip if: Teams already coding against a frozen spec with no process ambiguity should skip process-mapping.

When should I use this skill?

The user wants to map a business workflow, clarify actors and handoffs, or define scope before designing software or automation.

What you get

Process maps with actors, handoffs, bottlenecks, and scope boundaries for software or automation design.

Files

SKILL.mdMarkdownGitHub ↗

Process Mapping

Table of Contents

Overview

Process mapping creates visual representations of workflows, helping teams understand current operations, identify bottlenecks, and design improvements.

When to Use

  • Documenting existing workflows
  • Identifying process improvements
  • Onboarding new team members
  • Discovering inefficiencies and bottlenecks
  • Planning system implementations
  • Analyzing customer journeys
  • Automating manual processes
  • Training and documentation

Quick Start

Minimal working example:

Mapping Approaches:

Current State (AS-IS):
  Purpose: Understand existing process
  Participants: People doing the work
  Timeline: 2-4 hours
  Output: Current workflow diagram
  Benefits: Identifies real bottlenecks

Future State (TO-BE):
  Purpose: Design improved process
  Participants: Cross-functional team
  Timeline: 4-8 hours
  Output: Improved workflow design
  Benefits: Clear vision for change

Value Stream Mapping:
  Purpose: Focus on value-added vs waste
  Participants: Process owners, operations
  Timeline: Full day
  Output: Detailed flow with timing
  Benefits: Identifies waste and delays

Swimlane Diagram:
  Purpose: Show roles and responsibilities
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the references/ directory:

GuideContents
Process DocumentationProcess Documentation
Current State AnalysisCurrent State Analysis
Future State DesignFuture State Design
Process Improvement MetricsProcess Improvement Metrics

Best Practices

✅ DO

  • Map current state first before designing changes
  • Include all stakeholders in mapping sessions
  • Document actual processes, not theoretical ones
  • Identify waste and bottlenecks
  • Design future state with team input
  • Include decision points and exceptions
  • Add timing and resource information
  • Keep processes simple and visual
  • Update maps when processes change
  • Use mapping to drive continuous improvement

❌ DON'T

  • Skip documenting current state
  • Design future state without understanding current
  • Over-complicate process diagrams
  • Forget about edge cases and exceptions
  • Ignore process performance metrics
  • Create maps that nobody can understand
  • Design improvements without involving people doing work
  • Implement changes without validating process
  • Leave outdated maps in documentation
  • Ignore customer perspective

Related skills

FAQ

When should developers use process-mapping?

process-mapping fits early validation when actors, handoffs, and bottlenecks are unclear before software or automation design. Developers use it to translate operational workflows into concrete scope, API boundaries, and integration priorities.

What does process-mapping produce?

process-mapping yields structured process documentation covering actors, steps, handoffs, bottlenecks, and decision points. Engineering teams use the output to define software scope, state transitions, and automation targets with fewer rework cycles.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.