Провенанс — это не про инструменты. Это про образ мышления.

Author: Yauheni Kurbayeu
Published: Mar 15, 2026

За последние месяцы, исследуя идею происхождения решений (decision provenance) в разработке программного обеспечения, я заметил одну интересную вещь. Большинство людей сначала воспринимают Provenance Manifesto как предложение о новых инструментах, новых стандартах документации или новых процессах.

Но такая интерпретация упускает главную мысль.

Манифест в первую очередь не о смене инструментов.
Он о смене того, как мы думаем о знаниях, решениях и ответственности в инженерных организациях.

И эта перемена намного сложнее, чем внедрение новой системы.

Скрытое предположение современной инженерии.

Десятилетиями разработка программного обеспечения жила с негласным предположением:

Обоснование систем хранится в головах людей.

Мы очень хорошо сохраняем артефакты реализации:

• Код в репозиториях
• Задачи в трекерах
• Документацию в базах знаний
• Инфраструктуру в конфигурационных системах

Но самая важная часть системы — почему решения были приняты именно так — обычно находится где‑то ещё.

Она живёт в:

• дизайн‑встречах
• тредах Slack
• архитектурных обсуждениях
• личной памяти

Со временем это обоснование постепенно исчезает.

• Архитекторы меняют роли
• Инженеры переходят в другие команды
• Менеджеры покидают компании

Система остаётся, но контекст, который её создал, растворяется.

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

Эпоха AI‑augmentation резко меняет эту динамику.

Почему Provenance Manifesto — это про образ мышления.

Когда люди слышат идею фиксировать решения как структурированные артефакты, первая реакция обычно техническая:

• «Это ещё одна система документации?»
• «Это просто ADR?»
• «Это ещё один инструмент, который нужно поддерживать?»

Но provenance — это не проблема документации.

Это смена мышления.

Идея проста, но мощна:

Сами решения должны стать первоклассными артефактами системы, так же как:

• код
• инфраструктура
• API

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

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

Это означает фундаментальное изменение того, как организации относятся к знаниям.

Мы переходим от:

индивидуальной памяти к институциональной памяти

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

Почему люди сопротивляются фиксации своих решений.

Сопротивление этой идее редко связано с инструментами или дополнительной нагрузкой.

Обычно причина глубже.

Во многих профессиях, основанных на знаниях, действует простое правило:

Контекст — это власть.

Человек, который помнит почему система работает именно так, обладает влиянием. Он становится интерпретатором прошлых решений. Он становится источником объяснений, когда что‑то ломается.

На практике это создаёт невидимую иерархию, основанную на приватных знаниях.

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

Сохранение provenance решений меняет эту динамику.

Когда обоснование становится частью самой системы:

• знания становятся доступными для всех
• контекст становится поисковым
• авторитет становится прозрачным и отслеживаемым

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

Это одна из причин, почему фиксация решений исторически происходила очень непоследовательно.

Дело не в том, что команды не могут документировать решения.

Дело в том, что культурно они часто этого не делают.

Почему AI‑сдвиг делает проблему срочной.

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

AI‑агенты могут генерировать код быстрее, чем команды способны осмыслить последствия.

В результате настоящее узкое место разработки меняется.

Это уже не написание кода.
Это понимание решений, стоящих за системой.

Без сохранённого контекста решений:

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

Чем быстрее эволюционируют системы, тем опаснее становится потеря контекста.

Поэтому provenance — не просто интеллектуальная идея.

Это становится структурным требованием для AI‑augmented разработки.

Что мы можем начать делать уже сейчас.

Хорошая новость в том, что принятие мышления provenance не требует ожидания новых платформ или сложной инфраструктуры.

Организации могут начать уже сегодня, следуя простому принципу:

Сохраняйте решения везде, где AI участвует в процессе разработки.

На практике это означает фиксировать обоснование работы, связанной с:

• AI‑ассистентами
• автоматизацией
• agent‑driven исполнением

Например:

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

Эти артефакты могут происходить из разных источников:

• транскриптов встреч
• архитектурных ревью
• планов выполнения AI
• follow‑up‑резюме
• Architecture Decision Records

Ключевое изменение не в формате.

Ключевое изменение — в намерении сохранять обоснование как часть системы.

Сохраняя человека в контуре.

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

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

Практический процесс может выглядеть так:

1. Разговоры и встречи фиксируются
2. AI извлекает кандидатные решения, предположения и риски
3. Ответственный человек проверяет и подтверждает структуру
4. Подтверждённое решение становится частью памяти системы

Так человеческое понимание остаётся в контуре, а AI помогает масштабировать процесс фиксации знаний.

Начало организационной памяти.

В конечном итоге Provenance Manifesto предлагает простую, но мощную идею.

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

• Код описывает что делает система.
• Decision provenance объясняет почему система стала такой, какой она стала.

В AI‑augmented мире оба элемента критически важны.

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