All notes
Everything here, in eight sections. If you have a slow toolchain and no evidence, start with measurement. If someone has asked for per-developer numbers, read the foundations first.
All 50 notes
Grouped by section, each appearing once. The tag on the left says what kind of note it is.
Foundations
6 notesWaiting is the subject. Which loops matter, what the delay actually costs beyond the minutes, and the boundary this whole field has to hold: the system is measurable, the people are not the target.
- ExplainerWhat Developer Productivity Engineering Is
- AnalysisThe Cost of Waiting
- ReferenceThe Loops, Ranked
- ReferenceWhat to Measure
- AnalysisMeasuring the System, Not the Person
- AnalysisMaking the Case Without Overclaiming
Build systems
8 notesWhere most of the available speed is, and where it eventually becomes architecture work: the graph sets a ceiling that no amount of caching or hardware can lift.
- ExplainerIncremental Builds
- ProcedureBuild Caching, Local and Remote
- AnalysisThe Dependency Graph
- AnalysisOne Repository or Many
- ProcedureReproducible Builds
- AnalysisChoosing and Configuring the Build Tool
- AnalysisParallelism and Its Ceiling
- ProcedureArtefacts and Dependency Fetching
Testing
6 notesA suite that fails randomly is worse than one that is slow, because it destroys trust in the signal. Reliability is worth more than speed at the margin and is measured far less often.
- ProcedureMaking Tests Faster
- ProcedureFlaky Tests
- AnalysisRunning Only What Is Affected
- AnalysisThe Shape of the Suite
- AnalysisCoverage, Used and Misused
- ProcedureTest Data and Fixtures
Pipelines
6 notesTime to a useful signal rather than total duration. Plus the split almost nobody reports: queue time and execution time have different causes and different fixes.
- ProcedureDesigning the Pipeline
- AnalysisQueueing and Capacity
- ProcedureCaching in Continuous Integration
- ExplainerMerge Queues
- ProcedureSeeing Inside the Pipeline
- ProcedureTriaging a Red Pipeline
Local environment
6 notesThe loop developers spend most of their day inside, and the one with no telemetry by default. Includes the friction that costs no measurable time at all.
- ProcedureClean Machine to First Change
- AnalysisContainers, Native, or Neither
- ProcedureThe Loop Inside the Editor
- AnalysisEnvironment Drift
- AnalysisFriction That Is Not Latency
- ProcedureCredentials in Development
Measurement
6 notesFrameworks read as their authors intended, telemetry collected without losing the trust it depends on, and the discipline that turns a number into a change rather than a dashboard.
- ReferenceDORA Metrics, Read Correctly
- ProcedureAsking People, Properly
- ProcedureCollecting Telemetry Without Losing Trust
- ProcedureTurning a Measurement Into a Change
- AnalysisBenchmarking Against Yourself
- ReferenceThe Weekly Report
Running a programme
8 notesThe first ninety days without a purchase, the ranking that returns most soonest, and the failures that recur — each visible early and each with a specific correction.
- ProcedureStarting a Programme
- ProcedureChoosing What to Fix
- AnalysisWho Owns the Toolchain
- AnalysisBuying, Building and Configuring
- AnalysisGetting Improvements Adopted
- AnalysisHow These Programmes Fail
- ProcedureStopping It Coming Back
- AnalysisWhat Changes as the Codebase Grows
Reference
4 notesThe boundary: what a fast toolchain does not solve, the requests that would destroy the capability, and a description of the end state to measure a plan against.
- AnalysisWhat This Work Cannot Fix
- ReferenceWhat a Working Setup Looks Like
- ReferenceRequests to Refuse
- ReferenceGlossary