The Foundation & Systems Thinking

Introduction: The Physics of Decision Making

What Is Reasoning by Analogy?

What Is First-Principles Reasoning?

The Chef vs. The Cook

Cargo Cult Engineering

The First-Principles Algorithm

When to Use Each Mode

Common Pitfalls and Misconceptions

Introduction: The Detective vs. The Bystander

The "Last Changed Thing" Bias

Correlation Does Not Imply Causation

Building Causal Reasoning Skills

Applying Causal Reasoning to System Design

Introduction: The Velocity Trap

The Two-Way Door (Type 2 — Reversible Decisions)

The One-Way Door (Type 1 — Irreversible Decisions)

The Spectrum — Not a Binary

Techniques to Convert Type 1 Decisions into Type 2

Determining Approval Thresholds

Introduction: The Missing "Why

The Architectural Decision Record (ADR)

The Anatomy of an ADR

Managing ADR Lifecycle and Status

Tooling for ADRs

Request for Comments (RFCs)

The Anatomy of an RFC

ADRs and RFCs in Practice — Organizational Patterns

Introduction: The "Pick Any Two" Reality

Defining the Three Constraints

The Trade-off Dynamics

Consciously Choosing What to Sacrifice

The Pressure Valve — Feature Freezes and Error Budgets

The Iron Triangle in DevOps and Platform Engineering

Introduction: There Are No Solutions, Only Trade-offs

The Anatomy of a Trade-off

Trade-off 1: Simplicity vs. Flexibility

Trade-off 2: Buy vs. Build vs. Open Source

Trade-off 3: Vendor Lock-in Risk Assessment

Trade-off 4: Speed vs. Reliability (Move Fast vs. Don't Break Things)

Reversibility: The Hidden Dimension of Every Trade-off

Building a Trade-off Analysis Framework

Introduction: Engineering is a Gamble

The Risk Formula — Likelihood × Impact

Risk Registers — Your Living Inventory of Threats

Value at Risk (VaR) in Engineering Terms

Risk Matrices and Heat Maps

The Four Risk Response Strategies

Failure Mode and Effects Analysis (FMEA) for Systems

Preparing for Black Swans

Introduction: The Big Bang Myth

The Strangler Fig Analogy

The Three Phases of Strangler Fig Migration

Step 1: Event Interception (The Proxy)

Choosing What to Strangle First

The Hardest Part: Data Synchronization

Data Sync Strategy 0: Shared Database (Transitional)

Data Sync Strategy 1: Dual Writes

Data Sync Strategy 2: Change Data Capture (CDC)

Step 2 & 3: Traffic Shifting and Strangling

Anti-Patterns and Failure Modes

Introduction: From Linear to Circular

Building Blocks: Stocks and Flows

Delays: The Hidden Saboteur

Feedback Loop 1: Reinforcing (The Snowball)

Feedback Loop 2: Balancing (The Thermostat)

Archetypes: Common System Patterns

The Cobra Effect: Unintended Consequences

Finding High-Leverage Points

Introduction: One Size Does Not Fit All

Ordered vs. Unordered Systems

The Four Domains of Cynefin

The Cliff: Complacency and Catastrophic Collapse

Fail-Safe vs. Safe-to-Fail

Applying Cynefin to DevOps and Platform Engineering

Introduction: The Bug in the Brain

Normalization of Deviance

Confirmation Bias

The Sunk Cost Fallacy

Hindsight Bias

Survivorship Bias

Anchoring Bias in Estimation

Introduction: You Are Spending Money

Total Cost of Ownership (TCO)

CAPEX vs. OPEX Mental Models

Opportunity Cost in "Build vs. Buy

The Cost of Coordination (Brooks's Law)

Unit Economics for Infrastructure

FinOps — Engineering Meets Finance

Introduction: Why Naming the Beast Matters

Bohrbugs — The Deterministic Failures

Heisenbugs — The Observer-Dependent Failures

Mandelbugs — The Deeply Complex Failures

Schroedinbugs — The Bugs That Shouldn't Have Worked

Software Rot (Bit Rot)

Anomalies in Distributed Systems

Introduction: Geography for Strategy

The Problem Strategic Visualization Solves

Wardley Mapping — The Two Axes

Reading a Wardley Map — Movement and Gameplay

SWOT Analysis for Technology Decisions

Combining Wardley Maps and SWOT

Introduction: Process Serves the Work

Waterfall: The Predecessor You Must Understand

The Methodologies: Agile, Scrum, Kanban

Estimation: Story Points, T-Shirt Sizing, and the #NoEstimates Debate

Roles: Product Manager (PM) vs. Engineering Manager (EM)

Ticket Hierarchy: Epics, Stories, Tasks

Meetings That Matter: Running Effective Ceremonies

Introduction: The Vector of the Ship

KPIs: The Dashboard of Organizational Health

OKRs: The Engine of Deliberate Change

Wartime vs. Peacetime Leadership

The Quarterly Cycle

Connecting Strategy to Daily Engineering Work

Introduction: Buying the Car

The Due Diligence Process & Data Room

The Tech Stack Audit

Finding "Tech Debt Bombs

Integration Risks: Culture Clash

The TDD Findings Report

Introduction: Code is Law

Privacy by Design (GDPR/CCPA)

Dark Patterns in UX

Accessibility as an Ethical Imperative

The Ethics of AI & Automation

Building an Ethical Engineering Practice

Introduction: Magpies vs. Engineers

The Theory of Innovation Tokens

Boring Technology is a Superpower

The Hidden Costs of Novelty

When to Spend a Token (And When to Save It)

Innovation Tokens in Platform Engineering

Introduction: The Meeting That Never Ends

Why Engineers Need Consensus Frameworks

Nemawashi — The Art of the Pre-Meeting

The SPADE Framework — Structuring the Decision

Disagree and Commit — The Essential Complement

Nemawashi + SPADE — The Complete Decision Lifecycle

Introduction: The Second Law of Thermodynamics

Software Rot in Practice — How Systems Actually Decay

The Broken Window Theory

Strategy 1 — The Boy Scout Rule

Strategy 2 — Refactoring as Hygiene

Strategy 3 — Automated Entropy Detection