Skip to content

Examples ​

The same seven annotations describe products that look nothing alike. What changes is the meaning of subject, context, and responsibility. Usage, execution, and configuration stay the mechanism that keeps every variant understandable.

These six are modeled end to end. The first two are the setups a software house actually operates: a B2B product that is a little different for every customer, and a consumer finance suite where one person acts as several legal entities. The others use the same model for a large distributed platform, a monolith with several versions still in production, a physical product and its parts, and a fleet of devices.

ExampleSubjectContextResponsibility
B2B SaaSA business customerAn environment or instanceA module or service
B2C finance suiteA personThe legal entity they representA financial product
Distributed platformA marketA cellA service
Versioned monolithA major version still in productionA channel pinned to that versionA module inside the process
Physical productA product modelA trim, a plant, or a vehicleA subsystem or part family
Device fleetA siteA deviceA capability on the device

Each page has the catalog, the keys, one configuration story, and the questions the model answers on a normal day. Read Annotations first if the words are new, and How to model if you are about to name your own.

Released under the MIT License.