Точка правды: как заставить проект не врать самому себе
Один источник правды для всех чисел проекта — и процедура сверки, которая ловит собственные ошибки до того, как их увидит кто-то другой.
Проект растёт — и числа расходятся: в одном файле «11 базовых», в другом «76 подтверждений», в третьем ещё как-то. Каждый файл уверен в своей версии.
Заводишь один файл — точку правды. Все числа сначала меняются в нём, потом в производных. Сверка ловит расхождения — и находит собственные ошибки.
Живой пример — не выдумка. Это карта из реального проекта: 5 циклов, 48 источников, правило «способность засчитывается только после 3 подтверждений на 3 независимых корпусах». Числа быстро начали расходиться между файлами — классическая болезнь любого растущего проекта с AI.
Решение — не «быть внимательнее», а процедура. Один файл объявляется точкой правды. Инвариант жёсткий: любое число сначала меняется здесь, потом в производных (таблица, визуал, сводка). Визуал — производная от данных, никогда наоборот.
Как это выглядит
Сверка прогоняется по всем файлам и выписывает расхождения. В этом проекте она нашла шесть собственных ошибок: «11 базовых» вместо 10 (один пункт оказался агрегатом трёх других), неверное число корпусов у одной способности, «76 подтверждений» вместо реальных 138, устаревший на целый цикл визуал, и легенду, которая закрепляла нарушение собственного правила. Всё это — до того, как цифры ушли бы наружу.
Важно
Ценность не в красивой таблице, а в том, что процедура ловит ошибки автора. AI отлично держит инвариант «правда живёт в одном месте» — если его явно задать. Без точки правды любой проект из десятка файлов рано или поздно начинает противоречить сам себе.
Собери для моего проекта «точку правды»: один файл, где живут все ключевые числа и правила. Опиши инвариант — любое изменение сначала сюда, потом в производные. Затем сверь остальные файлы с ним и выпиши все расхождения списком: где, что было, что должно быть.