Skip to main content

Canonical Use Cases

Purpose: Design-phase use cases identified during architecture and design planning
Location: docs/architecture/use-cases/
Type: Canonical (planned, designed before implementation)

Overview​

Canonical use cases are design-phase use cases that are:

  • Planned and intentional
  • Part of original design/architecture
  • Documented before implementation
  • Stable and well-defined
  • Part of framework/product design

These use cases inform system architecture, requirements engineering, and design decisions.

Quick Navigation​

Use Case Types​

Canonical Use Cases (This Directory)​

Location: canonical/

Definition: Use cases identified and documented during the design/planning phase, before implementation.

Characteristics:

  • Planned and intentional
  • Part of original design/architecture
  • Documented before implementation
  • Stable and well-defined
  • Inform architecture and design decisions

Examples:

  • Framework adoption patterns
  • Workflow execution patterns
  • Versioning patterns
  • Kanban organization patterns

Creating Canonical Use Cases​

  1. Use CANONICAL_USE_CASE_TEMPLATE.md
  2. Create in Canonical/ directory
  3. Follow naming convention: UC-XXX-[title].md (UC implies canonical)
  4. Update Canonical/README.md index
  5. Link to related architecture documents and design decisions

This section is part of Architecture documentation. Canonical use cases inform system design and architecture decisions.