( this was Issue #6 of the Eventmodeling & Eventsourcing Weekly Mail )
Before you dive into this topic - there is a new Online Course âImplementing Eventsourcingâ, that will guide you step by step through this process. Find more details at the end of this article.
Today, weâre not recapping the last podcast episode. You can catch Episode 6 here. In that episode, we covered some fascinating topics from our recent workshop.
(More Workshops planned in January )
Instead, I want to share 7 insights Iâve learned since I started using Event Modeling back in 2021. These are practical âtricksâ to help you build better models. While you can learn Event Modeling in about an hour, true mastery requires hands-on experienceâmodeling several systems and seeing how it works in practice. You canât just read about it, much like writing good code. Building the âmuscle memoryâ takes time and effort.
Here are the 7 insights:
1. Use words from the business
If your Event Model doesnât reflect terms used by business expertsâespecially in the recorded Eventsâthatâs a red flag. It might mean youâre missing key concepts or obscuring them behind Read Models.
Be cautious about relying on Read Models to âhandle things.â Thatâs risky. Rule of thumb: Keep Read Models âdumbâ if possible. They should rely only on data from previous Events and avoid API calls or external data lookups.
To check if youâre missing important information, focus exclusively on the Events. Ask someone to tell the story using just the Events. If the narrative breaks, youâre likely hiding too much logic in the Read Models.
2. Donât hide processes behind commands
Teams often bury too much logic in Commands and Command Handlers, especially early on.
How to spot this: If a Command triggers multiple Events (e.g., three or more), it might indicate a hidden process in the Command Handler. While not definitive, itâs a clear warning sign.
3. Intentionally create âbadâ screens
Donât waste time designing polished UI mockups during Event Modeling sessions, even if UX experts are involved. Remember: good UX isnât about beautiful UI ( at least not only )
Focus on capturing the information flowâwhat data gets captured and how. The specific UI controls (radio buttons vs. dropdowns) donât matter at this stage.
I deliberately design âuglyâ screens in every Event Model I work on. It reinforces that appearance isnât the priority.
4. Shut down your system
When debating if something is an Event, ask yourself:
âIf we shut down the system now and rebooted it, would this information be necessary or useful to continue?â
This simple exercise often clarifies whether an action is truly an Event. For example, a âUser Logged Inâ Event might not matter after a reboot, as users will need to log in again anyway.
5. Be explicit
Donât rely on assumptionsâmake everything explicit. A well-crafted Event Model should be clear enough for someone from another team to understand how the system works.
Dig into the details, even when itâs uncomfortable. Avoid skipping steps like âGiven / When / Thenâ just because you think you understand how it works. Build every Read Model step-by-step, mechanically.
6. Keep the story simple
Every information system follows the same basic âwave structureâ:
- An action occurs.
- It results in an Event.
- That Event triggers the next action, and so on.
Your system should flow like a continuous wave. Focus on one use case at a timeâavoid loops or conditions. The best Event Models are straightforward and can be read left-to-right by both business users and developers.
7. Donât split boards too early
Itâs tempting to optimize your boards by splitting them too soon. Resist this urge. Itâs okay to have multiple models on a single boardâjust ensure theyâre clearly separated.
I use âModel Contextsâ to organize multiple models and navigate between them easily. Keep your Event Models accessible, fast, and well-structured so you can quickly move between slices, chapters, and models.
Thatâs itâ7 practical tips to help you build better Event Models starting today.
Thank you for subscribing to this newsletter. I truly appreciate your support!
Hope you found these tips helpful! Let me know which one resonates most with you.
What else happened this week?
A new chapter of the Understanding Event Sourcing book was published! It covers âEventsourcing & User Interfacesâ.
Join the Agentic Engineer Program
Apply Spec-Driven Development Hands-On - Event Modeling, Event Sourcing, and AI Engineering with autonomous agents.
Book a Call Today
Want to talk through how Event Modeling could work for your team or project? Letâs have a quick, no-pressure conversation.
