process-mapper

Documents as-is and to-be process maps as Mermaid flowcharts for software builds.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill process-mapper-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-mapper
Source: https://github.com/scoots31/engineering-playbook/tree/main/skills/process-mapper
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill process-mapper-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Software projects drift from the agreed business process because no authoritative process map exists to hold design, build, and test decisions accountable. This Skill captures how a process works today and how it should work after the product is built, then enforces that agreement across every phase. ## Core Features & Use Cases - As-Is Mapping: Documents the current process exactly as it exists, including manual steps, spreadsheets, email handoffs, and workarounds, saved as Mermaid flowcharts in docs/process/. - To-Be Process Contract: Produces a validated target-state map that every screen, backlog slice, and test scenario must trace back to. - Drift Detection: Flags gaps and contradictions during design sprints, slice definition, build, and phase testing, requiring explicit decisions before any process change. - Use Case: During discovery for a player evaluation tool, the solo describes a spreadsheet-based workflow. The Skill maps it as-is, drafts the to-be flow, and later flags that no slice covers the escalation branch shown in the agreed map. ## Quick Start Activate guided mode and describe how your current process works so the as-is and to-be process maps can be drafted and validated.

Frequently Asked Questions about process-mapper

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

FAQPage Schema
How do I document a business process before building software?

Describe how the process works today, including manual steps and handoffs, and the Skill produces an as-is Mermaid flowchart saved to docs/process/. It then drafts a to-be map of the target process, which you validate before any design work begins.

What is a to-be process map in product development?

A to-be map is a Mermaid flowchart defining how the process will work once the product is built. It acts as a contract: every design screen, backlog slice, and test scenario must trace back to a step or decision point in it.

Does process mapping work when there is no existing software system?

Yes. The as-is map explicitly handles manual processes such as spreadsheets, email chains, paper forms, and phone calls. It documents what actually happens, including workarounds and decisions held only in someone's head.

What happens when a build decision changes the agreed process?

The Skill flags the drift explicitly and requires a decision before continuing. The to-be map is updated through a formal process change rather than being silently adjusted during design or build.

How are process maps used during testing?

Each slice carries a process anchor tying it to a to-be map step, so main paths are covered via done criteria. Decision branches, exception paths, and the as-is to to-be comparison are read directly from the map to build test scenarios.