Architecture Review - CRs-existing Projects
Architecture Review - CRs-existing Projects
[Note: The following template is provided for use with the Unified Architecture Method. Text enclosed in
square brackets and displayed in blue italics (style=InfoBlue) is included to provide guidance to the
author and should be deleted before publishing the document. A paragraph entered following this style
will automatically be set to normal (style=Body Text).]
Executive Summary
[This is a one-page reiteration of the key objectives for the assessment and a summary of the most
important findings and recommendations.]
Scope
Review Participants
[List the individuals who will participate in the review and their roles during the meeting; for example,
moderator, note-taker, reviewer, author. ]
Overall Architecture
[Identify the high–level architectural concerns regarding areas such as:
High–level Architecture
o Topology and scalability structure/patterns issues
o Communication structure/patterns issues
o Persistence structure/patterns issues
o Fault tolerance and redundancy issues
o Security solutions structure/patterns issues
o User experience and GUI structure/patterns issues
o Integration of hardware and hardware dependencies
o Integration of software and software dependencies]
Strengths – Identify the strengths of the architecture and how the can be related to the
architecture concerns.
Issues – Identify which topics are subject to further investigation; for all issues a plan needs to be
defined with assigned tasks and responsibilities.]
Information Architecture
[Document the architecture recommendations and findings. New Architectural Decisions (ADs) found in
the review must be referenced here.]
Strengths
[Describe the positive findings of the assessment. Rank them from most significant to less significant.]
Issues
[Describe issues identified during the evaluation. Rank them from most severe to less severe. Use the
following structure for consistency:
Issue Give the issue a name
Describe the nature of the issue and its consequences
Propose an approach to addressing the issue
Provide references to the information sources
Also see the architecture review checklist]
Recommendations
[During team discussion, recommendations need to be collected that might help the project at a later
date, or are optional in the given context. The report should be concise. If there is an issue that needs an
extended discussion, such discussion should be moved to the Appendixes section. Hence, the
recommendations should be short and to the point.]
Action Plan
[Certain problems or anomalies may be discovered for which a course of action cannot be agreed on by
the review team, and which needs to be escalated for resolution.]
Follow-up Review
[Describes the review team's recommendations for follow-up (for example, whether another review is
necessary) and what, if any, additional information or data is needed.]