Skills

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

Критерий, написанный после реализации, описывает реализацию. Сначала напишите падающую проверку, убедитесь, что она падает, и только потом стройте.

Настройка, которая успешно сохраняется и ничего не меняет до перезапуска, хуже той, что завершается ошибкой. Укажите, когда она вступает в силу, и выводите это из того места, где её читают.

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

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

Цикл повторов, перезаписывающий переменную с обратной связью, показывает третьей попытке только провал второй — и она заново выводит патч, который уже пробовала первая.

Берите сигнатуру из установленной версии, а не из памяти: правдоподобный API неотличим от настоящего, пока не будет запущен.

Всё, что скопировано вручную из другого файла, верно ровно один раз. Если это можно сгенерировать — генерируйте, и роняйте build, когда копия устарела.

Генератор, который падает, сообщает, что он не справился; генератор, выдающий правдоподобный результат, не сообщает ничего. Проверяйте, что он нашёл, а не то, что он отработал.

Регрессионный тест, падения которого вы никогда не видели, — это догадка. Сломайте код обратно и убедитесь, что тест краснеет, прежде чем его коммитить.

Диагноз — это утверждение о машине, которую вы не запускали. Сначала воспроизведите сбой одной короткой командой — особенно если диагноз пришёл от кого-то другого.

Запускайте команду проверки проекта буквально — тот же охват, те же флаги. Почти идентичный вариант, придуманный вами на ходу, врёт в обе стороны.

Класс, собранный вручную в тесте, доказывает, что класс работает, а не что до него что-то доходит, — покрывайте тот путь, которым система идёт в production.

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

Прежде чем сообщить, что задача выполнена, запустите проверку, которая упала бы, если бы это было не так, — объяснение не является исправлением.

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

Рейтинг, построенный по части системы, читается как рейтинг всей системы — пишите охват и исключения рядом с выводами, а не после них.

Когда два ваших собственных измерения расходятся настолько, что ни один механизм такого дать не может, дефект в инструменте. Проверьте harness, прежде чем строить на нём теорию.

Число и оговорка к нему должны быть одним артефактом. Два абзаца расходятся; один компонент — не может.

Публикуйте эксперимент, который не удался, сохраняйте отменённый неизменным и никогда не перезапускайте ради значимости. Смещение — в отборе, а не в числе.

Проверка, добавленная после того, что она охраняет, — это проверка, которую кто-нибудь отключит ради релиза. Замкните её, пока блокировать нечего.

Проверка, перечисляющая, что проверять, работает как fail-open — ломается именно тот сайт, который никто не вспомнил добавить. Перечисляйте вместо этого исключения, каждое с записанной причиной, и поведением по умолчанию станет отказ.

Пустой экран, вкладка или категория — это обещание, которого продукт не выполняет. Скройте их, пока в них нет содержимого, или пока не стройте вовсе.

Предупреждение, помещённое после действия, к которому оно относится, приходит, когда читатель уже принял решение. Ставьте его выше и делайте неотклоняемым, когда это важно.