a toolbox of techniques for

software archi tecture reviews

jason baragry

@jbaragry

ad-hoc

reviews

@jbaragry

essential problem

“Identify the forces on the system

Grok the system’s essential architecture.

Generate scenarios that exercise the relevant forces against the architecture.

Throw the essential architecture against those scenarios, then evaluate how they land relative to the relevant forces.

Wash, rinse, repeat”

- Grady Booch

@jbaragry

@jbaragry

active design reviews

. take an active stance

. plan in advance

. ask open questions

plan your review

software

architecture review

and assessment

(SARA) report

@jbaragry

@jbaragry

structure of an

architecture review

@jbaragry

structure of an

architecture review

@jbaragry

structure of an

architecture review

@jbaragry

structure of an

architecture review

@jbaragry

structure of an

architecture review

@jbaragry

structure of an

architecture review

evaluation criteria

. system qualities

. experience

. scenarios

. checklists

. architecture smells

@jbaragry

identify and

prioritise

system

qualities

@jbaragry

@jbaragry

plus: http://en.wikipedia.org/wiki/List_of_system_quality_attributes

scenarios

. (mini) quality

attribute workshops

. testable

. benefit/cost

@jbaragry

checklists

. group by qualities

. open questions

@jbaragry

@jbaragry

methods and

techniques

. scenario based

. experience based

. quality specific

scenario based methods

@jbaragry

. architecture tradeoff

and analysis method

(ATAM)

. lightweight architecture

alternative assessment

method (LAAAM). scenario-based

ATAM design peer

review

experience based

methods

@jbaragry

. tiny architectural

review approach

TARA

. siemens ”experience-

based reviews”

quality focused methods

. maintainability: ALMA

. sustainability: MORPHOSIS

. performance: CPASA

. code metrics: cyclomatic complexityafferent and efferent coupling

. formal correctness: TLA+

. security: OWASP, BSIMM, STRIDE,DREAD

@jbaragry

pragmatics and

people issues

@jbaragry

in-house /

scheduled

in-house /

triggered

external /

scheduled

external /

triggered

tool selection and customisation

Amount of Ceremony

∝Consequence of Loss +

Difficulty of Communication

@jbaragry

source: Alistair Cockburn on Agile Methods:

http://alistair.cockburn.us/People+and+methodologies+in+software+development

using the toolbox for reviews

. take an active stance

. plan the review and adapt as needed

. work through system qualities

. develop the scenarios or checklists for those qualities

. choose a scenario- or experience-based method

. customise the appropriate level of ceremony

. identify the people issues and adjust

@jbaragry

using the toolbox for design

test driven architecture

. use quality attributes and test

criteria early in the project

. product owners also own quality

. user stories, acceptance criteria

or architecture reviews

@jbaragry

@jbaragry

more detail

. swarchitectonics.blogspot.no

or

. miles.no/blogg

references

• Booch on Architecture Reviews (Booch2010)

• Industry study of how people use arch review techniques (Babar2009 [pdf])

• Active Design Reviews (Parnas1985 [pdf])

• ISO/IEC 25010 standard for software product quality

• SARA Report (Obbink2002, [pdf])

• Quality Attribute Workshop

• Mini Quality Attribute Workshop (and presentation video)

• ATAM method

• LAAM (Lightweight Architecture Alternative Assessment Method)

• ATAM Peer Review

• TARA (Tiny Architectural Review Approach)

• Experience-based Reviews

• TOGAF Architecture Compliance Checklists

• Stackoverflow architecture checklist questions

@jbaragry

image attribution

• Title Slide / Todd Quackenbush / Creative Commons

• Essential Problem / Republica / Creative Commons

• Toolbox outline / freegr / Creative Commons

• Hammer / BenjaminNelan / Creative Commons

• Ruler / Jeff Sheldon / Creative Commons

• Plan / Ales Krivec / Creative Commons

• Evaluation Techniques/ Ales Krivec / Creative Commons

• Quality Focussed / Alan / Creative Commons

• Tool selection / Stux / Creative Commons

• Toolbox / Florianric / Creative Commons

• More Detail / Mike Kenneally / Creative Commons

• Pragmatics / grisbonn1974 / Creative Commons

• Test driven architecture / Lee John Phillips / The Shed Project

@jbaragry

FAGLIG AUTORITET OG VARME

@jbaragry