INTERMEDIATE · 8 MODULES · 64 LESSONS
Architecture Decisions and Trade-offs
Make architecture decisions with evidence instead of personal preference: compare options with numbers, record the why, and protect each decision with an automated test.
- For you if
- You design or maintain backend systems and struggle to defend why you picked one option over another.
- By the end
- You'll know how to build a decision matrix, write an ADR, test alternatives before committing, and weigh how costly a decision is to reverse.
- You need
- Experience with backend systems (services, APIs, databases) and Python to run the exercises.

Curriculum
01La arquitectura es decisiones
- Module introduction: architecture is decisions, not diagrams
- What makes a decision architectural
- Local versus architectural decisions
- The cost of deciding
- The cost of NOT deciding
- Deciding under uncertainty
- Architecture is decisions, not diagrams
- Mini-project: classify and prioritize Mercado's open decisions
02No hay "mejor", solo trade-offs
- Module introduction: there is no "best", only trade-offs
- What "good" means: the quality attributes
- Why quality attributes compete
- The trade-off is your deliverable
- Quantify, don't adjectivize
- Performance costs freshness: the cache trade-off
- There is no context-free "best"
- Project: quantify and name a Mercado trade-off
03Los Architecture Decision Records (ADR)
- Module introduction: the ADR, the team's memory
- Why an ADR is written: architectural amnesia
- The anatomy of an ADR: Context, Decision, Consequences, Status
- The status of an ADR: proposed, accepted, superseded, deprecated
- The decision log: the numbered and immutable memory
- Supersede: replacing a decision without erasing the history
- Lightweight ADRs versus heavy documentation
- Project: write and validate Mercado's decision log
04La matriz de decisión
- Module introduction: the decision matrix
- The anatomy of a decision matrix
- Choosing the criteria that matter
- Scoring options on a common scale
- Weights without rigging the result
- Sensitivity analysis and false precision
- The matrix is a thinking aid, not an oracle
- Project: score a Mercado decision with a matrix
05Generar y probar opciones
- Module introduction: generating and testing options
- Generate at least three options
- The first-idea bias and anchoring
- The spike: buying information with an experiment
- Timebox the spike and throw it away
- The walking skeleton
- Decide with evidence, not the loudest voice
- Project: run a spike for a Mercado decision
06Fitness functions y arquitectura evolutiva
- Module introduction: fitness functions and evolutionary architecture
- What is a fitness function
- The forbidden dependency
- Measuring coupling as a fitness function
- Atomic and holistic fitness functions
- Fitness functions in CI: the gate
- Evolutionary architecture: changing safely
- Project: protect a Mercado decision with a fitness function
07El costo y la reversibilidad de las decisiones
- Module introduction: the cost and reversibility of decisions
- One-way and two-way doors
- Calibrate the rigor to the reversibility
- The last responsible moment
- Technical debt as a deliberate trade-off
- The technical-debt quadrant
- Make one-way doors reversible
- Mini-project: cost and reversibility of a Mercado decision
08Proyecto — decide y registra una decisión de Mercado
Reviews
What students say
These reviews are from enrolled students who completed at least 50% of the course. We moderate reviews only on content grounds (spam, offensive language, personal data), never for being critical or negative.
No approved reviews yet.
Be the first to share your experience!