#architecture
Architecture Decision Record — Write Down the Why
Write an architecture decision record (ADR) from your notes: the context, the options you weighed, the decision and its consequences, so the next developer knows why and doesn't reopen it.
Nigel Yoshida
Codebase Tour — Get Oriented in an Unfamiliar Repo
Get oriented in a codebase you didn't write: what it does, how it's organized, how a request flows through it, where to make common changes and the risky areas to avoid on day one.
Nigel Yoshida
System Design Review — Trade-offs Before You Build
Get a design reviewed before you build it: the weak points, failure modes, scaling limits and simpler alternatives, with each risk ranked and the questions a senior reviewer would ask.
Nigel Yoshida