Think Build Implement Repeat
London, UK +44 7367 067226
WhatsApp FOLLOW f in X
  1. Home
  2. Blog
  3. Only One Person Understands Our System. How Do We Stop Depending on Them?
Problems We Solve

Only One Person Understands Our System. How Do We Stop Depending on Them?

One developer knows everything about your system and you are one resignation away from trouble. How SpiderHunts spreads that knowledge before it walks out.

Updated 3 min readBy SpiderHunts Technologies

Free estimateNo obligation

Get a free estimate

Tell us what you need. A senior engineer reads every enquiry.

Takes under a minute. We never share your details.

  • Free consultation
  • No commitment
  • NDA on request

Prefer to talk? Book a free 30-minute call →

Quick answer — TL;DR

If one developer knows everything, the fix is to spread knowledge while they are still happy and available: pair a second developer with them, write down deployment and recovery steps, and put infrastructure into code. SpiderHunts provides that second developer and turns what they learn into documentation you own.

The person everyone waits for

Every business with a small technical team has one. The developer who built the first version, knows why the invoice job runs at 2am, remembers which customer has a special pricing rule and is the only one who can deploy. When they are on holiday, nobody touches production. When something breaks at the weekend, they get the call.

They are usually excellent. That is the problem. Everything routes through them because they are fast and reliable, and so nothing else ever gets built up around them.

How it ends up this way

Nobody decides to create a single point of failure. It builds up gradually.

  • The early system was built fast, by one person, with no time for documentation.
  • Other developers came and went, but the original one stayed and kept the difficult parts.
  • Deployments, server access and third-party accounts were set up under their login.
  • When something urgent happens, it is quicker for them to fix it than to explain it.
  • Writing things down never beats the next feature in a priority discussion.

Asking them to document everything in their spare time rarely works. They do not have spare time, and knowledge written in isolation misses what the next person will actually need to know.

What rides on one person

If they are away or leaveWhat happens
Production incidentNobody knows how to diagnose or roll back
Routine deploymentReleases stop, or someone guesses
Expired certificate or credentialNobody knows where it is configured
Customer asks why a figure is wrongNobody knows the rule behind it
Hiring a replacementThe new person has nothing to learn from

There is also a quieter cost while they are still there. They become a bottleneck on every decision, work queues behind their availability, and they burn out carrying it.

How we spread the knowledge

What we do is add a second experienced developer alongside them, with the explicit job of learning the system by working on it and writing down what they learn.

  1. Map the system with your key developer: components, servers, scheduled jobs, integrations, accounts and the dark corners they worry about.
  2. Pair on real work. Our developer takes tickets in each area of the system, with your developer reviewing, so learning happens through doing rather than long handover meetings.
  3. Write runbooks as we go: how to deploy, how to roll back, how to restore from backup, what to check when a particular alert fires.
  4. Move accounts and access to the business. Hosting, domains, repositories and third-party services are owned by company accounts, with named individuals given access.
  5. Put infrastructure into code where practical, using tools like Terraform or the cloud provider's templates, so server setup is written down and repeatable.
  6. Test the result. At some point the second developer runs a deployment and a restore on their own while the original one watches. Gaps show up quickly.

We also look at the scheduled jobs and integrations that run without anyone watching. These are the pieces most likely to fail silently after a key person leaves, because nobody else knows they exist. Each one gets a short note: what it does, when it runs, what breaks if it stops and how to tell whether it ran.

This is done with your developer, not around them. The aim is to take load off them, and most people in that position are relieved rather than threatened.

After the knowledge is shared

Two people can deploy, diagnose and fix. Your key developer can take a proper holiday. Runbooks and architecture notes sit in your repository where anyone can read them. If they do leave one day, you have a handover that is already mostly done.

You can then decide whether to keep our developer on, reduce their hours or hand everything to a new in-house hire, and any of those is workable.

Does this describe your team?

  • One developer is the only person who can deploy or fix production.
  • Their holidays are planned around the release calendar.
  • Server, domain or cloud accounts are under their personal login.
  • There is little or no written documentation of how things work.
  • You would struggle to brief a replacement if they left tomorrow.

FAQ

Frequently asked questions

The questions readers ask us after this guide.

Still have a question?

Ask us directly — a senior engineer will get back to you.

Ask about your project

Will our developer feel pushed out?

It depends on how it is framed. We position it as taking load off them, and in practice the pairing gives them someone to hand routine work to.

How much documentation will you write?

Enough for someone competent to deploy, recover and change each part of the system. We favour short runbooks and notes next to the code over long documents nobody updates.

What if the system uses unusual technology?

We tell you after looking at it whether we have people who can work in it well. If not, we say so.

Do we need to keep your developer on afterwards?

No. Once knowledge is shared and documented, you can reduce the arrangement, keep it, or hand over to someone in-house.

Keep reading

More on Problems We Solve

Start here

Is your system in one person's head?

Tell us about the system and the person who holds it together. We will suggest a practical way to spread the knowledge that respects their time, and say if a lighter approach would do.

  1. You tell us what you needTwo minutes on the form, or a message on WhatsApp.
  2. A senior engineer reviews itAnd comes back with questions, a realistic range and an honest view on fit.
  3. Free 30-minute scoping callWe talk through scope, options and a realistic estimate — with no obligation.
Free estimateNo obligation

Talk to someone who builds this

Send a short brief and we will come back with an honest view and a realistic range.

Takes under a minute. We never share your details.

  • Free consultation
  • No commitment
  • NDA on request

Prefer to talk? Book a free 30-minute call →