flow-mapping

Generate validated Mermaid data-flow diagrams from current-state integration evidence.

3|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/gener8v/gener8v.claude-skills --skill flow-mapping-gener8v
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow-mapping
Source: https://github.com/gener8v/gener8v.claude-skills/tree/main/skills/flow-mapping
Command: npx skills add https://github.com/gener8v/gener8v.claude-skills --skill flow-mapping-gener8v

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mermaid-js/mermaid-cli, and includes scripts (resource) components.

What problem does it solve? Current-state data flows between systems are often described only in prose or interviews, so contradictions stay invisible and diagrams that do get drawn may not compile, omit payload and cadence, or assert flows nobody evidenced. This Skill turns flow findings into Mermaid diagrams that compile, state payload, cadence and reliability, and name their Unknowns explicitly. ## Core Features & Use Cases - Deterministic validation gate: A bundled script compiles every Mermaid diagram with mermaid-cli and runs structural lints (unlabelled edges, missing classDef, missing cadence, orphan nodes, oversized graphs), exiting non-zero on errors. - Reliability modeling: Four node classes (reliable, fragile, broken, isolated) make the maturity of each store and flow part of the diagram itself, with an explicit Unknowns list for what evidence cannot establish. - Use Case: Given interview notes saying "CRM syncs members to Policy Admin nightly and drops date of birth", produce .gener8v/flows/claims.md with a labelled, classed Mermaid diagram, a reliability table, and an Unknowns section, then iterate until the validator exits 0. ## Quick Start Map how claims data moves between our systems into validated Mermaid flow diagrams using the flow-mapping skill.

Frequently Asked Questions about flow-mapping

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

FAQPage Schema
How do I create a data flow diagram from interview or integration evidence?▼

Collect flow findings as source, target, and what moves between them, group by domain, then draft one Mermaid diagram per domain with labelled edges stating payload and cadence. Run the validation script and iterate until it exits 0, recording unresolved conflicts in an Unknowns list.

How to validate that Mermaid diagrams compile before publishing?▼

Run validate-flows.sh on the Markdown files containing the diagrams; it extracts every mermaid fence and compiles each with @mermaid-js/mermaid-cli via npx. Exit code 0 means all diagrams compile with no error-level lints, exit 1 signals failures, and exit 2 indicates a usage problem.

Does the Mermaid validator work without Node.js installed?▼

No, the validator requires npx from Node.js and exits with code 2 if it is absent, reporting a usage problem rather than a compile failure. The first run also needs network access to fetch @mermaid-js/mermaid-cli@11, which takes about 30 seconds.

Why does my Mermaid diagram warn about unlabelled edges or missing cadence?▼

An unlabelled edge asserts nothing about what moves between systems, so the lint flags edges lacking a payload label in any Mermaid dialect. The cadence warning fires when no edge mentions timing such as nightly, batch, or real-time, meaning the diagram is not yet current-state.

When should I not use current-state flow mapping?▼

Do not use it for future-state architecture proposals, since it asserts only what is evidenced today; target-state design belongs to a technical-design process. Also avoid inventing edges to connect isolated nodes, because a deliberately unconnected store is itself the finding.