Skip to main content

Use Case: [Title]

Type: Canonical Use Case
ID: UC-XXX
Created: [YYYY-MM-DD] (Design Phase)
Status: Active
Domain: [Framework/Component/Pattern]

Summary​

[One sentence description of the use case]

Context​

When to Use:

  • [Scenario 1]
  • [Scenario 2]

When NOT to Use:

  • [Anti-scenario 1]
  • [Anti-scenario 2]

Use Case Description​

Actor: [Who/what uses this]
Goal: [What they want to achieve]
Preconditions: [What must be true before]
Postconditions: [What is true after]

Main Flow:

  1. Step 1
  2. Step 2
  3. Step 3

Alternative Flows:

  • Flow A: [Description]
  • Flow B: [Description]

Design Rationale​

Why This Use Case:

  • [Reason 1]
  • [Reason 2]

Design Decisions:

  • [Decision 1]
  • [Decision 2]

Implementation​

Related Work:

  • Epic: [Epic X]
  • Story: [Story Y]
  • Tasks: [Task references]
  • FR/BR: [Related FR/BR]

Implementation Status:

  • Designed
  • Implemented
  • Validated
  • Documented

Examples​

Example 1: [Description]

  • [Link to example]

Example 2: [Description]

  • [Link to example]
  • [Related canonical use case]
  • [Related discovered use case]

References​

  • [Design documents]
  • [Implementation docs]
  • [Related documentation]

Template Usage:

  • Copy this template when creating a canonical use case
  • Fill in all relevant sections
  • Update the Canonical Use Cases Index
  • Wire to related BR/FR, Tasks, and documentation

This template is part of the Use Cases Knowledge Base. See docs/use-cases/USE_CASE_METHODOLOGY.md for methodology.