arch-lens-process-flow

Generate Mermaid diagrams of workflow state transitions and runtime behavior from process definitions.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/Trecek/useful-claude-skills --skill arch-lens-process-flow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-lens-process-flow
Source: https://github.com/Trecek/useful-claude-skills/tree/main/.claude/skills/arch-lens-process-flow
Command: npx skills add https://github.com/Trecek/useful-claude-skills --skill arch-lens-process-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This lens helps teams visualize and reason about runtime behavior by capturing how a system flows through states, transitions, and decision points.

Core Features & Use Cases

  • Runtime behavior diagrams: Show how processes start, progress through states, and handle decisions and retries.
  • State-transition mapping: Document guards, actions, and outcomes for each transition between states.
  • Use Case: When analyzing a complex workflow, generate a Mermaid diagram to communicate runtime flow to developers and operators.

Quick Start

Activate the lens on a running workflow to produce a Mermaid diagram that visualizes the execution path.

Frequently Asked Questions about arch-lens-process-flow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visualize workflow state transitions in a Mermaid diagram?

To visualize workflow state transitions in a Mermaid diagram, map the runtime behavior by applying this lens to your process. It documents entry points, triggers, decision points, and error paths while labeling edges with guards and actions.

What is the best way to document runtime behavior and process flow for developers?

Documenting runtime behavior for developers is best achieved by mapping execution paths into a Mermaid-based diagram. This captures how processes start, progress through states, handle loops, and manage retries to clearly communicate flow.

How do I map decision points and error paths in a complex workflow?

To map decision points and error paths in a complex workflow, apply the process flow lens to generate a diagram capturing guards, actions, and outcomes for each state transition, ensuring all execution branches are visually documented.

Can I generate a reusable Mermaid diagram of my system's runtime behavior?

Yes, you can generate a reusable Mermaid diagram of your system's runtime behavior. The lens produces a prescribed diagram with specific node types, subgraphs, and edge labels that can be directly loaded into your context.

Does this process flow lens document reads and writes to state and storage?

Yes, this process flow lens documents reads and writes to state and storage. While mapping the workflow transitions and execution paths, it explicitly records state interactions alongside the visualized runtime behavior.

When do I need a state-transition diagram for my workflows?

You need a state-transition diagram for your workflows when analyzing complex processes to communicate runtime flow to developers and operators, ensuring that triggers, loops, and error paths are clearly visualized and reasoned about.