Chapter 45 — Independent design review

Chapter 45 — Independent design review

Lesson map

Lesson 45 published. Map, example, EX133.

flowchart TD
  N0["Learning outcomes"]
  N1["45.1 Preparing for review"]
  N2["45.2 Responding to findings"]
  N3["45.3 Reviewing others"]
  N4["Synthesis"]
  N0 --> N1 --> N2 --> N3 --> N4
  N4 --> EX["Worked example"]
  EX --> Q["Exercise EX133"]

Logical drawing

flowchart LR
  N0["Learning outcomes"]
  N1["45.1 Preparing for review"]
  N2["45.2 Responding to findings"]
  N3["45.3 Reviewing others"]
  N4["Synthesis"]
  N0 --> N1 --> N2 --> N3 --> N4 --> Q["EX133"]

[Learning outcomes]
    |
    v
[45.1 Preparing for review]
    |
    v
[45.2 Responding to findings]
    |
    v
[45.3 Reviewing others]
    |
    v
[Synthesis]
    |
    v
[Worked example] --> [Exercise EX133]

Learning outcomes

You will (1) prepare a design for independent review; (2) respond to review findings; (3) review another student's design constructively.

45.1 Preparing for review

Sofia submits her capstone design package to an independent reviewer, a senior architect from another transit operator, under a confidentiality agreement. She includes a reading guide stating the scope, key decisions, known open issues and specific questions she wants examined, such as whether her replay-detection design holds at peak load. Guiding the reviewer makes the review more useful: an unguided reviewer may spend hours on minor diagrams while missing the decisions that matter most. She also lists what is out of scope so the reviewer does not assume it was forgotten.

45.2 Responding to findings

The reviewer returns twelve findings: one critical, four major and seven minor. The critical finding is that dispute handling lets agents adjust fares without a second approval above a threshold, repeating a pattern seen in chapter 14. Sofia fixes it with a dual-approval rule and new tests. For one major finding, about log retention, she disagrees and explains why with reference to the privacy requirements; the reviewer accepts the explanation. She records every finding, response and evidence in a table. Responding well means fixing what is right and arguing respectfully where she has evidence.

45.3 Reviewing others

Sofia also reviews a classmate's capstone on depot access control. She uses the same approach she valued: read the guide, focus on key decisions, classify findings by severity and suggest fixes. She finds that badge revocation depends on a nightly batch, leaving a day-long window for dismissed staff. She phrases the finding with the scenario, the impact and a suggested improvement, avoiding judgemental language. Reviewing teaches as much as being reviewed, because it trains her to see her own designs through a sceptical outsider's eyes.

Worked example

Sofia guides an external reviewer, fixes a critical dual-approval gap, argues one major finding with evidence and reviews a classmate's depot access design.

Synthetic case. Reviewers, findings and the classmate's design are synthetic.

Errors and limits

One reviewer has blind spots; important designs benefit from several. Disagreements need evidence, not seniority.

Exercises

• EX133 — Reading guide. What does Sofia's reading guide include? Rubric: 3 = scope, key decisions, open issues, specific questions, out-of-scope items;; 2 = three;; 1 = vague;; 0 = none.
• EX134 — Critical finding. What was the critical finding and its fix? Rubric: 3 = agents adjusting fares without second approval; dual approval above threshold;; 2 = both;; 1 = vague;; 0 = none.
• EX135 — Classmate finding. What weakness did Sofia find in the classmate's design? Rubric: 3 = nightly batch revocation leaves day-long access for dismissed staff;; 2 = batch;; 1 = vague;; 0 = none.

Synthesis

Independent review is most valuable when guided, answered with fixes or evidence and practised in both directions.

Continue studying — chapter 45 of 50

← Chapter 44 (draft) · Course chapter index · Chapter 46 (draft) →