Квадрант технического долга

Долг — это финансовая метафора, а не синоним «плохого кода». Займ что-то тебе покупает — релиз до дедлайна, проверку идеи до вложений в неё. Цена — это процент: каждое будущее изменение области, нашпигованной срезанными углами, чуть медленнее и чуть рискованнее, и ты платишь этот процент, пока не «погасишь тело долга» рефакторингом. Решение, которое важно, — то же, что принимает финансовый директор: стоит ли то, что этот займ покупает, процента, который ты заплатишь, и есть ли у тебя план обнулить баланс до того, как процент съест выигрыш?

// «Долг»: намеренно узкий срезанный угол, взятый ради релиза MVP.
// Мы делаем частный случай для единственного существующего сегодня плана,
// вместо общего биллингового движка, который пока не оправдан.
function priceFor(plan: Plan): number {
  if (plan === "pro") return 20_00; // центы; единственный платный план на старте
  return 0; // бесплатный
}

Это не «плохо» — это занято. Процент — это то, во что обойдётся следующее изменение: в день, когда появится второй платный план, этот if должен будет вырасти, как и каждое место, предполагавшее одну цену. Эта будущая цена и есть процент. Назвать её долгом — а не ошибкой — это то, что позволяет о ней рассуждать.

У квадранта Фаулера две оси, и они отвечают на разные вопросы. Первая ось — намеренный против ненамеренного — спрашивает «знали ли мы, что берём долг?» Вторая — разумный против безрассудного — спрашивает «было ли это хорошим решением при том, что мы знали?» Их пересечение даёт четыре очень разные ситуации, которые единственное слово «долг» прячет:

• Намеренный + разумный: «Сделать как надо нет времени, релизим сейчас, рефакторим после запуска — вот план.» Осознанный, оценённый компромисс.
• Намеренный + безрассудный: «Сделать как надо нет времени.» Точка. Ты выбрал беспорядок, без плана и без расчёта процента.
• Ненамеренный + разумный: «Теперь мы знаем, как надо было это спроектировать.» Честное обучение — ты не мог узнать лучшую форму, пока не построил первую.
• Ненамеренный + безрассудный: «А что такое слои?» Ты взял долг, потому что не знал, что дизайн существует — и не знал, что не знаешь.

Сигнал зрелости — в каком квадранте оказываются твои срезанные углы. Разумно-намеренный долг — это инструмент. Остальные три — предупреждения разного рода: о нехватке дисциплины, о нехватке знаний или о том и другом.

Неучтённый долг — самый опасный, потому что невидимый процент копится сложно. Срезанный угол, который ты записал — с обоснованием и триггером погашения, — это известное обязательство, под которое можно планировать. Срезанный угол, который никто не зафиксировал, — это процент, накапливающийся в темноте: каждое последующее изменение обходит его, жёстко завязывается на него, надстраивается над ним, пока «быстрая правка из первого квартала» не станет несущей, а тело долга — уже не погашаемым ни за какую разумную цену. Видимость — это весь механизм, который держит разумный долг разумным.

// Сделай долг ВИДИМЫМ: не голый TODO, а запись о долге с
// (1) что заняли, (2) почему, (3) процент, (4) триггер погашения.
// DEBT(billing): единственная жёстко зашитая цена плана — релиз MVP 01.06.
//   Почему: один платный план на старте; биллинговый движок пока не оправдан.
//   Процент: каждый новый план трогает эту fn + всех вызывающих с одной ценой.
//   Гасить когда: в дорожную карту попадает ВТОРОЙ платный план. Владелец: @billing.
if (plan === "pro") return 20_00;

Голый // TODO: fix later — это не оно. Он не фиксирует ни обоснования, ни цены, ни триггера — поэтому никогда не приоритизируется и становится археологическим шумом, через который переступает следующий читатель. Дисциплина не в том, чтобы «оставлять TODO»; она в том, что «каждый намеренный срезанный угол оставляет запись о долге, с которой может работать планировщик».

Решение взять долг намеренно — это настоящий инженерный инструмент, как и решение отказаться. Разумно-намеренный долг законен, когда выполняются три условия: то, что ты покупаешь (срок, обучение), действительно стоит больше процента; процент ограничен и ты можешь его оценить; и есть письменный триггер, заставляющий погасить долг до того, как баланс начнёт расти сложно. Когда они выполнены, «релизим сейчас, рефакторим после запуска, вот план» — это правильный senior-ход, а не признание вины.

// Сортировка, не вина. Вопрос в проценте, а не в несовершенстве.
type DebtCall = "take-it" | "pay-now" | "leave-it";

function triage(d: { boundedInterest: boolean; hasTrigger: boolean; blocksShip: boolean; risk: "low" | "high" }): DebtCall {
  if (d.risk === "high" && d.blocksShip) return "pay-now";          // занимать здесь безрассудно
  if (d.boundedInterest && d.hasTrigger && d.blocksShip) return "take-it"; // разумный намеренный
  return "leave-it"; // не на пути изменений → не плати процент, гоняясь за ним
}

Режим отказа, от которого это защищает, — паралич: клеймить каждое несовершенство как долг и пытаться починить всё до релиза. Большинство «несовершенств» лежат в стороне от пути любого изменения, которое ты реально сделаешь — гасить их значит тратить процент впустую. Откажись от долга, когда он безрассуден (высокий риск, нет плана); возьми его, когда он разумен и оценён; и оставь косметику, которой ни одно реалистичное изменение никогда не коснётся. Знать, когда не платить, так же по-senior, как знать, когда занимать.