How to Write an Architecture Decision Record (ADR), with a Template
An architecture decision record captures the context, the options, the decision, and its consequences in one page. Includes a copy-ready template.
Practical guides
How to write tech reviews and postmortems, with templates.
How to Evaluate an LLM Feature Before You Ship It (with a Template)
Define the task, evaluation set, cost and latency targets, fallback when the model is wrong, and when to turn the feature off. Copy-ready template.
How to Plan a Data or System Migration (with a Template)
A migration plan defines scope, dual-write and verification phases, rollback triggers, and owners. Includes a copy-ready template.
How to Write a Monorepo Adoption Review (with a Template)
Decide on a monorepo by measuring build and test time, ownership, release units and the cost of reversing. Includes a copy-ready template.
How to Choose an Observability Tool: Criteria Matrix and Template
List the questions an observability tool must answer, score candidates on cost, correlation and operating load, and plan post-rollout checks.
How to Write an Incident Postmortem (with a Template)
A blameless postmortem covers the timeline, root cause, blast radius, and follow-up actions with owners. Includes a copy-ready template.
How to Read Engineering Blog Cases as Evidence
Separate what a company adopted from what it only mentions, check whether the post gives a scale, and look for outcomes before you rely on a case.
How to Research a Company’s Tech Stack Before You Apply
Match a company’s engineering blog against its job postings to separate what it runs from what it only mentions, and track how the stack changed.
How to Write a Tech Adoption Review (with a Template)
What a tech adoption review should answer: alternatives, a decision matrix, other companies as evidence, and a rollback plan. Copy-ready template.
How to Write a Web Performance Improvement Log (with a Template)
Record the baseline and its conditions, the hypothesis and evidence, the change, the before-and-after result and rollback criteria. Copy-ready template.