Software architecture review template

by Atlassian

Map out your software architecture and review your software quality

KEY FEATURES
Analysis
Documentation
Task Planning

CATEGORIES

Software & IT
Recommended
Page template

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 1. Explain your current software architecture

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 3. Develop software architecture review goals

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.

Related Templates

AWS architecture diagram

AWS architecture diagram

Visualize your infrastructure to better identify weaknesses and pinpoint places for refinement.

By Lucidchart
Learn more
DevOps runbook

DevOps runbook

Prepare your operations team to quickly respond to system alerts and outages.

By Atlassian
Learn more
AWS architecture diagram

AWS architecture diagram

Visualize your infrastructure to better identify weaknesses and pinpoint places for refinement.

By Lucidchart
Learn more
DevOps runbook

DevOps runbook

Prepare your operations team to quickly respond to system alerts and outages.

By Atlassian
Learn more
Design your ideal workweek

Design your ideal workweek

Provide step-by-step guidance for completing a task.

By Atlassian
Learn more