Legacy Archaeology

Nobody understands your system. In two weeks, it will be written down.

A fixed-price sprint for the app that outgrew its documentation. AI agents read every line and trace every behavior, the knowledge in your people’s heads is captured while it is still around, and you keep a verified blueprint any engineer can build from. That blueprint is what makes modernization priceable, fixed, and safe.

£9,500 fixed · two weeks · the blueprint verifies, or you pay nothing

Every company has one: the system that runs a critical part of the business, was built by people who left, and is now understood — partially, nervously — by one or two people who are careful never to touch it. Nothing is written down. The industry’s reflex is the big-bang rewrite, and the industry’s record on big-bang rewrites is why nobody starts one. So the system stays, and every year the knowledge drains a little further.

This sprint inverts the order. First we make the system understood: our agents read every line of code and trace every behavior, our engineers interview the people who remember the quirks, and the two sources are reconciled into one verified blueprint — architecture, data flows, business rules, and an executable behavior suite that pins down what the system actually does today. Only then is anything modernized, in fixed-price milestones you can stop after any of them. No rewrite cliff. The blueprint is yours regardless; any team, ours or another, can work from it.

The shape of the work

Week 1

Read everything

Agents read the codebase end to end — every dialect, every dead branch, every implicit rule — and trace data flows, dependencies, and side effects. In parallel, we interview the people who remember why it behaves the way it does. Every claim, from code or from memory, is written down with its source.

Week 2

Verify, then decide

The draft blueprint is tested against the running system, and the people who know it confirm the quirks are captured. Gaps become characterization tests — executable definitions of real behavior. Then the decision map: per component, modernize, encapsulate, or leave it alone, each with an honest cost.

Handover

The blueprint is yours

You keep the blueprint, the behavior suite, the interviews, the decision map, and the agent skills we built with. Hand them to us, to your own team, or to any other vendor. The blueprint had to exist either way. It is the deliverable, not the pitch.

Phase 2

Modernize in milestones

If the modernization happens with us, it runs as strangler-fig milestones: fixed scope and price each, paid on acceptance, proven against the behavior suite before anything cuts over. Each milestone leaves the system running.

What you keep when the sprint ends

The system blueprint

Architecture, data flows, business rules, dependencies, and the edge cases — versioned in your repository and written to be read, not decorated. Any competent engineer can work from it.

The behavior suite

Executable tests that pin down what the system actually does today — the safety net that turns every later change from a hope into a provable claim.

The bus-factor interviews

The quirks, workarounds, and “whatever you do, don’t touch that” knowledge of the people who were there — captured in writing while they are still around to ask.

The decision map

Per component: modernize, encapsulate, or leave alone — each with the honest cost and the reasoning. Sometimes the right answer is “leave it,” and the map is allowed to say so.

The agent skills

The versioned skills our agents used to trace and verify your system, structured so your team — or any team — can reuse them on this codebase and the next one.

A 30-day check-in

A review of what changed in the system since the blueprint, and whether the decision map still holds — because systems drift, and a blueprint should not silently rot.

The honest parts

What it costs you in time

Two to four hours of interviews across the people who know the system, spread over the two weeks, plus two review sessions: the quirk confirmation in week two and the decision-map read-through at handover. The digging is our side of the deal.

What “guaranteed result” means here, exactly

The blueprint verifies, or you pay nothing. Verification is concrete: the behavior suite runs green against your live system, and the people who know it confirm the quirks are captured. If it does not verify by the end of the sprint for reasons on our side, we keep working at our cost for up to two more weeks. If it still does not verify, the sprint is free. The modernization earns payment the same way: no milestone is invoiced until it passes your old system’s behavior suite. What we do not do is hand you a stack of generated diagrams and call it understanding. And if a system is not blueprintable in two weeks, we say so on the first call, before any contract.

Questions we get asked

Why not just rewrite it from scratch?

+

Because the from-scratch rewrite is the best-documented failure in this industry — Netscape being the canonical case. The failure was never weak engineers; it was throwing away years of accumulated behavior, bug fixes included, that nobody had written down. The blueprint and its behavior suite are precisely what rewrites always lacked. Once behavior is written down and executable, replacement can move as fast as you like — the proof travels with it.

Is “reverse engineering” legal? It sounds like hacking.

+

It is your system. Reverse engineering here means making explicit what you already own: reading your code, tracing your system’s behavior, and writing it down. Nothing leaves your control, and nothing changes in the first two weeks. The agents read while the system keeps running untouched.

Our code is old — COBOL, VB6, PHP 4, PowerBuilder, a database nobody names out loud. Does that still work?

+

If a machine can read it and a person once wrote it, our agents can work through it. Old dialects, no documentation, one contractor who answers emails sometimes — that is the normal case for this sprint, not the exception. What determines the fixed price is size and access, which is exactly what the first call checks.

What do you actually guarantee, in plain terms?

+

Three things. The blueprint verifies — behavior suite green against your live system, quirks confirmed by your people — or you pay nothing. If verification slips for reasons on our side, we keep working at our cost for up to two more weeks first. And if a system is not a fit for a two-week blueprint, we say so on the first call instead of taking the fee and discovering it in week two. In the modernization phase, every milestone is paid on acceptance, proven against the behavior suite.

How much of our team’s time does it take?

+

Two to four hours of interviews total, spread across the people who know the system, plus two review sessions. The heaviest single block is shorter than the meeting where you would otherwise argue about whether to rewrite.

After the sprint, are we locked into you for the modernization?

+

No — that is deliberate. The blueprint is vendor-neutral by construction, and it pays for itself either way: take it to your own team, or put it in front of other vendors and compare quotes that are finally comparable. If the modernization happens with us, it is fixed-price milestones from the decision map, each paid on acceptance. The audit that can only conclude “build with us” is not an audit; the blueprint that can only lead to us would not be a blueprint.

Do you end up modernizing everything you map?

+

No, and that is the point of the decision map. Some components should be encapsulated and left alone; some should go; some carry regulatory weight and need staged replacement. We are not structurally incentivized to sell you a rewrite — the sprint’s deliverable is understanding, and “leave it alone” is a legitimate finding we will hand you in writing.

Why is the price printed, when consultancies won’t even name a number?

+

Because the deliverable is bounded: read, trace, verify, write down. Our agents do the reading at machine speed and a senior engineer owns the verification, so we can size the work honestly — the same reason the guarantee exists at all. You cannot honestly guarantee an open-ended engagement; you can guarantee a bounded one. Modernization milestones are priced the moment the blueprint makes them sizeable, and each is fixed before it starts.

Recognize your system?

A 30-minute call checks fit before anything else — including whether the sprint is right at all.

Book a call