map-user-flows

Mermaid user flow diagrams are generated by mapping persona journeys through existing screen navigation and deriving success scenarios and recovery paths from intent epics. The process validates scenario coverage against the product base contract before emitting per-flow Markdown files.

Recovery paths for failure scenarios are mapped by matching each failure condition to the correct recovery guidance, tracing the error to recovery actions and resolution screens. This produces deterministic Mermaid diagrams grounded in specific persona journeys and scenario IDs.

A decision manifest in UX user flow generation is a YAML file that records inferred decisions, such as persona assignment and screen traces, with tiered grounding and alternatives. It is emitted before writing any flow artifacts to ensure auditability.

Yes, persona journeys are traced across existing screen navigation by resolving all paths against the product base from the JSON contract. The Skill ensures every referenced screen ID exists and validates scenario coverage before outputting the flows.

To produce traceable UX user flows, you need personas.md, a screens directory, an epics directory, and a writable output path. These inputs allow the tool to map success and recovery scenarios and emit a decision-manifest.yaml alongside the diagrams.