Rein Henrichs: The Real Work of Maintenance Happens Before You Touch the Code
Get the full intelligence
Search transcripts, export clips, track mentions, and explore all topics from “Rein Henrichs: The Real Work of Maintenance Happens Before You Touch the Code” inside PodZeus.
In this episode of Maintainable, host Robbie interviews Rain Henricks, a principal software engineer at Procore, about the often-overlooked mental and organizational work behind sustainable software maintenance. Henricks introduces the 'line of representation' model—inspired by resilience engineering and Plato's Cave—to illustrate how software teams interact with systems through shared mental models rather than direct access to the underlying code. He emphasizes that well-maintained software isn't just about clean code, but about a shared understanding, or 'common ground,' among team members. This includes mutual predictability of actions, especially during incidents, where clear communication and structured coordination (like incident command protocols) prevent chaos. Henricks also discusses the importance of weak signals—subtle indicators of systemic issues—that teams often ignore due to time pressure, and how these signals are critical for long-term maintainability. He advocates for cultivating 'adaptive capacity' through sensemaking, epistemic delegation, and continuous learning, rather than relying solely on measurable metrics. The conversation concludes with a call to prioritize human judgment, team health, and organizational learning over rigid processes and false certainty.
Well-maintained software is defined by shared understanding, not just clean code.
Use the 'line of representation' model to recognize that teams work through mental models, not direct system access.
Incident response should prioritize disturbance management (restoring service) over immediate root cause fixes.
Weak signals—subtle, ambiguous indicators—should be treated as early warnings of deeper systemic issues.
Adaptive capacity, not just SLOs or metrics, is the real measure of resilient software teams.
…and 3 more takeaways available in PodZeus
The Hidden Work of Software Maintenance
Robbie introduces the podcast and guest Rain Henricks, setting the stage for a deep dive into the non-technical, cognitive aspects of software maintenance. The episode begins with the premise that software quality isn't just about code—it's about shared understanding.
The Line of Representation: Plato's Cave in Software
“We don't actually directly interact with the system itself. We interact with our understanding of the system through what's called representation.”
Common Ground and Shared Situational Awareness
“If you're going to act on the system in a way that might change it, you have to let us know and get a confirmation before you do that.”
Weak Signals and the Limits of Measurement
“One of the weak signals that's interesting for software maintenance is that our understanding, our clarity about how a system works doesn't improve over time.”
Adaptive Capacity and the Role of Human Judgment
“Adaptive capacity refers to our ability to respond to unexpected surprises. And it refers to the capacity we have as humans to change the system in ways that maybe we haven't thought of yet.”
“The real work of maintenance happens before you touch the code.”
“Adaptive capacity refers to our ability to respond to unexpected surprises. And it refers to the capacity we have as humans to change the system in ways that maybe we haven't thought of yet.”
“It is wrong to suppose that if you can't measure it, you can't manage it. A costly myth.”
Host
Guest
Rain Henricks
person
Robbie
person
Procore
organization
AppSignal
organization
Jerry Weinberg
person
Heidi Heflin
person
Kent Beck
person
Sidney Decker
person
Obi Fernandez
person
Planet Argon
organization
Get the full intelligence
Search transcripts, export clips, track mentions, and explore all topics from “Rein Henrichs: The Real Work of Maintenance Happens Before You Touch the Code” inside PodZeus.
Start discovering podcast insights today
Start with a 7-day trial and explore a growing catalog of popular podcasts. No credit card required.
No credit card required • 7-day trial • Cancel anytime
