Открытый код как доказательство работы

Артефакт, а не сертификат

Публичный репозиторий может показать код, историю изменений, тесты и документированные решения. Сам по себе он не доказывает, что система работала в production, принесла бизнес-результат или прошла независимый аудит.

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

Доказательная цепочка

1. Утверждение точно определяет, что должно наблюдаться.
2. README указывает версию, охват и команду запуска.
3. Тест проверяет свойство, названное в утверждении.
4. История изменений показывает, как был получен результат.
5. Ограничения объясняют, чего репозиторий не раскрывает.

Что раскрывает история

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

Количество коммитов не является метрикой качества. Важна читаемость связи между проблемой, изменением и проверкой.

Риск демонстрационного проекта

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

Практика публикации

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