This task describes how to organize an architectural review, to ensure the review is effective and productive, and to ensure that actions are agreed, assigned and tracked.
Purpose
An architectural review is carried out to ensure that the models are complete and well-defined, and to ensure that the
business is accurately captured in the models.
This task is focused on organizing a review of the Logical Perspective of the IT architecture. Appropriate
materials are gathered, venues booked and participants informed. The review focuses on the generated architecture, ensuring
that it is complete and consistent, which is normally a peer review. Alternatively the review may focus on the content of
the architecture in terms of how accurately it captures the business, which normally involves a number of stakeholders that
have intimate knowledge of the area of the business in question and its systems.
Steps
Decide on Objectives
Decide on the focus of the review:
Peer Review - ensuring that the IT architecture is complete and consistent (usually done
first, prior to a stakeholder review);
Stakeholder Review - the IT architecture is reviewed to ensure it accurately captures the business
(i.e. experts and stakeholder review).
The first type of review is focused on ensuring the models are clear, and complete—participant are technical and
typically peers of the IT architect that created the IT architecture under review. This type of review is done after
completion of a perspective (all iterations) and prior to a stakeholder review.
The second type, a stakeholder review, is focused on the content to ensure it captures the business and that it meets
the requirements as defined by stakeholders (both business and technical), therefore there are various experts involved
(i.e., business, but more technical experts at the Logical and Technical levels) along with the other stakeholders for
the IT architecture.
The primary objective for a peer review is to ensure the IT architecture is complete, consistent and fits in with the
enterprise's environment. A stakeholder review is focused on the solutions, decisions defined, and the meeting of
requirements. Also part of this step is to define the list of required participants in the review.
Gather Required Information
The architect or review manager will gather information about the IT architecture to be reviewed, as indicated in
the mandatory and options inputs to this task. For example, for reviewing a technology level architecture,
the following information will be of use:
The Technical Perspective documentation for the IT architecture to be reviewed;
Project and business plans and objectives;
Existing network logical and physical design;
Existing databases and database design;
Existing server environment (configuration, software versions, planned upgrades);
Existing standards (network, naming, protocols, and so on).
These documents should be collated and made available to those participating in the review.
Inform Attendees
Each attendee is given sufficient notice about the review, and what is expected of them in terms of both
preparatory work and their involvement in the review process. Make it clear to each attendee what stakeholder they are
representing and therefore the type of review critique and feedback expected from them. As general guidance, you should
consider the following stakeholders when inviting attendees to participate in the review meetings:
Direct users of the 'system', and also testing and documentation staff;
Domain or subject-matter experts for the system;
Peers: other IT architects or IT experts with experience in the domain or technology;
Managers: of the system or technology involved.
Include only those participants who will contribute to achieving the objectives of the review. In general, it is
usually more productive to hold several focused review sessions with a smaller number of participants, than to hold one
review involving many.
Properties
Multiple Occurrences
Event Driven
Ongoing
Optional
Planned
Repeatable
Usage Guidance
At the Logical level the review is more focused on the solutions defined but also that the solutions do still meet business
needs. The architecture is also reviewed to ensure that it is complete and well-defined. Most participants are
therefore technical experts, but also with business experts, and other stakeholders at the business level participating to
ensure business needs are met.