po-journey-architect

Translate business goals into actionable product requirements and Mermaid diagrams.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/garbray/claude-config --skill po-journey-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: po-journey-architect
Source: https://github.com/garbray/claude-config/tree/main/config/skills/po-journey-architect
Command: npx skills add https://github.com/garbray/claude-config --skill po-journey-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps Claude act as a seasoned Product Owner and App Journey Architect, translating business goals into clear, actionable product requirements and documenting user journeys, system flows, and edge cases.

Core Features & Use Cases

  • Translate business goals into concrete requirements for product teams and developers.
  • Design and document end-to-end user journeys, system flows, and state diagrams using Mermaid.
  • Review high-level designs for completeness, feasibility, and risk, identifying gaps, ambiguities, and edge cases.
  • Validate specifications to ensure they are build-ready and testable.

Quick Start

  • Review the attached product spec, translate goals into actionable requirements, and generate Mermaid diagrams for the user journey, sequence, and state chart, plus a risk/assumptions summary.

Frequently Asked Questions about po-journey-architect

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

FAQPage Schema
How do I translate business goals into actionable product requirements?

Translating business goals into actionable product requirements involves reviewing specifications to identify gaps, ambiguities, and edge cases, then mapping them into clear development tasks. This ensures your product goals are build-ready and testable for engineering teams.

How do I generate Mermaid diagrams for user journey design?

Generating Mermaid diagrams for user journey design requires mapping end-to-end system flows and user interactions into sequence, state, and flow charts. This visualizes the complete product journey, highlighting edge cases and validating specification feasibility.

What is the best way to validate if a specification is build-ready?

Validating if a specification is build-ready involves reviewing high-level designs for completeness, feasibility, and risk. You identify gaps and ambiguities in the product requirements to ensure the spec is fully testable before development begins.

Can I identify edge cases during specification review?

Identifying edge cases during specification review is possible by analyzing user journeys and system flows. Reviewing the product requirements and state charts uncovers gaps and ambiguities, ensuring all potential edge scenarios are documented and mitigated.

Does product journey modeling work for agile specification reviews?

Product journey modeling works for agile specification reviews by translating dynamic business goals into actionable requirements. It validates build-readiness and designs Mermaid sequence and state charts to map flows, ensuring continuous feasibility checks during sprints.

Why should I use Mermaid state charts for product requirement translation?

Using Mermaid state charts for product requirement translation visually maps system flows and user journeys. This identifies gaps, ambiguities, and edge cases that text-based specifications often miss, ensuring your actionable requirements are build-ready.