How do you discuss tech health in your team? How do you do so in an objective way that supports prioritisation?
And how do you raise awareness on an organisational level?
This is a simple template that aims to help on that topic. It consists of 2 parts:
- A service assessment part.
- An aggregated view of the services' assessments in an organisation.
The service assessment part is supposed to be a self-assessment from the team that owns it. They will discuss a few tech health aspects of their service and give them a rating. One recommendation here is to have a "perfect service" assessed as reference, to both help guide the team during their discussions and to provide some level of consistency in how teams are working with these aspects. Consider bringing in an experienced engineer or manager to further facilitate these discussions, questions the team might have, and potential action points.
The aggregated view part should be straightforward, and show the different teams' assessments together. It can help get a quick feel for the overall picture, highlight patterns and support prioritisation.
You don't need to do it for all your services, as it can be too much work. Focus on what you believe are your most important ones.
Template created in Google Sheets: https://docs.google.com/spreadsheets/d/1S7EWIsP1HM_8UdH-HnmDYrcw4HGEyUkr7USKygThsmA
Adapt it to your context and needs, and Godspeed!
This project is distributed under the MIT License.