Правило трёх

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

// Появление #1
function priceForBook(b: Book) {
  return b.basePrice * 1.2; // VAT
}

// Появление #2 — выглядит как та же форма с другой ставкой
function priceForEbook(e: Ebook) {
  return e.basePrice * 1.07; // reduced VAT
}

Соблазнительно вынести priceWith(rate). Но ставка ли реальная ось? Или следующий случай будет варьироваться по региону, по типу клиента, по промо-переопределению? Две точки задают прямую, и прямая через две точки всегда ложится идеально — именно поэтому она ничего не говорит о том, где окажется третья точка.

Преждевременная абстракция угадывает ось неверно, а потом окостеневает в неправильной форме. Опасность не в напрасно потраченных усилиях на ранний вынос — она в том, что ранняя абстракция связывает тебя обязательством. Как только три вызывающих зависят от priceWith(rate), эта сигнатура становится несущей. Когда реальная вариация оказывается региональными налоговыми таблицами, ты не можешь просто поменять абстракцию — тебе приходится с ней воевать: добавить второй параметр, протянуть флаг, сделать частный случай для одного вызывающего, и хелпер обрастает сложностью, чтобы покрыть форму, под которую он никогда не проектировался.

// Во что вырождается «выноси на втором» к пятому вызывающему:
function price(base: number, rate: number, region?: Region,
               isExempt?: boolean, override?: number) {
  if (override != null) return override;
  if (isExempt) return base;
  const r = region ? rateFor(region) : rate; // исходный `rate` теперь рудимент
  return base * r;
}

Каждый флаг — это рубец от неверной догадки. Абстракция теперь скрывает больше, чем разделяет.

Дублирование дешевле неправильной абстракции — пока паттерн не прояснился. Это senior-инверсия юниорского инстинкта. Юниорское рассуждение: «дублирование всегда плохо, устрани его сейчас». Senior-рассуждение: у дублирования известная, ограниченная стоимость — N копий, каждую можно править на месте, каждая независимо корректна. У неправильной абстракции неизвестная, растущая стоимость — все вызывающие теперь связаны через форму, которая не подходит, и распутать её труднее, чем если бы они оставались порознь, потому что сначала нужно обратно встроить абстракцию, прежде чем удастся разделить их правильно.

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

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

// НЕ кандидат для правила трёх — это один факт, скопированный:
const fee = subtotal * 0.029 + 30;   // billing.ts
const fee = subtotal * 0.029 + 30;   // refund.ts
const fee = subtotal * 0.029 + 30;   // report.ts   ← 0.029 в 12 файлах — баг в ожидании дрейфа

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