pm-state-matrix

Enumerate product state matrices from flows, prototypes, and business rules.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/chenluhan/skill --skill pm-state-matrix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pm-state-matrix
Source: https://github.com/chenluhan/skill/tree/main/.agents/skills/pm-state-matrix
Command: npx skills add https://github.com/chenluhan/skill --skill pm-state-matrix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Derive a complete product state matrix from a flow, prototype, and business rules to replace guesswork in engineering handoffs and QA planning.

Core Features & Use Cases

  • Generate explicit state rows such as normal, empty, loading, failure, permission denied, boundary input, and cancel with clear triggers and outcomes.
  • Document per-row details: trigger condition, user-visible feedback, system action, and risk notes to guide development and testing.
  • Facilitate handoffs to downstream specs and metrics by providing a structured, testable state map from prototype inputs.

Quick Start

Prompt the AI to derive a state matrix from the provided prototype and rules, producing explicit states and associated outcomes.

Frequently Asked Questions about pm-state-matrix

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

FAQPage Schema
How do I derive a complete product state matrix from a user flow for engineering handoff?

A product state matrix enumerates explicit states like normal, empty, loading, failure, and permission denied from a flow to replace guesswork in engineering handoffs. It lists triggers, user-visible feedback, system actions, and risk notes for each state to guide development and testing.

What edge cases should a product state matrix cover when analyzing flow logic?

A product state matrix must cover edge cases including loading, empty, failure, permission denied, boundary input, and cancel states. For each state, it documents trigger conditions, user-visible feedback, system actions, and risk notes to ensure complete test coverage across normal and abnormal scenarios.

How do I document product state triggers and system actions for QA planning?

Document product state triggers and system actions by listing per-row details for each state in the matrix. Each row should specify the trigger condition, user-visible feedback, system action, and risk notes, providing a structured and testable state map from prototype inputs to facilitate QA planning.

Can I generate state matrices for boundary and permission denied cases directly from a prototype?

Yes, you can generate state matrices for boundary and permission denied cases directly from a prototype. By applying business rules to the prototype flow, the state matrix derivation produces explicit states with associated outcomes and documented boundaries for downstream specs and metrics.

Why does my engineering handoff miss critical edge states and boundary inputs?

Engineering handoffs often miss critical edge states because prototype inputs lack a structured state map. Deriving a product state matrix explicitly captures boundary inputs, loading, empty, and failure states with clear triggers and outcomes, replacing guesswork with testable documentation.

When do I need a product state matrix for product management flow analysis?

You need a product state matrix for product management flow analysis when scenarios require explicit happy-path, edge states, and errors across normal, loading, empty, and permission cases. It provides a structured, testable state map from prototype inputs to facilitate downstream handoffs and QA planning.