writing-use-cases

Write and review use cases with templates, granularity rules, and checklists.

2|Updated Sep 25, 2011
One-click install
npx skills add https://github.com/pokutuna/dotfiles --skill writing-use-cases-pokutuna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-use-cases
Source: https://github.com/pokutuna/dotfiles/tree/main/claude/skills/writing-use-cases
Command: npx skills add https://github.com/pokutuna/dotfiles --skill writing-use-cases-pokutuna

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing use cases that stakeholders can confirm and developers can implement is hard: scenarios mix levels, branch logic clutters the main flow, and failure handling gets lost. This Skill structures use case authoring and review based on Alistair Cockburn's Writing Effective Use Cases. ## Core Features & Use Cases - Full and brief templates: Provides complete and casual use case formats with per-field guidance on what to write and what to avoid. - Level and granularity judgment: Distinguishes summary, user-goal, and subfunction levels so scenarios stay at 3-9 steps and one actor's goal. - Extension notation rules: Explains when to use step-specific (2a), ranged (2-5a), and global (*a) extensions, and how to separate extensions from technical variations. - Discovery workflow: The references include an actor-goal list method for enumerating multiple use cases before detailing them, plus a review checklist and a worked order-confirmation example. - Use Case: When asked to organize requirements for an e-commerce checkout, produce an actor-goal list first, then detail the selected use case with main success scenario, extensions, and guarantees. ## Quick Start Ask the assistant to write a use case for confirming an order in an e-commerce system, including the main success scenario and failure extensions.

Frequently Asked Questions about writing-use-cases

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

FAQPage Schema
How do I write a use case main success scenario?

Write the main success scenario as a single straight path of 3-9 steps from trigger to success guarantee, with each step starting from an actor or the system. Keep branches, failures, and cancellations out of it and move them into extensions.

What is the difference between use case extensions and variations?

Extensions cover conditions that change behavior or outcomes, such as stock shortages or timeouts. Technical and data variations cover cases where behavior stays the same but the implementation method differs, such as alternate connection protocols.

How do I decide the right granularity for a use case?

Aim for the user-goal level: one person achieving a goal in one sitting within a few minutes, ending with a verifiable result. If steps grow long, ask why each step exists and consider merging subfunctions or splitting reusable parts into separate use cases.

When should I use the brief format instead of the full template?

Use the brief format for requirements discovery, estimation, and closely communicating teams, keeping goal, scope, level, actor, summary, key extensions, and open issues. Use the full format when the document feeds agreement, implementation, and testing.

How do I discover all use cases for a system before writing details?

Start with an In/Out list to fix scope, enumerate primary and supporting actors, then build an actor-goal list organized by summary, user-goal, and subfunction levels. Review that list for gaps and duplicates before detailing selected use cases.