What Is Bus Factor?

Bus factor (also called truck factor or lottery factor) is the minimum number of team members whose sudden departure would leave a project or component without anyone who understands its architecture, implementation, or operational requirements. A bus factor of 1 means a single person's departure would create a critical knowledge gap.

Why It Matters

Bus factor is the human dimension of single points of failure. While SPOF analysis identifies critical files in the dependency graph, bus factor analysis identifies the engineers whose knowledge makes those files maintainable. The two risks compound: a file that is both a code-level SPOF and a knowledge-level bus factor represents the most dangerous kind of architectural fragility.

Organizations rarely measure bus factor systematically. They discover it reactively — when someone leaves and the team realizes nobody else understands the authentication service, the billing integration, or the deployment pipeline. The cost of this discovery is measured in months of knowledge reconstruction, not hours.

Bus factor cannot be eliminated entirely (some specialization is inevitable), but it can be managed by identifying where bus factor is lowest and prioritizing knowledge distribution, documentation, and architectural simplification for those areas.

How It Works

Bus factor is estimated through a combination of signals:

Git commit analysis identifies which developers have modified each file, producing a knowledge distribution map. Files with commits from only one developer have a bus factor of 1.

Recency weighting adjusts for the fact that a developer who last modified a file two years ago may no longer remember its implementation. Recent contributors are weighted more heavily than historical ones.

Centrality correlation maps bus factor findings onto the dependency graph. A file with bus factor 1 that is also a high-centrality SPOF represents compound risk — a single person holds the knowledge for a structurally critical component.

The resulting analysis identifies architectural zones where knowledge concentration creates organizational risk and prioritizes knowledge distribution efforts by structural impact.

How Axiom Refract Addresses This

  • Axiom Refract's SPOF analysis identifies the code-level dimension of bus factor — which files are structurally critical and would benefit most from shared knowledge
  • Centrality metrics highlight files where bus factor risk would have the highest architectural impact
  • The architectural record Axiom produces is itself a bus factor mitigation — it makes structural knowledge persistent and transferable regardless of personnel changes