Managing Technical Debt: Nine Policy Recommendations
To technologists, technical debt, whether incurred intentionally or not, is an inexhaustible source of frustration and failure. But to technology-dependent organizations, unrestrained technical debt is a threat to survival. Many now recognize that if present trends continue, the more important controversy may not be whether we will suffer a technical debt-driven collapse, but when.
For technology-dependent products, companies, institutions, and even societies, sustainability depends on learning how to manage technical debt. Like most transformations, incorporating new practices into our organizations will likely be an iterative process. We already recognize the problem, and researchers are making progress, albeit mostly on technical issues. Nevertheless, some have begun to examine the nature of the required organizational transformations.
Little is known now about what those transformations will entail. So far, the literature of technical debt has emphasized code and other technical artifacts. However, because the root causes of technical debt may not be technical at all, the solution might be far more fundamental than changing how we build software. The required changes may affect how we sponsor projects, or how we account for expenses, or even what we mean when we declare that a piece of work is “done.”
To paraphrase Stephen Covey’s description of a jungle safari, we’re cutting our way through the undergrowth, staying focused on sharpening our machetes, conducting muscle development programs, and improving work schedules. Yet it might be time for someone to climb a tall tree and verify that we’re cutting our way through the right jungle.
This Executive Update proposes a policy-centered approach to the problem. It begins with a principle that can serve as a guide for constructing technical debt management policy, and then shows how to apply that principle to develop nine recommendations that enable organizations to manage technical debt effectively.
The Principle of Accountability
Organizational policy is of little use if gaining compliance requires the continuous focused attention of senior management. This is particularly true when the policy involves behavior related to technology and technology-rich decisions, as is the case with managing technical debt. The problem is too complex — and the decisions too numerous — for enforcement-based mechanisms to work. Effective technical debt management policy must provide a framework that supports new behaviors leading to rationalizing technical debt formation.
Nearly anyone who makes or contributes to decisions might occasionally bear some responsibility for incurring new technical debt. The organizing principle that leads to effective control of technical debt must be simple to state and easily understood because we must communicate it to nearly everyone in the enterprise. Here is a sample statement of that principle:
Those whose decisions or actions cause the enterprise to incur technical debt are accountable for securing the resources needed to retire that debt, and for supplying compensating resources to those within the enterprise, or among its customers, who suffer depressed operational effectiveness during the time that technical debt is outstanding.
I call this the “principle of accountability.” It’s a corollary of what Gerald Weinberg calls “Ford's Fundamental Feedback Formula,” which captures the idea that people make better choices when they must live with the consequences of those choices.
An alternative explanation of the effectiveness of the principle of accountability in managing technical debt rests on Robert Fritz’s principle of the path of least resistance. Fritz explains that people “go through life taking the path of least resistance.” As he puts it, “structure determines behavior.” Installing policy structure based on the principle of accountability would place squarely on the path of least resistance those choices that lead to effective technical debt management.
The two scenarios that follow illustrate the function of the principle of accountability. Each scenario has a description, from one person’s perspective, of a situation that leads to new technical debt formation. Each also includes commentary that describes how accountability and resources are allocated under a technical debt management framework (TDMF).
Do you know the true value of your software? Are you sure?
In a Technical Debt Assessment and Valuation, Cutter's Senior Consultants examine the quality of the software under examination through technical and business lenses. Whether that code is your own, has been developed by an acquisition candidate, or by a company you're investing (more) in, Cutter will help you answer the vital question "Is your software an asset or a liability?" Learn more.
For most organizations, these scenarios — for the time being — are far out of reach. Transforming the organization to support these scenarios would be a dramatic change. But that’s the nature of glimpses of possible futures: they’re unreal until we make them real.
Scenario 1: Development-Induced Discovery
As a software engineer, I want my code to communicate to the reader my understanding of what the code is supposed to do. In this project, during development, we learned much about the customer’s need, but too late to capture that learning in code in the way we now recognize was necessary. We want to return to the code after delivery and make it right.
At the end of a project, if we recognize that our deliverable requires or could benefit from additional work that would facilitate maintenance or enhancement, we’ve incurred technical debt. This can be true even if the deliverable works correctly. We can then negotiate with the project sponsor to have him or her post an internal “bond” to secure the debt. That bond is a commitment to fund the debt retirement effort, using some of the sponsor’s future resources. Retiring the debt is in the sponsor’s interest because it improves productivity and velocity for future maintenance or enhancement efforts. Meanwhile, people who must interact with the deliverable in any capacity might suffer depressed productivity until we retire the debt. They can negotiate with the sponsor for resources to cover that marginal increased cost. They can also negotiate with the sponsor for coverage of the cost of revising their assets if needed when the new version of the deliverable is available.
If these negotiations reach an impasse, the parties can turn to the technical debt arbitration panel for a binding resolution. If that is necessary, the parties allocate resources to cover the work of the panel.
Scenario 2: Revenue Priority
As VP of strategic marketing, I’ve determined that we must establish, by the end of our second fiscal quarter, a strong presence in the cybersecurity market for the Internet of Things. The project sponsor and the development team have demonstrated a credible first offering. They have some misgivings about internals, and there are a few external blemishes, but we need to press ahead. The sponsor has agreed to trigger the release process, and I have agreed to press for a little funding for some post-release revisions.
This scenario illustrates the tension between the need for revenue or market presence and the need for sound engineering. All parties understand that the post-release revisions will emphasize enhancing future development productivity and increasing future velocity. Still, strategic marketing might be expected to be reticent about some items on the list that will be developed by product engineering, test engineering, and release engineering.
If these negotiations reach an impasse, the parties can turn to the technical debt arbitration panel for a binding resolution. If that is necessary, the parties allocate resources to cover the work of the panel.
The Elements of the Transformed Organization
This section (from my forthcoming book Technical Debt for Policy Makers) contains a sampling of cultural and policy elements that facilitate the management of technical debt formation. They were developed from an understanding of the mechanisms that lead to technical debt formation, and which prevent technical debt retirement.
Legacy technical debt presents a different problem — one that can be addressed by more conventional means, as a series of projects. But it’s wise to defer, if possible, such efforts until formation of new technical debt is under control because uncontrolled formation of new debt could erase any gains made by retiring legacy debt.
The elements below are in skeleton form. The descriptions emphasize attributes that affect technical debt, but they don’t include many of the essential components of workable policy, such as definitions of standards, audiences, or responsible roles.
Excluded from this abbreviated list are amendment, appeal, and waiver processes, which are similar to corresponding processes for other policy structures, except of course that the adjudicators would necessarily require some expertise in issues relating to technical debt.
The discussion below also omits consideration of the path required to transform a given organization from its current state to one that includes the policies and cultural components suggested. It is nevertheless of some value because consideration of any organizational transformation must begin with the objective. In some ways, such insight is a form of Covey’s habit number two: “Begin with the end in mind.” Briefly, you’re a lot more likely to get where you want to go if you know where you are and where you want to go.
1. Adopt a Shared Concept Vocabulary
Because we cannot manage what we cannot discuss, managing technical debt responsibly requires a shared concept vocabulary. Some necessary terminology, such as the definition of technical debt, is obvious. Examples of concepts more easily overlooked are among the following:
- Done. Clearly define what done means. In project work, ambiguity about the meaning of done can lead to technical debt. As explained below, effectively managing technical debt requires steps that go beyond what most people now do. Those steps must be included in the definition of done.
- Deliberately incurred technical debt. Deliberately incurred technical debt is debt that we incur with intention. In code, knowingly using an obsolete method would be an example of deliberately incurred technical debt. Technical debt incurred deliberately for jointly accepted good reasons is strategic technical debt. Debt incurred deliberately by any means involving subterfuge or incompetence is reckless or possibly unethical.
Martin Fowler has created a 2x2 matrix classification of technical debt. The two axes can be characterized as the degree of wisdom (Fowler calls this “reckless/prudent”) and the degree of intentionality (Fowler calls this “deliberate/inadvertent”). Using Fowler’s Technical Debt Quadrant, we can rate an instance of new technical debt and use that rating when we set interest charges.
- Inadvertently incurred technical debt. Technical debt not deliberately incurred is inadvertently incurred. Following Fowler, inadvertently incurred technical debt can be either reckless or prudent. For example, some Excel 2010 macros became inoperative in Excel 2013. They constituted technical debt. Whether the debt is reckless or prudent depends on the situation.
- Development-induced discovery. Some technical debt arises because, in hindsight, technologists recognize better approaches after the work is completed. The methods they used aren’t wrong, but the work might need revisions for sound engineering reasons. Cutter Fellow Ward Cunningham’s original paper coining the term technical debt cites an example of development-induced discovery.
- Field-revealed discovery. Sometimes the users of an asset discover issues only after they start using it. These items aren’t defects because the asset does what the users expected. But experience reveals opportunities for improvement, and those opportunities can constitute technical debt.
- Total anticipated interest. An important factor in management decisions regarding newly incurred technical debt is its effect on productivity and velocity, commonly regarded as metaphorical interest charges for the debt. While the components of interest related to productivity reduction are beginning to be understood, our understanding of other possibly more important consequences is less advanced. These consequences include loss of market share due to delayed delivery, opportunity costs due to saturation of internal resources, increased help desk load, and more. Decisions regarding technical debt retirement should account for these ongoing “interest-related” effects.
- Debt origination and maintenance costs. Associated with home mortgages are various origination fees: appraisals, credit reports, document preparation, and so on. Technical debt also has origination fees, though we rarely recognize them. For example, careful “borrowers” document new technical debt to facilitate its eventual retirement. Some organizations maintain technical debt backlogs, which also generate costs. Technical debt origination and tracking is not free.
2. Accept That Technical Debt Is a Fact of Technological Life
Although we can avoid some technical debt, we cannot avoid it all. Some technical debt arises because of advances external to the enterprise, beyond its control. Development-induced or field-revealed discoveries are especially difficult to avoid.
The urge to retire all technical debt is likely due to using the word debt, and to deep societal biases against financial debt. Technical debt is not a form of financial debt. Carrying technical debt might not be evidence of a character flaw. In many instances, it’s an inevitable result of using technology.
3. Track the Cost of Carrying Technical Debt
The cost of retiring a particular class of technical debt is significant only when planning or setting priorities for debt retirement. At all other times, knowing that cost has little management value. What does matter is the cost of carrying that technical debt — the metaphorical interest charges. They can fluctuate wildly. Acquire and maintain expertise for estimating and tracking the cost of incurring and carrying each class of technical debt.
4. Assign Accountability for Classes of Technical Debt
Some technical debt results from actions within the enterprise; some does not. To control the formation of new technical debt from internal causes, hold people accountable for the debt their actions generate. Ratings of new technical debt using Fowler’s Technical Debt Quadrant can be the basis for assessing and distributing internal financial accountability for debt retirement and debt carrying charges. For example, a reckless/inadvertent incident could carry a rating that would lead to imposing higher assessed charges for the originators than would a prudent/deliberate incident.
5. Communicate the What, Not the How
Effective technical debt management policy communicates goals, and a framework within which they will be achieved, without prescribing explicitly how to achieve them. Technical debt management policies that specify criteria for making decisions are unlikely to work because of the complexity of modern technologies and the rapid pace of change. Moreover, specifying procedures for avoiding technical debt would be, essentially, a waterfall approach to the problem, requiring comprehensive knowledge of the technical debt situation space — probably an unattainable goal. An approach that empowers practitioners requires far less centralized situational awareness.
Below is an example of a policy that has little chance of contributing to effective technical debt management:
Decisions that require adaptation of technological assets shall be communicated in a timely fashion, so as to give those who must allocate resources, perform maintenance, or create enhancements a reasonable time to complete their work.
This example assumes that, given enough time, the work can be completed without incurring new technical debt. Unfortunately, that assumption is rarely valid for complex systems. The policy is simple and easily communicated, but it provides little guidance with respect to the technical debt problem.
A policy more likely to achieve the objective might be:
Teams making decisions that require adaptation of technological assets shall include in their deliberations representatives of the teams that will be performing the necessary technical work, including development, maintenance, and support. They shall negotiate a mutually agreeable budget and schedule for that work, including a plan for retiring any technical debt incurred.
This example policy relies on the autonomy of the practitioners to avoid incurring technical debt, or, failing that, to plan responsibly for retiring the debt they do incur. By including all roles in the decision process, the policy preserves balance between activities that might generate technical debt (development) and activities that bear the burden of that debt (maintenance and support). Note that, at present, planning for debt retirement is not usually regarded as a responsibility of the teams executing a given development project. Such planning is possible only if other policies support such a culture change.
6. Require That Deliberately Incurred Technical Debt Be Secured
In the financial realm, secured debt is debt whose repayment is guaranteed by specifically pledged assets. By analogy, secured technical debt is technical debt for which resources have been allocated to guarantee retirement.
Deliberately incurred technical debt, whether incurred strategically or recklessly, must be secured. If anyone involved in a development or maintenance effort feels that technical debt has been incurred, a dispassionate third party, unaligned with any function involved in the effort, reviews project deliverables for the presence of technical debt. Allocating future resources might require securing commitments of resources for fiscal periods beyond the current one. For many organizations, such forward commitments might require modifying the management accounting system.
7. Establish a Technical Debt Arbitration Panel
A TDMF depends on people negotiating with each other about allocating resources to secure or retire technical debt. Occasionally, when parties are unable to reach consensus, the technical debt arbitration panel works with them to find a resolution. Members of the panel have mediation skills and expertise in technical debt management for the specific technologies in question. Because the panel’s operating budget is in part covered by charges to the parties it assists, imposing these charges makes the parties accountable for failing to reach consensus.
8. Document Long-Term Strategic Technical Debt
Because of staff volatility, failure to document long-term technical debt leads to loss of understanding of what it is, why it is debt, why it was incurred, why it is long term, where it is, and how it should be retired. Documentation captures this information.
9. Adopt Technical Debt Ratings
Debt that has high interest costs must be rated so high that it is retired immediately. For example, debt in any assets related to cybersecurity would probably have associated with it a high interest charge because the cost of failures can be high enough to threaten the entire enterprise. Eric Allman recommends keeping “a journal of ‘debts that must be repaid before release.’ ” This very prudent recommendation might be too lax. A more conservative approach might include a feature that literally blocks release unless a condition is satisfied within the asset.
Managing technical debt is unlikely to be successful if we rely on enforcement approaches alone. Similarly, success will likely remain elusive if we rely on technical approaches alone, or policy approaches alone. Success will likely be based on finding a workable combination of all three: enforcement, technology, and policy.
The prevalence of technical debt in the technological assets of many organizations suggests that the current combination of these three approaches is not yet ideal. This is unsurprising because, of the three, only technology has received much attention. This condition is itself a form of debt — in this case, organizational debt. Like retiring technical debt, retiring organizational debt is an iterative process that involves gradually increasing our understanding. This Update has sketched the goal, in the form of some attributes of policies that help control technical debt. The form of that goal for any given organization will certainly differ. To discover that unique form, one need only make a start.
More: Articles Like This
- Technical Debt: A Unifying Metric for Governing Software Projects
- The Psychology and Politics of Technical Debt: How We Incur Technical Debt and Why Retiring It Is So Difficult
- Technical Debt: The Continued Burden on Software Innovation-- Opening Statement
- Vendor-Driven Technical Debt: Why It Matters and What to Do About It
- Technical Debt: It's Not the Real Problem
This issue focuses on key topics of interest for financial services organizations, namely equity crowdfunding, legacy systems migration, robo-advisors, test outsourcing, and refining the reconciliation process.
This Advisor presents an overview of improving Agile techniques and practices by using design thinking within the Agile space and describes three techniques from design thinking methodologies that tend to yield benefits to Agile practitioners.
The existence of a digital backbone in an organization means that anyone aspiring and planning to transform different parts of the enterprise can leverage the digital backbone in a consistent and sustainable way, ensuring that each transformation effort connects and leverages a common platform. Digital transformation leaders are starting to realize that a powerful digital services backbone to facilitate rapid innovation and responsiveness is key to successfully executing on a digital strategy.
Can a method like EVM, developed to control projects with well-defined objectives, be applied to control product development initiatives that evolve continuously toward a “moving target”? In an Agile environment, we are faced with the dynamic evolution of a finite boundary of integrated scope, cost, time, and resources; this finiteness — essential for business management and decisions — is the cradle for project management techniques, tools, methods, and frameworks. The EVM method was first developed to help with managing complex R&D projects mostly characterized by an unstable, volatile, and evolving scope. It is therefore no surprise that EVM applies to Agile projects.
It’s a pleasure for me to introduce the first of two special issues of Cutter Business Technology Journal (CBTJ) showcasing the thought leadership and cutting-edge research and development (R&D) being done in State Street Corporation’s Advanced Technology Centres in Europe, the Middle East, and Africa (EMEA) and Asia Pacific (APAC), in partnership with University College Cork (UCC) and Zhejiang University (ZJU), respectively. The articles in this issue represent a small sample of the output from the R&D undertaken in these centers, which combine academic excellence with real industry impact.
Every business must deal with crisis, risk, and compliance challenges. Teams chartered with addressing these challenges are often split across business units and regions, which fragments crisis, risk, and compliance management efforts. Business unit silos and related complexities obscure ecosystem transparency, which in turn constrain an organization’s ability to identify risks, assure compliance, and prevent and disarm crises. Business architecture delivers business ecosystem transparency as a basis for improving a business’s ability to collectively address challenges related to crisis, risk, and compliance.
Organizations are using blockchain to create new business models — exploiting its capabilities for optimizing contract management, financial transaction management, and identity management.
For technology-dependent products, companies, institutions, and even societies, sustainability depends on learning how to manage technical debt. Like most transformations, incorporating new practices into our organizations will likely be an iterative process. We already recognize the problem, and researchers are making progress, albeit mostly on technical issues. This Executive Update proposes a policy-centered approach to the problem. It begins with a principle that can serve as a guide for constructing technical debt management policy, and then shows how to apply that principle to develop nine recommendations that enable organizations to manage technical debt effectively.
Agile methodologies, however popular they are, bring their own sets of “smells” and anti-patterns to the table, sometimes causing irreparable damage to the team. While the sources of these smells are many, one of the primary culprits is the mindset that treats Agile as “yet another methodology,” totally ignoring the cultural aspect. This article throws light on some of the prominent smells that are emerging of late in the Agile world.
If you start changing an organization toward an Agile mindset, there’s no real end. Agile is about creating an organization of continuous learning and the transformation is done when there is nothing new to learn, which will probably be never. This puts an enormous challenge on middle management.
The articles in this issue present perspectives and ideas on business transformation in the digital age. We hope they will inspire and encourage you to visualize the likely future of business in your domain and to explore the opportunities it presents. Finally, we hope their insights will help you identify suitable transformation strategies and plans and, if needed, choose viable collaboration models for partnering with startups and other firms in your digital business efforts.
Beyond buzzwords, what we are seeing is a seismic shift in the role of technology in organizations. Technology is more and more embedded in everything we do as we move into an increasingly hyper-connected digital world, a world in which technology is driving significant social, organizational, and industry change.
In this on-demand webinar, you'll discover the strategic and tactical opportunities made possible by Digital Data Streams and the opportunities for improved customer experience made possible by DDS.
At the Cutter Digital Transformation & Innovation Bootcamp, Cutter Fellow and Harvard Business School Professor Karim Lakhani talked about digitally-driven disruption of traditional business models for value creation and capture, discussing platform models like Facebook and Twitter. To date, Twitter has clearly done a good job “creating value.” But unlike Facebook, it continues to struggle with the capture part of the equation.
Social collaboration is not about technology. It’s about connecting people, and it’s changing the way business is being conducted. Similarly, gamification is not about games. It’s about motivating the personal and professional behaviors that drive business value. Together, social collaboration and gamification help companies reap great benefits — among them, the ability to deepen customer relationships, drive operational efficiencies, and optimize their workforce.
Roadmaps have two key functions in strategy planning. The first is to outline planned architectural changes that will deliver the required strategies; the second is to outline alternative ways to achieve the same results.
Just as recent global events have given us reason to pause and reflect, the pace of technology emergence and disruption is proving to be a source of inspiration and uncertainty. Transitioning to a digital world is front-of-mind for many business executives, yet finding the right path is an ongoing challenge. So we asked Cutter’s team of experts for their insights on some of the technologies, trends, and strategies that will be relevant in 2017 and beyond. In typical Cutter Business Technology Journal fashion, our call produced a wide range of opinions and reflections worthy of consideration as you chart your business technology journey for the new year.
Artificial general intelligence (AGI) is currently emerging as an area where recent developments are likely to have a major impact on the way organizations do business, societies organize themselves, and even on how we address values and ethics.
The fact is that AGI already exists in our daily life. A common example is the GPS systems present in many new cars manufactured today; and let’s not forget the drones being used to deliver pizzas and cars that drive themselves. While automatic pilots have been used in commercial planes for quite some time, what AGI is about to offer to general business and human activity is well beyond what most of us have seen so far.
2017 is going to be a year of strange winners, and perhaps the strangest of all will be a giant leap away from technology and back to solutions that don’t rely on 24/7 connectivity. With the onslaught of major hacks and Facebook embarrassment, the antitech crowd may have its best year in decades.
One of the most prevalent blockchains in the world, Ethereum, is poised to switch from a proof-of-work (POW) algorithm to a proof-of-stake (POS) algorithm, likely in 2017, with the release of the Casper codebase. Why does this matter? Because blockchain technology is becoming increasingly relevant and prevalent in businesses across the globe. It holds great potential to disrupt how businesses perform basic transactions, from payments, to programmable, self-executing contracts, to identity verification.