Make sure you conduct an effective software architecture review by starting in the right direction. Before you kick off new projects, take a step back, and look at the big picture. How is your architecture currently performing, and how can you best improve its design? Use our template to guide your thinking as you review your architecture and plan the next steps.
How to use the software architecture review template
Step 1. Explain your current software architecture
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.
Step 2. Identify software quality issues
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.
Step 3. Develop software architecture review goals
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.
Step 4. Plan software quality improvements
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.
Atlassian is an enterprise software company that develops products for software developers, project managers, and content management.
AWS architecture diagram
Visualize your infrastructure to better identify weaknesses and pinpoint places for refinement.
Design your ideal workweek
Provide step-by-step guidance for completing a task.
Prepare your operations team to quickly respond to system alerts and outages.