Technical Debt

You might say

AI said to implement it this way for now and refactor later. What does that mean?

The future cost left by shortcuts taken to deliver quickly, which grows the longer it staysTaking quick shortcuts or hardcoding logic to meet tight deadlines leaves structural compromises that increase future maintenance costs. Technical debt is not an outright crash but a deliberate tradeoff; having to touch five separate files just to update one button style is the ongoing interest paid on early compromises. The longer it is deferred, the riskier and costlier refactoring becomes.

Know first

Component

Technical Debt

One debt from creation to payoff: the button style case

Before failure

home.csspricing.cssblog.cssdocs.cssapp.css

Shared component (not yet created)

ButtonReferenced in 5 places

The same button style is written separately in 5 files; miss one and the page looks wrong.

The case in five steps

Before: one change touches five places: The same button style is written separately in 5 files; miss one and the page looks wrong.

What was added: a shared component: Move the repeated style into one shared component and reference it in all 5 places; edit points drop from 5 to 1.

Feedback and boundary: After the change, verify each page's button appearance is unchanged—pages that changed are the spots still missed. Paying off this debt does not prevent new ones; every time-saving special case creates new debt.

Quick checkChoose the best answer

The same button style is written separately in 5 files. Should you stop now to clean it up?

Record this debt and its impact first, then decide when to pay it off by current task priorityLeave it alone; if the code runs, that is fineStop all feature work immediately and rewrite the whole project

You can say this to an AI Agent

This button style is duplicated in 5 files. First explain the debt's impact, then move the repeated style into one shared component that all 5 places reference. Afterward, verify each page's button appearance is unchanged and tell me where to edit when adding a new button.

Learn next

1Component→2Quality Gate→

Recommended tool

Web fine-tuning tool · Selector Pro

Select page elements for precise AI edits

Click a button, text, or card, note the change, then copy its exact location to AI.

Open Selector Pro website