Developer to Architect

Make structural decisions for a system and a team, and defend them in terms the business accepts.

For
Senior developers taking on design responsibility
Assumes
Several years of building production software. No prior study of architecture.
40 steps in 8 stages About 6 h of reading

Steps open in a new tab, so this page stays where you left it. Steps you've opened turn grey.

Stage 1 · Foundations

What architecture is

The theory, and the arguments, that every later level applies.

  1. Essay 2 min
    Adaptability Over Cleverness: What Makes Code Actually Good

    The bridge from developer to architect: the measure of a design is how well it survives change, not how clever it is.

  2. Guide 5 min
    Architecture Foundations

    Sets up the trade-off habit and the vocabulary that every later step assumes.

  3. Guide 6 min
    Architecture Characteristics

    Styles, risks, and costs later in the path are all measured against these, so you need the short list before you can trade anything.

  4. Guide 9 min
    Modularity & Coupling

    Coupling is what nearly every later decision is really arguing about, and this gives you a way to measure it.

  5. Essay 12 min
    Architecture Is a Belief About Where Authority Belongs

    The argument underneath the rest of the path: where authority lives decides what a system can absorb. Every later decision is a version of that question.

Go deeper Architecture Characteristics Glossary

Stage 2 · Basics

Finding the boundaries

Where the parts of a system are, drawn from the work and the domain rather than the database.

  1. Guide 3 min
    Identifying Logical Components

    The first concrete act of design: finding components from workflows and actors, and avoiding the entity trap.

  2. Guide 17 min
    Domain-Driven Design (DDD)

    Bounded contexts give component boundaries a business reason to exist, which is what keeps them from eroding.

  3. Guide 11 min
    Team Architecture & Organization

    Teams and system boundaries shape each other. Draw one without the other and Conway's Law redraws it for you.

Go deeper Architecture Design Diagrams

Stage 3 · Basics

Choosing a shape

The first structural decision: which style, and whether to distribute at all.

  1. Guide 7 min
    Architecture Styles Overview

    Turns characteristics and boundaries into a decision: which style gives you the ones you need by default.

  2. Essay 2 min
    Monoliths for Discovery, Microservices for Optimization

    An argument for sequencing: stay monolithic while you learn the domain, and distribute only what you've learned needs it.

  3. Guide 7 min
    Modular Monolith Architecture

    The style that argument points to, and the one whose module boundaries make every later split cheaper.

  4. Guide 7 min
    Distributed Computing Fundamentals

    Before a module becomes a service, know what the network will cost you and how to tell whether the split is real.

  5. Case study 9 min
    When Architecture Patterns Don't Match the Problem

    Three successive designs for one problem, including a pipeline style that never fit it, and the organizational pattern that outlived all three.

Go deeper Architecture Style Comparison Layered Architecture Service-Based Architecture Event-Driven Architecture Microservices Architecture Are You Using Hexagonal Architecture, or Just Dependency Injection?

Stage 4 · Intermediate

Connecting the parts

How the parts talk and who owns which data, once there is more than one of them.

  1. Guide 5 min
    Communication Patterns

    The basic ways parts interact, compared by the coupling each one creates.

  2. Essay 6 min
    Avoid Forcing REST onto Domain-Driven Architectures

    An argument to settle before designing any interface: a domain-driven system exposes operations, and REST's resource model fights that.

  3. Guide 15 min
    API Design & Architecture

    APIs are the longest-lived contracts you'll design. This is how to make them hold up and evolve.

  4. Essay 12 min
    Reporting and Production Make Terrible Roommates

    The argument for separating read workloads from production, which the next step turns into patterns.

  5. Guide 12 min
    Data Management Patterns

    Who owns which data once one database becomes several, and how reads stay fast without shared tables.

  6. Case study 8 min
    When Infrastructure Constraints Doom Sound Architecture

    Sound data patterns undone by an infrastructure constraint nobody weighed, which is what the next level's decision discipline exists to catch.

Go deeper Messaging Patterns Orchestration and Choreography Patterns Your Reads Should Not Design Your Writes Database Selection Matrix When Your Product Outgrows Generic Metrics How Shared Libraries Become Shared Shackles

Stage 5 · Intermediate

Deciding and recording

