Skip to content
/ caseum Public

Caseum software architecture method


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



58 Commits

Repository files navigation

Caseum logo


Caseum is a simple approach to software architecture that combines multiple views to boost understanding and empathy across roles.

Video introduction


(watch on YouTube, slides)

Multiple views

Caseum combines these views:

  • Components using C4
  • Actors using roles
  • Stories using Gherkin
  • Events using event storming
  • UI using wireframes
  • Models using TLM

Several screenshots of architecture views

Together these views fully describe a software system.

Not all projects need all views.

Lightweight approach

Caseum is for doing just enough architecture. It has three stages:

  1. whiteboarding & dialogue
  2. digital diagrams & decision records
  3. models as code & executable specifications

Not all projects need all stages.

See the guide on stages of architecture. See the guide on as-is and to-be designs for working on existing projects.

Recording decisions

Screenshot of a slack channel being used to record decisions

Architecture records the important design decisions for a system. The records are for communicating with current and future people working on and with the software.

See the guide on recording decisions.


Partial Type-Link-Model diagram

The primary tools used by Caseum are:

  • Whiteboards, markers, and sticky notes
  • for digital diagrams
  • Markdown text files for decision records
  • Model specification in structured text formats (Structurizr C4, Gherkin, TLMD and AsyncAPI JSON)

See the guides on whiteboarding architecture and on using for architecture.

Different tools are available per view per stage:

Whiteboarding & Dialogue Diagrams & Decision Records Models & Executable Specifications
Components Boxes & lines C4 Library C4 as Code
Actors Roles & needs Role Markdown Template -
Stories Goals & epics User Story Markdown Template Gherkin
Events Event Storming ES Library AsyncAPI
UI Boxes & lines Wireframes Library -
Models Circles & lines TLM Library TLMD


Creative Commons LicenseCaseum by Leo Simons is licensed under a Creative Commons Attribution 4.0 International License.

See LICENSE.txt for a plain text copy of the Creative Commons Attribution 4.0 International License.


See for details on how to contribute to Caseum.

Code of conduct

See Code of Conduct for details on how to participate in the Caseum community.