hadobakht Independent thinking · Worldwide
Contact ↗
← Back to all writing

Semantic debt compounds more quietly than technical debt

A definition that drifts can make every downstream system confidently wrong.

⌁DATA STRATEGY · HN / 01

Technical debt is visible when a system slows down, tests fail or a change becomes expensive. Semantic debt is harder to notice. A team changes the definition of “active account,” another adds a different interpretation of “recognized revenue,” and a third builds a forecast from both. Each component still passes its unit tests. The business begins arguing over numbers that no longer describe the same thing. This debt accumulates in the space between technically valid systems.

02 / PERSPECTIVE

The cost increases as meaning travels. An unclear metric enters an API, then a dashboard, then a planning model, then an automated agent that is allowed to take action. At every step the original ambiguity becomes harder to detect. The problem is not merely that teams disagree. It is that the disagreement is encoded into software that can act at machine speed. The more fluent the interface, the less obvious the uncertainty behind it.

03 / PERSPECTIVE

Managing semantic debt requires a register of important business concepts with owners, definitions, exclusions, effective dates and known consumers. Changes should include an impact review: which reports will move, which algorithms will change behavior, and whether historical numbers remain comparable. This is especially critical when licensing, customer identity and financial interpretation cross product boundaries. A single company may operate several valid definitions, but they must be deliberate and visible.

04 / PERSPECTIVE

Not every definition needs committee approval. Excessive governance can be another form of debt. Keep exploratory concepts flexible and strengthen controls as they become operationally consequential. The ideal is not a universal dictionary that freezes the company. It is a living contract that allows the business to evolve without silently changing the meaning of its past decisions. Semantic clarity is not documentation overhead. It is part of what makes intelligence safe to use.

Research and design credits ↗
Continue readingA customer portal is the interface to a business relationship↗