The Modern Engineer's HandbookBuild · Understand · Ship
Saved0 Explore guides
Home/Handbook
THE KNOWLEDGE MAP

One field guide.
A whole engineering practice.

Browse by the kind of work you're doing, or search for the problem in front of you. Every guide is designed to move from explanation to action.

15 published guides10 topic areasUpdated as the work evolves
15 guidesNO GATEKEEPING. JUST GOOD NOTES.

Engineering workflows

The day-to-day craft: understanding a task, exploring a codebase, planning a change, and delivering it with confidence.

3 guides
01How to Navigate an Unfamiliar CodebaseA repeatable first-hour workflow for understanding a repository before changing it—without reading every file or asking an AI to explain the whole thing.codebaseonboardingdebuggingBeginner9m02Your First Engineering Ticket: From Request to Pull RequestA concrete workflow for clarifying a ticket, tracing the relevant code, making a small change, and showing evidence in a pull request.ticketsonboardingplanningBeginner10m03How to Ask for Engineering Help Without Staying StuckA practical way to investigate independently, share useful evidence, and ask a teammate for the decision or context you need.communicationblockersteamworkBeginner7m

AI-native development

Context, planning, tool use, verification, agent workflows, and the habits that keep AI-assisted work reliable.

2 guides
01A Reliable Workflow for AI-Assisted CodingMove from prompt-and-pray to a deliberate loop: define the change, supply context, inspect the plan, implement in small steps, and verify the result.AIcoding-agentspromptingBeginner10m02How to Review AI-Generated CodeA risk-first method for understanding, testing, and accepting or rejecting code proposed by an AI assistant.AIcode-reviewsecurityIntermediate9m

Quality & debugging

Debugging, tests, code review, failure analysis, and building confidence in changes before they reach users.

2 guides
01Debug Software SystematicallyA practical incident-room method for reproducing bugs, narrowing causes, testing hypotheses, and preventing regressions.debuggingtestingobservabilityBeginner9m02How to Review a Pull Request Like an EngineerReview the behaviour, risk, and maintainability of a change—not just its formatting. A practical checklist for human-written and AI-generated code.code-reviewgitcollaborationBeginner8m

Delivery & operations

Pull requests, CI, deployment, observability, rollback plans, and the practicalities of operating software.

4 guides
01From Engineering Ticket to ProductionFollow one change through the real software lifecycle: clarify the requirement, plan, implement, test, review, deploy, and observe.deliverydeploymentpull-requestBeginner10m02When Your CI Pipeline FailsRead the failing step, separate code problems from environment differences, and use the smallest experiment that explains a red pipeline.CItestingbuildBeginner8m03Your First Deployment: From Build to Smoke TestFollow a small application's release from a reproducible build through configuration, deploy, health checks, smoke testing, and recovery planning.deploymentreleaseconfigurationBeginner10m04Safer Database Migrations in ProductionPlan schema changes around live traffic, old and new application versions, lock behavior, data backfills, and recovery.databasesmigrationsreliabilityIntermediate10m

Startup engineering

MVP scope, technical debt, infrastructure choices, product feedback, and engineering with real constraints.

1 guide
01Build an MVP Without OverengineeringA practical framework for choosing what to build, what to postpone, and which shortcuts are safe when a small team needs to learn quickly.startupsMVPproduct-engineeringBeginner9m

Engineering foundations

Git, the terminal, networking, databases, operating systems, APIs, and the ideas beneath modern software.

3 guides
01Git Without Fear: A Working Engineer's Field GuideUnderstand the daily Git workflow, recover from common mistakes safely, and know when to stop before a command makes things worse.gitcollaborationterminalBeginner8m02Get an Unfamiliar Project Running LocallyA safe troubleshooting sequence for setup instructions, runtime versions, dependencies, environment files, and local services.local-developmentonboardingenvironment-variablesBeginner8m03Follow a Web Request from Browser to DatabaseTrace an API request across browser, network, server, and data boundaries to understand where behavior or a 500 error originates.HTTPAPIsnetworkingBeginner9m
ON THE EDITORIAL ROADMAP

The map is bigger than the first edition.

Frontend engineering, backend systems, databases, distributed systems, security, and career growth are part of the structure. We will publish them when the guides are useful—not just to fill a grid.

Frontend engineeringBackend & dataSystems & architectureCareer & collaboration