Skip to main content

Use Case: [Title]

Type: Discovered Use Case
ID: UC-D-XXX
Discovered: [YYYY-MM-DD]
Status: Active
Domain: [Framework/Component/Pattern]

Summary​

[One sentence description of the discovered use case]

Discovery Context​

How Discovered:

  • [What work revealed this]
  • [What problem it solved]
  • [What pattern emerged]

Discovered During:

  • Work: [Task/BR/FR reference]
  • Date: [YYYY-MM-DD]
  • Context: [What was being worked on]

Pattern Recognition:

  • [What pattern was recognized]
  • [Why it's valuable]
  • [How it differs from original design]

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]

Discovery Rationale​

Why This Pattern Emerged:

  • [Reason 1]
  • [Reason 2]

Gap in Original Design:

  • [What wasn't covered]
  • [What this fills]

Lessons Learned:

  • [Lesson 1]
  • [Lesson 2]

Implementation​

Related Work:

  • Task: [Task that discovered it]
  • BR/FR: [Related BR/FR]
  • Documentation: [Documentation created]
  • Epic/Story: [Related Epic/Story]

Wiring:

  • [Links to related BR/FR, Tasks, documentation]
  • [Ensure bidirectional links]

Implementation Status:

  • Discovered
  • Documented
  • Wired to related work
  • Validated
  • Promoted to Canonical (if applicable)

Examples​

Example 1: [Description]

  • [Link to example]

Example 2: [Description]

  • [Link to example]

Promotion to Canonical​

Promotion Criteria:

  • Widely applicable across projects
  • Validated through multiple uses
  • Represents best practice
  • Should be part of framework design

Promotion Status:

  • Not yet promoted
  • Under consideration
  • Promoted to UC-XXX

Promotion Notes: [If promoted, document when and why]

  • [Related canonical use case]
  • [Related discovered use case]

References​

  • [Work that discovered it]
  • [Documentation created]
  • [Related BR/FR]

Template Usage:

  • Copy this template when creating a discovered use case
  • Fill in all relevant sections
  • Wire bidirectionally to related work
  • Update the Discovered Use Cases Index
  • Consider promotion to canonical if applicable

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