scenario-decomposition

Decompose confirmed requirements into scenario matrices with verification methods.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill scenario-decomposition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scenario-decomposition
Source: https://github.com/machenjie/rd-skills/tree/main/src/foundation/capabilities/scenario-decomposition
Command: npx skills add https://github.com/machenjie/rd-skills --skill scenario-decomposition

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents teams from planning and building only the happy path by forcing a structured, testable scenario matrix that includes normal behavior, alternate valid paths, edge conditions, failures, abuse/misuse, recovery, and operational support needs.

Core Features & Use Cases

  • Scenario matrix decomposition: Break a confirmed requirement into a complete set of scenarios that cover distinct risk categories (normal, alternate, edge, failure, abuse, recovery, operational).
  • Operationally verifiable outcomes: Require each scenario to include actor, precondition, stimulus, expected outcome, and a concrete verification method.
  • Release-critical prioritization: Classify each scenario as MUST-HANDLE, SHOULD-HANDLE, or DEFERRED to guide planning and risk acceptance.

Quick Start

Use the scenario-decomposition skill when you have a requirement brief and need to generate a scenario matrix that can be used to plan implementation and verification across normal, failure, abuse, recovery, and operational support paths.

Frequently Asked Questions about scenario-decomposition

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

FAQPage Schema
How do I decompose requirements into test scenarios that cover failure and recovery paths?

To decompose requirements into complete test scenarios, you map confirmed requirements into a scenario matrix covering normal, alternate, edge, failure, abuse, recovery, and operational paths. This prevents teams from planning only the happy path by forcing structured risk coverage.

What is scenario decomposition for risk coverage in test planning?

Scenario decomposition for risk coverage is the process of breaking a confirmed requirement into a complete, testable scenario matrix. It ensures strict planning by enforcing mandatory category coverage across normal behavior, failures, abuse, misuse, and recovery operations.

How do I generate test scenarios with mandatory fields for actor, precondition, and verification?

You generate test scenarios with mandatory fields by applying strict decomposition rules that require each scenario to include actor, precondition, stimulus, expected outcome, and a concrete verification method. This ensures every generated scenario is operationally verifiable.

How do I prioritize test scenarios for release-critical implementation planning?

You prioritize test scenarios for release-critical implementation by classifying each decomposed scenario as MUST-HANDLE, SHOULD-HANDLE, or DEFERRED. This prioritization guides planning and explicit risk acceptance across multi-step state changes and concurrency boundaries.

Does scenario decomposition work for requirements with external dependencies and concurrency risks?

Scenario decomposition works effectively for requirements with external dependencies and concurrency risks. It is specifically designed for workflows involving multi-step state changes, authorization boundaries, and data integrity risks to ensure complete verification planning.

When should I not use a scenario matrix for test planning?

You should not use a scenario matrix for test planning if your requirement lacks confirmed details or involves no multi-step state changes, authorization boundaries, or data integrity risks. The decomposition process targets complex workflows requiring strict risk category coverage.