shaping-writing-domain-scenarios

Generate domain scenario documents with personas, workflows, and edge cases.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/musher-dev/bundles --skill shaping-writing-domain-scenarios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shaping-writing-domain-scenarios
Source: https://github.com/musher-dev/bundles/tree/main/project-shaping-orchestration/skills/writing-domain-scenarios
Command: npx skills add https://github.com/musher-dev/bundles --skill shaping-writing-domain-scenarios

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps bridge the gap between understanding a problem and designing a solution by creating detailed domain scenarios that uncover edge cases and complexities before development begins.

Core Features & Use Cases

  • Persona Definition: Define user personas with detailed mental models, goals, and frustrations.
  • Workflow Mapping: Document core scenarios, including step-by-step actions, preconditions, and postconditions.
  • Edge Case Identification: Systematically probe for and document potential edge cases and exception paths.
  • Domain Vocabulary: Establish a clear and consistent domain-specific terminology.
  • Use Case: When designing a new feature, use this Skill to thoroughly document how different user personas will interact with the system, including all potential deviations from the happy path, ensuring a robust design.

Quick Start

Use the shaping-writing-domain-scenarios skill to write domain scenarios for a new e-commerce checkout flow.

Frequently Asked Questions about shaping-writing-domain-scenarios

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

FAQPage Schema
How do I map user workflows and identify edge cases before development?

To map user workflows and identify edge cases, you need to generate comprehensive domain scenario documents that define personas, mental models, step-by-step actions, and exception paths. This process systematically uncovers potential failure points before building begins.

What is domain scenario modeling and when do I need it?

Domain scenario modeling is the process of defining personas, domain vocabulary, and core workflows to uncover complexities. You need it when designing a new feature to ensure a robust design by bridging the gap between understanding a problem and designing a solution.

How to write domain scenarios for a new feature like an e-commerce checkout flow?

To write domain scenarios, provide detailed input on personas, workflows, and potential failure points to produce structured markdown output. This output documents step-by-step actions, preconditions, postconditions, and domain-specific terminology for the checkout flow.

What do I need to generate domain vocabulary and exception paths?

You need detailed input on personas, workflows, and potential failure points to generate domain vocabulary and exception paths. The Skill requires this upfront information to produce structured markdown that establishes consistent terminology and documents deviations from the happy path.

Can I use domain scenarios for downstream UX and technical shaping?

Yes, you can use domain scenarios for downstream UX and technical shaping. The generated documents model user behavior and map workflows, providing the structured foundation needed to inform both user experience design and technical implementation.

What is the best way to document personas and mental models for workflow mapping?

The best way to document personas and mental models for workflow mapping is to generate a structured domain scenario document. This document defines user goals and frustrations alongside core workflows, ensuring all potential deviations are systematically probed and recorded.