All 28 Chapters

Six parts covering every dimension of the architect's role, from mindset to career transition.

Part I

The Mindset Shift

The transition from developer to architect is not a technical upgrade. It is a change in orientation. These three chapters establish the core shift in thinking that everything else depends on.

Ch 1

What Architects Actually Do

Most developers have a mental model of architecture built from job descriptions and second-hand observation. This chapter replaces that model with an accurate one: what architects are responsible for, how they spend their time, and what distinguishes the role from senior engineering.

Ch 2

From Solving Problems to Defining Them

Developers excel at solving well-defined problems. Architects are responsible for making sure the right problems are being solved. This chapter covers problem framing, requirements elicitation at the architectural level, and how to resist the pull toward premature solution-building.

Ch 3

Zoom Out: Thinking in Systems

Systems thinking is the cognitive foundation of architectural work. This chapter introduces the core concepts: feedback loops, emergent behavior, unintended consequences, and how to reason about systems that are too large to hold entirely in mind.

Part II

Technical Foundations of Architecture

Ten chapters of technical depth. Not patterns catalogs — practical coverage of the domains architects are expected to understand and make decisions about.

Ch 4

The Landscape: Styles, Methodologies, Frameworks, and Patterns

A clear-eyed map of the architectural landscape — monoliths, microservices, event-driven systems, serverless, and beyond. How to read the landscape without becoming dogmatic about it.

Ch 5

Distributed Systems: What Every Architect Must Know

The realities of distributed systems that textbooks underemphasize: the fallacies of distributed computing, consistency models, the CAP theorem in practice, and the failure modes that appear only at scale.

Ch 6

Data: The Architect's Most Important Decision

Data decisions outlast every other architectural decision. This chapter covers data modeling, storage selection, data ownership in distributed systems, event sourcing, CQRS, and the consequences of getting data architecture wrong.

Ch 7

APIs and Integration Patterns

REST, GraphQL, gRPC, event-driven integration, and the patterns that govern how systems communicate. How to design APIs that survive versioning and how to choose the right integration style.

Ch 8

Scalability, Performance, and Reliability

How to design for scale before you need it, measure performance before it degrades, and build reliability into the architecture rather than retrofitting it after incidents.

Ch 9

Security as Architecture

Security is not a feature to add at the end. This chapter covers threat modeling, the principle of least privilege applied at the system level, zero trust architecture, and how to make security a first-class architectural concern.

Ch 10

Compliance-Driven Architecture

GDPR, HIPAA, SOC 2, PCI-DSS — regulatory requirements that shape architectural decisions. How to translate compliance requirements into architectural constraints without over-engineering.

Ch 11

Observability: Designing Systems You Can Understand

The three pillars of observability: logs, metrics, and traces. How to design systems that produce the signals needed to diagnose problems — and how to define SLOs that tie observability to business outcomes.

Ch 12

AI and the Architect's New Decisions

What AI integration means for system architecture: LLM APIs, retrieval-augmented generation, model deployment, data pipelines for AI, and the reliability and safety considerations that come with non-deterministic components.

Ch 13

Cloud Architecture: Building for the Platform

How to design systems that use the cloud effectively rather than treating it as rented hardware. Managed services, cloud-native patterns, multi-cloud trade-offs, and the cost architecture decisions that finance will eventually ask about.

Part III

The Craft of Design

Knowing the technical landscape is necessary but not sufficient. These five chapters cover the practice of making architectural decisions and communicating them.

Ch 14

How to Make Architectural Decisions

A practical framework for architectural decision-making: how to frame decisions, evaluate alternatives, manage uncertainty, document reasoning, and build the organizational confidence that lets decisions stick.

Ch 15

Patterns: Tools, Not Dogma

Architectural patterns are solutions to recurring problems, not prescriptions. This chapter covers how to select patterns based on context, combine them appropriately, and recognize when a pattern is the wrong fit.

Ch 16

Legacy Modernization: When and How to Evolve What Already Exists

Most architecture is not greenfield. This chapter covers the strangler fig pattern, incremental migration strategies, the decision between rewrite and evolve, and how to modernize without breaking the systems the business depends on.

Ch 17

Diagrams That Communicate, Not Impress

Architectural diagrams fail when they optimize for completeness over clarity. This chapter covers the C4 model, context diagrams, sequence diagrams, and the discipline of drawing what your audience needs to understand, not everything you know.

Ch 18

Balancing Quality Attributes

Performance, security, maintainability, scalability, cost — every architectural decision involves trade-offs between quality attributes. How to identify which attributes matter most in a given context and make trade-offs explicitly rather than by accident.

Part IV

Architecture Across the Organization

Architecture does not happen in isolation. These three chapters cover the organizational structures and communication practices that make architectural work stick.

Ch 19

Architecture Governance: Guardrails, Not Gates

Governance exists to guide, not to slow down. This chapter covers Architecture Decision Records, RFCs, architecture review boards, fitness functions, and the difference between governance that enables teams and governance that obstructs them.

Ch 20

Reference Architecture: Patterns You Can Build On

Reference architectures reduce the cost of good decisions by making the right choice the default. How to create reference architectures that teams actually use, and how to keep them current as the technology landscape changes.

Ch 21

Communication: The Architect's Primary Tool

Architecture is only as effective as your ability to communicate it. This chapter covers writing architecture proposals, presenting to non-technical stakeholders, facilitating technical discussions, and building the trust that makes your recommendations actionable.

Part V

The Human Side of Architecture

The hardest parts of architectural work are not technical. These three chapters address the people, politics, and pressure that determine whether good architecture actually gets built.

Ch 22

Working with Teams: Leading Without a Title

Architects rarely have direct authority over the engineers who implement their designs. This chapter covers technical leadership through influence, how to get engineering teams to care about architectural concerns, and how to handle disagreement productively.

Ch 23

Stakeholder Management and the Politics of Architecture

Architectural decisions have stakeholders with competing interests. This chapter covers stakeholder mapping, navigating organizational politics, building coalitions for significant architectural changes, and managing the expectations of people who have authority over your work.

Ch 24

Managing Trade-offs Under Pressure

Business pressure, time constraints, and competing priorities are permanent features of architectural work. This chapter covers decision-making frameworks for high-stakes situations, how to make trade-offs explicit, and when to push back and when to adapt.

Part VI

The Career Transition

The practical path from where you are to where you want to be: the skills to build, the moves to make, and the plan to follow.

Ch 25

Closing the Gap: Skills You Need Before You Are Ready

The gap between senior developer and architect is specific and closeable. This chapter maps the skills architects need that developers typically lack, and provides a practical plan for closing the gap before you have the title.

Ch 26

Navigating the Transition Inside Your Company

Most architects make the transition at the organization that already knows them. This chapter covers how to position yourself, build the visibility that leads to architecture opportunities, and manage the transition without burning your engineering credibility.

Ch 27

The First 90 Days as an Architect

The first three months in an architecture role determine whether you succeed. A structured 30-60-90 day plan: what to learn, what to avoid, and how to make your first architectural contributions count.

Ch 28

What Comes Next

The architect role is a beginning, not a destination. This chapter looks at the paths beyond staff architect: principal architect, CTO track, independent consulting, and how to keep growing in a role that has no clear ceiling.

Ready to read?

Available now on LeanPub in PDF and ePub formats.

Get the Book on LeanPub