Making decisions stick: whose they are, how they're recorded and shown, what could go wrong, and what they cost.

  1. Essay 6 min
    Build Slow to Go Fast: Decisions That Are Hard to Reverse

    The argument for this level: spend design time in proportion to how expensive a decision is to reverse.

  2. Guide 7 min
    Architecture Decision-Making

    Which decisions are yours to make, when to make them, and how to keep them from being relitigated.

  3. Resource 1 min
    Architecture Decision Record (ADR) Template

    The record the previous step asks for, ready to copy for your first decision.

  4. Guide 15 min
    C4 Model

    A decision nobody can picture doesn't travel. C4 gives each audience a diagram at the right zoom level.

  5. Guide 9 min
    Architecture Risk Analysis

    Ranks where your chosen design is likely to fail its characteristics, so mitigation goes where it matters.

  6. Guide 10 min
    Total Cost of Ownership (TCO)

    Prices a decision over its whole life, which is the argument that gets it funded.

  7. Case study 11 min
    When Third-Party Integration Meets Domain Boundaries

    One boundary decision followed from options to consequences, including taking on debt on purpose.

Go deeper Return on Investment (ROI) Rebuild Success Often Comes from Realignment, Not New Technology C4 Model Diagrams When Nobody Owns the Cloud Bill When Someone Else's Problem Becomes Your Solution

Stage 6 · Advanced

Proving the qualities

Security, reliability, and operability designed in, not bolted on.

  1. Essay 13 min
    Topology Is Not a Trust Model: Position vs Identity

    Applies the authority argument to security: legitimacy should come from verified identity, not network position.

  2. Guide 9 min
    Threat Modeling

    The design-time practice for finding what that argument predicts: threats across trust boundaries, before they're built.

  3. Case study 13 min
    When You Can't Replace What You Haven't Abstracted

    Five separate auth implementations unified behind one abstraction before any could be replaced, with every request validated and customer and service identity kept apart.

  4. Guide 14 min
    Reliability Patterns

    Once parts talk over a network, one slow dependency can take down the rest. These patterns are how a design keeps a failure local.

  5. Essay 6 min
    Observability Is Authored, Not Installed

    A system that can't tell handled from broken can't be operated, whatever platform sits behind it. That classification is a design decision.

Go deeper Security Foundations Testing Strategy & Architecture Performance Engineering When Real-Time Push Needs Product Context

Stage 7 · Advanced

Leading across teams and time

Carrying decisions through teams you don't manage, through an organization, and through years of change.

  1. Guide 8 min
    Architecture Leadership

    Teams you don't manage carry out most of your decisions. This is how to lead them without becoming the bottleneck.

  2. Essay 6 min
    Why 'Tech Debt' Does Not Get Fixed

    Debt everyone can see but nobody funds is the usual reason a system has to be modernized at all. This is the vocabulary that makes the case before it gets there.

  3. Guide 15 min
    Legacy Modernization Strategies

    When the fix is a replacement: how to change a system the business keeps running on, without a rewrite.

  4. Guide 12 min
    Architecture Governance

    Scales everything above past one team: who decides what, and how the organization notices when a decision stops working.

Go deeper Automating Architecture Governance Architecture Governance Frameworks Dev Team Leadership What Engineering Leaders Ask That Others Don't

Stage 8 · Advanced

From need to delivery

The whole path applied to one project: understand the need, commit to a plan, deliver it, and go back when reality breaks it.

  1. Essay 15 min
    Plan Continuation Bias: Why We Keep Building the Wrong Thing

    The argument for this last stage: every plan assumes someone will notice when it's wrong and stop, and plan continuation bias keeps teams building what they already know is wrong.

  2. Guide 3 min
    AAA Cycle: Align-Agree-Apply

    The three phases, and the rule that makes them work: going back is part of the method, not a failure of it.

  3. Guide 10 min
    AAA Cycle: Phase 1 - Align with the Need

    Discovery with the people who have the need, and the Go, Pivot, or No-Go call made before anyone commits to a plan.

  4. Guide 8 min
    AAA Cycle: Phase 2 - Agree to the Plan

    Turning alignment into a plan people commit to. The boundaries, style, decisions, and risks from earlier in the path all come together here.

  5. Guide 9 min
    AAA Cycle: Phase 3 - Apply the Plan and Deliver

    Delivering against the agreement, with circuit breakers that force the continue, adapt, or go back decision.

Go deeper AAA Worked Example: Ridgeline Mutual's Portal Project Charter Template AAA Gate Readiness AAA Scenarios: Applying the Discipline AAA Cycle Diagrams