Software architecture review template

Set the stage for your review by detailing how your architecture currently performs. Start by using diagramming software to illustrate the overall structure of your architecture, and make a point to explain how the components of your architecture work together. Once you’ve mapped out your architecture, add an image of the diagram to the template.

Once you’ve diagrammed your architecture, you’re ready to start assessing its performance. Use the template to list issues with your current architecture and explain how they affect your business or customers. As you think through these problems, you can add comments and @ mention team members to collaborate and exchange feedback.

Before you conduct an extensive architecture review with your team, make sure you’re aligned toward a common goal. Use this space to select the software quality attributes that are most important to your team and business. This will help focus your strategy when you review your architecture and plan new projects. As your team brainstorms architecture improvements, use diagramming software to explain your ideas and add an image of your results to the template.

With a clear vision of how to improve your architecture, use the template to plan the next steps. Prioritize proposed projects and estimate the time, work, and resources needed to complete them. Then use the template to organize Jira tickets and schedule release dates.