Когда-то давно у меня был первый научный руководитель в аспирантуре и мы с ним писали код на ассемблере

Когда-то давно у меня был первый научный руководитель в аспирантуре и мы с ним писали код на ассемблере. Покадровую обработку специфического видеопотока в реальном времени. Я сидел на работе, писал, а руководитель заглядывал 1–2 раза в неделю, проверить, помочь, обсудить. Каждый раз, когда он приходил, мы начинали с получасового разбора его тетради с записями алгоритмов и примерных реализаций по проекту. Меня, молодого, это просто бесило: зачем тратить 30–40 минут на рекап, когда очевидно, что это сделано, сделано именно так, мы это проверяли в прошлый (и позапрошлый) раз, и да, я помню, что дальше нужно писать, забудешь тут.

Однако чем старше становишься, тем больше смысла в этом видишь. Должен быть единственный источник истины. В данном случае, тетрадь руководителя. Мало ли что ты там написал в коде. Мало ли что ты задумал ещё сделать. Кто и когда будет это за тобой проверять и переделывать? Сколько времени на это уйдет, если мы сначала не сверимся с тем, как должно быть?

Вот, например, прошлогодняя история про сгоревший медиаконвертер. В спешке и угаре я полдня убил на настройку домового роутера под резервный канал, пробуя так и эдак и не зная, что сразу всё настраивал правильно. Надо было просто убедиться, что канал работает в «нормальных условиях» — воткнуть LTE-модем в нотбук, загрузить винду, и получить Proof of Concept, то есть подтверждение работоспособности. Оно же в данном случае — временный источник истины: модем точно работает (или нет) и ты точно можешь теперь знать, что дело в твоих настройках (или нет), а не в тонких вибрациях вселенной. Сделай я эту простую проверку — вместо половины дня настройка заняла бы 15 минут.

В совместной работе все ровно так же. Если тимлид, или продакт, или кто-то еще хочет проговорить реализуемую концепцию — это не потому что он старый и память не та. Это потому, что разработчики регулярно понимают по-разному, начинают делать не то, или теряют куски контекста не хуже нейросетей. И это не гипотеза, это эмпирические данные. Несмотря на то, что в 2025 году сделать доступный всем источник истины технически гораздо проще.

Так что не нужно стесняться зачитывать вслух, проговаривать и повторять. И тем более не нужно осуждать тех, кто так делает. Это не плохая память, это опыт, вдумчивость и уважение к общему результату.