The Bus Factor Audit: Find the Single-Person Territory in Your Codebase
Velocity looks fine until the person who owns auth takes a holiday. A 20-minute audit β authorship thresholds, the risk grid, and the lightest fix for every hotspot.
Everything looks fine until the one person who owns authentication goes on holiday. Velocity held all quarter, lead time is flat, the dashboards are green β and then a feature queues behind reviews that only one person can give, a hotfix waits two days, and delivery is quietly slower for five weeks. Nobody budgets for this, because none of the standard engineering dashboards count it.
Knowledge concentration is the predictor of your future speed, and it is invisible in velocity charts: they count what changed, never who could safely change it again. This audit takes 20 minutes and uses only commit authorship over the last six months. It answers two questions: who actually owns each structural module, in practice rather than on paper β and where the intersection of "structurally critical" and "effectively single-person" sits on your architecture.
Step 1: Map touch concentration (10 minutes)
List your five structural modules β the ones other modules import: authentication, the public API surface, deployment scripts, core domain logic, the data layer. For each, pull the authorship of every commit over the last six months and record one number: the share of that module's commits made by the top-1 author.
| Top-1 author share | Reading |
|---|---|
| Under 40% | Balanced β knowledge is shared |
| 40β70% | Drifting β one person is becoming the owner by default |
| Over 70% | Hotspot β the module is effectively single-person territory |
A five-person team, real numbers: auth at 78% (one author), sync pipeline at 34%, compliance export at 91%, billing webhooks at 62%, data layer at 38%. One glance and you know that a Priya-shaped holiday touches auth, a Tom-shaped resignation takes compliance knowledge to a competitor β and chip by chip, someone has been defaulting into a 62%-shaped shadow they never asked to own.
Step 2: Triangulate with review ownership (5 minutes)
Code lands through reviews, so a module is only safe when both its authorship and its review knowledge are distributed. For each hotspot, check who reviews its PRs:
- Author also owns every review β a single point of knowledge and of quality control on the same code. Act first.
- One stable reviewer per author β the "shadow couple": safe for holidays, not for departures.
The real exposure is the intersection structural Γ hotspot Γ single-author. Draw the grid: each red cell is a module at least one future vacation will expose.
Step 3 and 4: Cross the lists, then pick the lightest fix
The lightest mitigation usually beats the obvious big one β order again:
- Pair one non-owner onto the next real change on the hotspot β an actual feature ticket, not a refactor. Cheapest knowledge transfer that exists, and reviews stay honest.
- Rebalance the next two planned tasks so a second pair of hands arrives through incoming work, not through a handover meeting nobody retains.
- Write one architecture note per hotspot while the owner is present β what it does, why it was built this way, where the bodies are buried.
- Recheck in 30 days β the number matters quarterly; the trend is the only signal that tells you whether the pairing worked.
What not to do: documentation sprints that produce wiki pages nobody updates, and forced rotations across a whole team. Pairing on real change beats both β by a comfortable margin.
What it looks like after 60 days
In one worked team: auth went from 78% single-author to 54% in six weeks of two tickets plus pairing; compliance export from 91% to 71% with an intent document written before any migration work started; billing drifted from 62% to a balanced 47%. Nothing was rewritten β what moved was who is comfortable touching what, which is exactly what the next incident, holiday or resignation actually tests.
Doing this by hand is a photograph that is outdated the day after β and the number that matters is the trend. DevLyTicks tracks authorship concentration and review ownership per module automatically, on every sync. If you want the full 20-minute workbook, the Bus Factor Audit is free.
Conclusion
Your bus factor is not a number you choose β it is the number your commit history has been writing for months. Spend the 20 minutes to read it, triage the two or three cells that are genuinely red, and buy them down with pairing discipline rather than refactors. Your future speed is partly decided by who is allowed to go on holiday.
Run the Bus Factor Audit on your own repos
A 20-minute worksheet: who owns each structural module, where the single-person hotspots are, and the lightest fix for each.
Download it freeReady to optimize your development process?
Join thousands of developers using DevLyTicks to improve their productivity and code quality.