Часто задаваемые вопросы

Provenance Manifesto — это предложение о том, как организациям следует управлять решениями, формирующими их системы, и сохранять их.

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

Provenance Manifesto предлагает рассматривать решения как артефакты первого класса, происхождение которых — контекст, обоснование, альтернативы и эволюция — должно сохраняться как часть организационного знания.

Манифест обращается к широко распространённой проблеме, известной как потеря организационного контекста.

Важные решения обычно распределены между встречами, чатами, проектной документацией и pull request. Со временем обоснование этих решений исчезает. Новым инженерам приходится заново открывать те же ограничения, повторять те же архитектурные обсуждения и воссоздавать те же обходные решения.

Это приводит к повторному открытию архитектурных решений, хрупкой институциональной памяти, более долгому онбордингу, скрытым предположениям в системах и инструментам AI, которые генерируют ответы без исходного контекста решений.

Decision provenance означает прослеживаемое происхождение, контекст и эволюцию решения.

Хорошо сохранённое решение обычно включает:

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

Происхождение решений объясняет почему система существует в своей текущей форме, а не только то, что система делает сегодня.

Традиционная документация описывает системы. Происхождение решений объясняет как и почему эти системы появились.

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

Provenance Manifesto предлагает, чтобы решения стали основной единицей знания, из которой можно восстанавливать документацию, объяснения и рассуждения, генерируемые AI.

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

Без происхождения решений системы AI могут объяснить, что делает система, но испытывают трудности с объяснением, почему она была спроектирована именно так.

Например, инструменты AI могут не знать:

• почему был выбран определённый архитектурный компромисс
• почему в системе существует конкретное ограничение
• почему было введено обходное решение
• почему был отклонён альтернативный подход

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

Architecture Decision Records (ADR) являются важным шагом к сохранению архитектурного контекста решений. Однако во многих организациях ADR остаются статическими документами, хранящимися в репозиториях.

Provenance Manifesto предлагает более широкую модель, в которой решения:

• являются эволюционирующими артефактами, а не статическими записями
• связаны с другими решениями и событиями
• становятся организационным знанием, доступным для запросов
• интегрируются с процессами разработки и системами AI

В этой модели решения формируют эволюционирующий организационный граф решений, а не изолированные документы.

Provenance Manifesto предназначен для людей, участвующих в проектировании, создании и эксплуатации сложных систем.

К ним относятся инженеры-разработчики, системные архитекторы, руководители инженерных команд, продуктовые лидеры, исследователи в области разработки с использованием AI, а также организации, создающие системы, основанные на знаниях.

Любой, кто заинтересован в улучшении того, как организации сохраняют и развивают инженерное знание, может участвовать в обсуждении.

Нет. Provenance Manifesto описывает принципы, а не продукт.

Организации могут реализовывать эти идеи с использованием различных технологий и подходов, включая Architecture Decision Records, структурированные системы знаний, графовые модели знаний, среды разработки с поддержкой AI или управленческие рамки для управления решениями.

Манифест намеренно является технологически нейтральным, чтобы идеи могли развиваться в различных экосистемах.

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

DevOps изменил то, как команды управляют поставкой, инфраструктурой и операциями.

Provenance Manifesto фокусируется на том, как организации управляют решениями и институциональной памятью.

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

Нет. Как и другие манифесты в истории программной инженерии, Provenance Manifesto предполагает развитие через обсуждение, критику и сотрудничество.

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

Существует несколько способов внести вклад в развитие Provenance Manifesto.

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

Руководство по участию доступно в репозитории проекта.

Provenance Manifesto был инициирован Yauheni Kurbayeu на основе исследований и обсуждений о происхождении решений, организационной памяти и разработке программного обеспечения с поддержкой AI.

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

Вы можете ознакомиться с манифестом и его принципами здесь:

https://provenancemanifesto.org

Дополнительные статьи и обсуждения раскрывают идеи происхождения решений, институциональной памяти и сохранения знаний в современных программных системах.