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 lives | What it looks like | Why it is hard |
|---|---|---|
| Stored procedures | Hundreds or thousands of procedures calculating revenue, risk, provisions | Long, interdependent, often only one or two people understand them |
| ETL packages | SSIS, Informatica, DataStage jobs with embedded transformations | Graphs of dependencies, not just code |
| Scripts and macros | Shell scripts, Teradata macros, scheduler-specific glue | Undocumented, invisible to most inventories |
| Job schedules | Sequencing, dependencies, failure retries, midnight cutoffs | The 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.
- Object count. Every procedure, package, script and schedule. This sets the scale of the rewrite.
- Complexity distribution. How many objects are trivial rewrites versus deep, interdependent logic. Twenty simple procedures and twenty gnarly ones are different projects.
- 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
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: