Blog

What is logic debt?

By Debjani Dhar, Co-founder and CEO · Published · 8 minutes read

The short answer

Logic debt is the business logic built into a legacy estate over many years, in stored procedures, ETL packages, scripts and job schedules. The data in a migration moves quickly. The logic has to be rewritten, tested and proven object by object, and that is where time and budget actually go. Measuring logic debt early tells you what a migration will really cost.

Every migration conversation starts with data. How many terabytes, which tables, what latency. Those questions matter, but they are not where migrations stall.

Data moves with familiar tools. What stalls a migration is the logic wrapped around the data: the thousands of stored procedures, ETL packages, scripts and job schedules that encode how the company actually computes its numbers.

Where does logic debt live?

A warehouse team can usually name their biggest tables. Almost nobody can name every procedure that touches them. That gap between what the estate does and what anyone can list is the debt itself.

Where it livesWhat it looks likeWhy it is hard
Stored proceduresHundreds or thousands of procedures calculating revenue, risk, provisionsLong, interdependent, often only one or two people understand them
ETL packagesSSIS, Informatica, DataStage jobs with embedded transformationsGraphs of dependencies, not just code
Scripts and macrosShell scripts, Teradata macros, scheduler-specific glueUndocumented, invisible to most inventories
Job schedulesSequencing, dependencies, failure retries, midnight cutoffsThe schedule is logic too, and it must survive the move

Why is it called debt?

Because like financial debt it grows quietly and comes due at the worst time. Each quick fix, each procedure patched at year-end, each rule added without documentation adds to the balance. Nothing charges interest until the day you try to move.

Then the bill arrives. The migration quotes were based on data volumes. The actual work is rewriting every piece of logic, testing it, proving it matches the old system, and doing so with people who may have left the company years ago. Migration overruns are consistently reported as logic rework, not data movement.

How do you measure logic debt?

The Logic Debt Scorecard turns these into a score from 0 to 100, with a cost and timeline estimate. It takes about ten minutes, and it is the difference between quoting a migration from data volume and quoting it from the actual work.

  1. Object count. Every procedure, package, script and schedule. This sets the scale of the rewrite.
  2. Complexity distribution. How many objects are trivial rewrites versus deep, interdependent logic. Twenty simple procedures and twenty gnarly ones are different projects.
  3. Knowledge concentration. How many people understand each critical object. Concentrated knowledge is the most expensive kind, because it cannot be hired.

What happens if you ignore it?

The migration stalls, publicly. The data copies over in the first weeks, a demo looks convincing, and then the real work starts. Tests fail for reasons nobody can explain, because the original logic had behaviors nobody wrote down. Budget burns on re-testing. The renewal date that motivated the project arrives before the project does.

Or worse: the migration appears to finish. The procedures were rewritten, the numbers look close, and six months later a report disagrees with finance by an amount that takes a quarter to trace to a single edge case in a copied procedure.

How do you pay down logic debt during a migration?

The same way you pay any debt: measure it, then work it down deliberately instead of discovering it late.

A rules-based conversion converts the known patterns deterministically and flags the rest for a person. Reconciliation proves each converted object reproduces the source results. The logic that had no owner gets one, because every flagged object has a name next to it. The undocumented becomes documented, because the conversion record writes down what was done and why.

Done that way, a migration does not just move the warehouse. It clears the debt. The estate you land on is one the next team can actually read.

How much logic debt do you have?

The honest answer is that a ten-minute scorecard will get you closer than a quarter of committee meetings. You answer questions about your platforms, artifacts and documentation, and you get a score, a band, and a cost and timeline estimate for both a Novuz conversion and a manual rewrite.

If the score says the debt is small, that is good news you can act on. If it says the debt is large, better to know now than in month seven.

Key terms

Logic debt
the accumulated, mostly undocumented business logic in a legacy estate, in stored procedures, ETL, scripts and schedules.
Object
any discrete unit of that logic: a procedure, package, script or schedule entry.
Knowledge concentration
how dependent the estate is on a small number of people who understand it.
Logic Debt Scorecard
a ten-minute assessment that scores an estate's logic debt from 0 to 100 with cost and timeline estimates.

FAQ

Frequently asked questions

The accumulated business logic in stored procedures, ETL packages, scripts and job schedules, most of it undocumented. It is the part of a migration that has to be rewritten and proven, rather than copied.

Data moves with standard tools. Logic has to be rewritten, tested and proven object by object, often by people who have left. The effort scales with artifact count and complexity, not terabytes.

Count and classify the logic objects, their complexity distribution, and how concentrated the knowledge of them is. The Logic Debt Scorecard scores this from 0 to 100 with cost and timeline estimates.

It is a specific form of it. Technical debt covers any shortcut taken in software. Logic debt is the part that lives in warehouse logic and comes due at migration time.

About ten minutes. It scores your estate and estimates cost and timeline for both a Novuz conversion and a manual rewrite.

Sources

  • How Novuz scores logic debt and estimates migration cost (novuz.com/scorecard)
  • Why fixed-price data warehouse migrations need object counts, not terabytes (novuz.com/blog/data-warehouse-migration-cost-fixed-price)

About the author

Debjani (Deb) Dhar is co-founder and CEO of Novuz Inc., the deterministic data warehouse modernization company based in Danville, California. She previously led $10M+ modernization programs as an Accenture delivery executive.

Next step

Take the Logic Debt Scorecard. Ten minutes, a score from 0 to 100, and a cost and timeline estimate for both paths. If the numbers look worth a conversation, the estate assessment, at $3,000 over three business days, turns them into evidence.

Last reviewed:

Find out what your logic debt is costing you.

Every object counted, lineage, dead code and a fixed price in three business days. $3,000, credited.

Take the logic debt scorecard

Not sure which door? The scorecard takes ten minutes and tells you.

Scorecard