Architectural Decisions Course

Lesson 1 • Decision Drivers and Constraints

Identifies the forces that shape decisions: business goals, quality attributes, and technical constraints. Students map drivers to decision outcomes.

Lesson 2 • Defining Architectural Decisions

Clarifies the boundary between architectural and non-architectural choices using scope, reversibility, and impact criteria. Grounds all subsequent decision analysis in a shared vocabulary.

Lesson 3 • Stakeholders and Their Concerns

Maps stakeholder roles to architectural concerns and shows how differing perspectives create decision tension. Prepares students to manage multi-stakeholder contexts.

Lesson 1 • Architecture Decision Records Overview

Introduces the ADR format as the primary documentation vehicle, covering its purpose and core fields. Connects documentation discipline to long-term maintainability.

Lesson 2 • Documenting Options and Trade-offs

Covers how to enumerate alternatives and capture their pros, cons, and trade-off rationale. Ensures decision records reflect genuine analysis rather than post-hoc justification.

Lesson 3 • Recording Rationale and Consequences

Teaches how to state the chosen option's rationale and its anticipated positive and negative consequences. Rationale transparency enables future teams to revisit decisions confidently.

Lesson 4 • Managing ADR Status and Supersession

Explains ADR status transitions and how to supersede outdated records without losing historical context. Keeps the decision log accurate as systems evolve.

Lesson 1 • Trade-off Analysis Methods

Introduces weighted scoring, cost-benefit analysis, and sensitivity analysis for comparing options. Students select the method that matches decision complexity and available data.

Lesson 2 • Risk-Based Option Evaluation

Frames each option's risks as evaluation criteria, using likelihood-impact mapping to surface hidden costs. Integrates risk thinking into standard option comparison.

Lesson 3 • Avoiding Evaluation Pitfalls

Identifies cognitive biases and process failures that distort option evaluation. Students apply bias-mitigation techniques to produce more objective assessments.

Lesson 4 • Prototyping and Spike-Based Evaluation

Covers when and how to use time-boxed prototypes or spikes to resolve critical unknowns before committing. Reduces decision uncertainty through targeted experimentation.

Lesson 1 • Structural and Decomposition Patterns

Covers layered, modular, and component-based decomposition patterns and their decision implications. Students match decomposition strategies to system complexity and team structure.

Lesson 2 • Distribution and Integration Patterns

Examines patterns for distributed systems, messaging, and service integration and their decision contexts. Prepares students to decide between synchronous and asynchronous integration approaches.

Lesson 3 • Adapting Patterns to Context

Teaches how to modify standard patterns when context deviates from the pattern's assumed forces. Prevents blind pattern application that ignores local constraints.

Lesson 4 • Data Management Patterns

Addresses patterns for data storage, access, and consistency and the decisions they encode. Students evaluate storage pattern fit against performance and consistency requirements.

Lesson 1 • Handling Constraint Violations

Provides techniques for detecting and resolving decisions that violate previously established constraints. Prevents architectural drift caused by unnoticed contradictions.

Lesson 2 • Decision Interdependency Concepts

Defines enabling, constraining, and conflicting decision relationships with concrete examples. Establishes the analytical lens used throughout this chapter.

Lesson 3 • Building a Decision Dependency Map

Guides students through constructing a visual map of decision dependencies for a given system. The map becomes a navigation tool for sequencing and validating decisions.

Lesson 1 • Visual Communication of Decisions

Covers diagrams, decision matrices, and dependency maps as visual aids for explaining complex choices. Visuals reduce cognitive load and accelerate stakeholder alignment.

Lesson 2 • Written Decision Summaries

Teaches concise written formats for decision summaries in project documents and wikis. Written clarity ensures decisions remain accessible to future team members.

Lesson 3 • Gaining Stakeholder Buy-In

Applies influence and negotiation techniques to secure commitment from resistant stakeholders. Students practise scenarios involving conflicting priorities and authority gaps.

Lesson 4 • Audience Analysis for Decision Communication

Identifies how stakeholder role, technical depth, and decision authority shape communication needs. Audience analysis drives all subsequent communication design choices.

Lesson 1 • Continuous Improvement of Decision Processes

Applies retrospective techniques to refine decision-making and governance processes over time. Students build feedback loops that raise decision quality iteratively.

Lesson 2 • Architecture Decision Boards

Covers the composition, authority, and operating model of decision review boards. Students define board charters that balance speed with rigour.

Lesson 3 • Architecture Governance Fundamentals

Defines governance as the set of processes ensuring decisions align with strategy and quality goals. Distinguishes governance from bureaucracy and frames it as an enabler.

Lesson 4 • Detecting and Correcting Architectural Drift

Teaches methods for identifying when implemented systems diverge from recorded decisions. Early drift detection reduces the cost of realignment.

Lesson 1 • Aligning Decisions with Business Strategy

Maps architectural decisions to business capability goals and strategic roadmaps. Students practise translating strategic intent into concrete architectural direction.

Lesson 2 • Evolutionary Architecture Decisions

Introduces fitness functions and incremental change strategies for architectures that must evolve safely. Students design decision frameworks that accommodate planned change.

Lesson 3 • Decision Portfolios and Roadmaps

Teaches how to manage a portfolio of open, committed, and deferred decisions as a strategic asset. Decision roadmaps align team effort with architectural priorities.

Lesson 4 • Measuring Architectural Decision Outcomes

Defines metrics for evaluating whether past decisions delivered their intended quality and business value. Outcome measurement closes the strategic decision loop.