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.
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.
-
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.
-
Architecture Foundations
Sets up the trade-off habit and the vocabulary that every later step assumes.
-
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.
-
Modularity & Coupling
Coupling is what nearly every later decision is really arguing about, and this gives you a way to measure it.
-
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.
-
Identifying Logical Components
The first concrete act of design: finding components from workflows and actors, and avoiding the entity trap.
-
Domain-Driven Design (DDD)
Bounded contexts give component boundaries a business reason to exist, which is what keeps them from eroding.
-
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.
-
Architecture Styles Overview
Turns characteristics and boundaries into a decision: which style gives you the ones you need by default.
-
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.
-
Modular Monolith Architecture
The style that argument points to, and the one whose module boundaries make every later split cheaper.
-
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.
-
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.
-
Communication Patterns
The basic ways parts interact, compared by the coupling each one creates.
-
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.
-
API Design & Architecture
APIs are the longest-lived contracts you'll design. This is how to make them hold up and evolve.
-
Reporting and Production Make Terrible Roommates
The argument for separating read workloads from production, which the next step turns into patterns.
-
Data Management Patterns
Who owns which data once one database becomes several, and how reads stay fast without shared tables.
-
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.
-
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.
-
Architecture Decision-Making
Which decisions are yours to make, when to make them, and how to keep them from being relitigated.
-
Architecture Decision Record (ADR) Template
The record the previous step asks for, ready to copy for your first decision.
-
C4 Model
A decision nobody can picture doesn't travel. C4 gives each audience a diagram at the right zoom level.
-
Architecture Risk Analysis
Ranks where your chosen design is likely to fail its characteristics, so mitigation goes where it matters.
-
Total Cost of Ownership (TCO)
Prices a decision over its whole life, which is the argument that gets it funded.
-
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.
-
Topology Is Not a Trust Model: Position vs Identity
Applies the authority argument to security: legitimacy should come from verified identity, not network position.
-
Threat Modeling
The design-time practice for finding what that argument predicts: threats across trust boundaries, before they're built.
-
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.
-
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.
-
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.
-
Architecture Leadership
Teams you don't manage carry out most of your decisions. This is how to lead them without becoming the bottleneck.
-
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.
-
Legacy Modernization Strategies
When the fix is a replacement: how to change a system the business keeps running on, without a rewrite.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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