Häufig gestellte Fragen

Das Provenance Manifesto ist ein Vorschlag dafür, wie Organisationen die Entscheidungen verwalten und bewahren sollten, die ihre Systeme prägen.

Moderne Softwaresysteme entstehen nicht nur aus Code. Sie werden durch Tausende von Entscheidungen geformt: architektonische Wahlmöglichkeiten, Trade-offs, Annahmen, operative Reaktionen und Produktüberlegungen. In den meisten Organisationen werden diese Entscheidungen in Meetings oder Chats diskutiert und verschwinden mit der Zeit.

Das Provenance Manifesto schlägt vor, Entscheidungen als Artefakte erster Klasse zu behandeln, deren Provenienz — Kontext, Begründung, Alternativen und Entwicklung — als Teil des organisatorischen Wissens bewahrt werden muss.

Das Manifest adressiert ein weit verbreitetes Problem, das als Verlust organisatorischen Kontexts bekannt ist.

Wichtige Entscheidungen sind oft über Meetings, Chatverläufe, Designdokumente und Pull Requests verteilt. Mit der Zeit verschwindet die Begründung hinter diesen Entscheidungen. Neue Ingenieure müssen dieselben Einschränkungen erneut entdecken, dieselben architektonischen Diskussionen führen und dieselben Workarounds wieder aufbauen.

Dies führt zu wiederholter Wiederentdeckung architektonischer Entscheidungen, fragiler institutioneller Erinnerung, längeren Onboarding-Zeiten, versteckten Annahmen in Systemen und KI-Werkzeugen, die Antworten ohne den ursprünglichen Entscheidungskontext generieren.

Decision Provenance bezeichnet den nachvollziehbaren Ursprung, Kontext und die Entwicklung einer Entscheidung.

Eine gut bewahrte Entscheidung umfasst typischerweise:

• das zu lösende Problem
• den damaligen Kontext und die Einschränkungen
• betrachtete Alternativen
• die Begründung für den gewählten Ansatz
• die für die Entscheidung verantwortlichen Personen
• die spätere Entwicklung der Entscheidung

Decision Provenance erklärt warum ein System in seiner heutigen Form existiert, nicht nur was das System aktuell tut.

Traditionelle Dokumentation beschreibt Systeme. Decision Provenance erklärt wie und warum diese Systeme entstanden sind.

Dokumentation beschreibt typischerweise den aktuellen Zustand eines Systems. Da sich Systeme weiterentwickeln, veraltet Dokumentation schnell. Entscheidungen hingegen bilden die Begründungskette hinter der Systementwicklung.

Das Provenance Manifesto schlägt vor, dass Entscheidungen zur primären Wissenseinheit werden, aus der Dokumentation, Erklärungen und KI-generierte Begründungen rekonstruiert werden können.

Systeme der künstlichen Intelligenz können Code-Repositories, Dokumentation und Commit-Historien lesen. Diese Quellen enthalten jedoch selten die vollständige Begründung hinter Designentscheidungen.

Ohne Decision Provenance können KI-Systeme erklären, was ein System tut, haben jedoch Schwierigkeiten zu erklären, warum es so entworfen wurde.

Zum Beispiel wissen KI-Werkzeuge oft nicht:

• warum ein bestimmter architektonischer Trade-off getroffen wurde
• warum eine Einschränkung im System existiert
• warum ein Workaround eingeführt wurde
• warum ein alternativer Ansatz verworfen wurde

Wenn Decision Provenance bewahrt wird, erhalten KI-Systeme Zugang zur Begründungsebene technischen Wissens und können Menschen mit tieferen Erklärungen und Analysen unterstützen.

Architecture Decision Records (ADR) sind ein wichtiger Schritt, um architektonische Entscheidungsbegründungen zu bewahren. In vielen Organisationen bleiben ADRs jedoch statische Dokumente in Repositories.

Das Provenance Manifesto schlägt ein breiteres Modell vor, in dem Entscheidungen:

• sich weiterentwickelnde Artefakte statt statischer Dokumente sind
• mit anderen Entscheidungen und Ereignissen verbunden sind
• als organisatorisches Wissen abfragbar werden
• in Entwicklungs-Workflows und KI-Systeme integriert sind

In diesem Modell bilden Entscheidungen einen sich entwickelnden organisatorischen Entscheidungsgraphen statt isolierter Dokumente.

Das Provenance Manifesto richtet sich an Menschen, die komplexe Systeme entwerfen, entwickeln und betreiben.

Dazu gehören Softwareentwickler, Systemarchitekten, Engineering-Leiter, Produktverantwortliche, Forschende im Bereich KI-gestützte Entwicklung sowie Organisationen, die wissensbasierte Systeme aufbauen.

Jeder, der daran interessiert ist, wie Organisationen technisches Wissen besser bewahren und weiterentwickeln können, kann an der Diskussion teilnehmen.

Nein. Das Provenance Manifesto beschreibt Prinzipien, kein Produkt.

Organisationen können diese Ideen mit unterschiedlichen Technologien und Ansätzen umsetzen, etwa mit Architecture Decision Records, strukturierten Wissenssystemen, graphbasierten Wissensmodellen, KI-gestützten Entwicklungsumgebungen oder Governance-Frameworks für Entscheidungsmanagement.

Das Manifest ist bewusst technologieagnostisch, damit sich die Ideen über verschiedene technische Ökosysteme hinweg weiterentwickeln können.

Agile hat verändert, wie Teams Arbeit und Zusammenarbeit organisieren.

DevOps hat verändert, wie Teams Delivery, Infrastruktur und Betrieb organisieren.

Das Provenance Manifesto konzentriert sich darauf, wie Organisationen Entscheidungen und institutionelles Wissen verwalten.

Es adressiert eine andere Ebene des Softwarelebenszyklus: die Begründungen und den Kontext, die Architektur, Produktentwicklung und operative Abläufe steuern.

Nein. Wie andere Manifeste in der Geschichte der Softwareentwicklung ist auch das Provenance Manifesto darauf ausgelegt, sich durch Diskussion, Kritik und Zusammenarbeit weiterzuentwickeln.

Sein Ziel ist es, eine breitere Diskussion darüber zu beginnen, wie Organisationen Entscheidungsprovenienz und institutionelles Wissen im Zeitalter künstlicher Intelligenz verwalten sollten.

Es gibt mehrere Möglichkeiten, zur Weiterentwicklung des Provenance Manifesto beizutragen.

Sie können die Ideen öffentlich diskutieren, Verbesserungen am Manifest vorschlagen, Übersetzungen beitragen, bei der Weiterentwicklung der Prinzipien helfen oder reale Erfahrungen im Umgang mit Decision Provenance und organisatorischem Wissen teilen.

Richtlinien für Beiträge finden Sie im Projekt-Repository.

Das Provenance Manifesto wurde von Yauheni Kurbayeu initiiert, basierend auf Forschung und Diskussionen über Decision Provenance, organisatorisches Gedächtnis und KI-gestützte Softwareentwicklung.

Das Ziel ist nicht, ein persönliches Projekt zu schaffen, sondern eine offene Diskussion innerhalb der Engineering-Community darüber anzustoßen, wie Entscheidungswissen bewahrt und gesteuert werden sollte.

Sie können das Manifest und seine Prinzipien hier erkunden:

https://provenancemanifesto.org

Weitere Artikel und Diskussionen befassen sich mit Entscheidungsprovenienz, institutionellem Gedächtnis und Wissensbewahrung in modernen Softwaresystemen.