Skip to content

Instantly share code, notes, and snippets.

What would you like to do?

Use Case: Name of Use Case


  • List of all actors involved in the use case
  • Each actor should be distinct
  • Generalize to User and System before getting specific
  • Refer to each actor exactly as listed here through the rest of the document


Provide a brief overview (~paragraph) of what the use case includes. Roughly equivalent to a user story or an epic.

Used Use Cases

  • List of Use Cases that this use case touches or relies on
  • Can also include the flow for the Used Use Case


  1. A list of conditions that must be true when the use case starts
  2. think of these as assumptions that must be true for the use case to start
  3. Classic example: "The User is logged in."


A list of conditions that must be true when the use case ends, regardless of scenario.

Primary Flow

Needs to be dead simple. List of primary flow(s) for the use case.

  1. Presented in Actor does Action format.
  2. Walks through the entire flow, start to finish.
  3. Should read very dry, not superfluous language.


  • Exceptions should be listed here, but may also provide a brief description.

Activity Diagram

An activity diagram of the flow of events, or some significant or complex part of the flow of events.

User Interface

Include storyboards / screen mocks

Sequence Diagrams

If you don’t have separate documents for Exceptions, you might include sequence diagrams for them here

Other Artifacts

This can include references to the subsystem the Use Case belongs to, an analysis model, a design model, code or test plans.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment