Begriff

Kontextdokument

Info

Ursprünglich auf Französisch verfasst. Von KI übersetzt — der Sinn wurde bewahrt, nicht der Stil.

Kurzdefinition

Schriftliches Deliverable, das für eine bestimmte Produktchance zusammenträgt, was das Team über ihr Umfeld weiß — Business, Produkt, Kunde, Nutzer, Technik, Branchenregeln, Normen, Kultur vor Ort, Wettbewerb, bereits getroffene Entscheidungen — und jedes Element danach einordnet, ob man es weiß, glaubt, bezweifelt oder verschweigt.

Ausführliche Definition

Der Begriff hat keine feststehende Definition: In den meisten Teams ist „der Kontext“ ein einleitender Absatz am Anfang einer Spezifikation, geschrieben, um den Leser zu orientieren, bevor es um die Lösung geht.

In den Artikeln dieses Blogs ist das Kontextdokument ein eigenständiges Artefakt, das vor der Spezifikation entsteht und unabhängig von ihr ist. Es hat einen Status (Entwurf, in Überprüfung, validiert), einen Verantwortlichen und ein Datum der letzten Aktualisierung; seine Abschnitte sind an die Produktrisiken geknüpft, die sie untersuchen, nicht an die Disziplinen, die sie verfassen.

Ein Unterschied im Maßstab trennt es vom Kontext: Der Kontext ist der dauerhafte, an ein Ziel geknüpfte Arbeitsraum, das Kontextdokument ein datiertes Schriftstück, das dessen Stand für eine bestimmte Chance wiedergibt.

Gebrauch im Feld

Wird verwendet, um das Deliverable zu bezeichnen, dessen Wert steigt, wenn die Fähigkeit, Software zu produzieren, nichts Seltenes mehr ist, und um der Spezifikation und der Roadmap ein Artefakt gegenüberzustellen, das das Problem rahmt, statt die Lösung zu beschreiben.

Synonyme und Varianten

„Das 00-context“, nach dem Namen der Datei, die es am Anfang eines Ordners zu einer Chance aufnimmt; „der Kontext einer Chance“.

Nicht zu verwechseln mit

  • Spezifikation — Beschreibung des erwarteten Produktverhaltens, geschrieben, um gebaut zu werden. Sie setzt die Rahmung voraus; das Kontextdokument erarbeitet sie.
  • Rahmungsnotiz — kurze Zusammenfassung, die einen Umfang und ein Ziel festlegt, um eine Arbeit zu starten. Sie entscheidet; das Kontextdokument legt dar, worüber entschieden wird, Zweifel eingeschlossen.
  • Roadmap — datierte Abfolge dessen, was gebaut wird. Sie ordnet getroffene Entscheidungen; das Kontextdokument bereitet die vor, die noch ausstehen.
  • Kontext — dauerhafter Arbeitsraum, der um ein Ziel herum Quellen, Notizen, Entscheidungen und Entwürfe versammelt. Das Dokument ist dessen schriftliche, datierte Wiedergabe, nicht der Raum selbst.

Beispiele

Die Vorlage 00-context.md, versehen mit den Risiken, die sie untersucht — geschäftliche Tragfähigkeit, Wert aus Käufersicht, Wert und Nutzbarkeit, Machbarkeit.

Die vier Kategorien der Einordnung, die es erzwingt: was ich weiß, was ich glaube, was mich zweifeln lässt, was nicht ausgesprochen wird.

Mehrdeutigkeiten / Debatten

Der übliche Gebrauch — ein Kontextkapitel in einer Spezifikation — und der hier gewählte bezeichnen nicht denselben Gegenstand, obwohl sie denselben Namen tragen. Der Unterschied liegt in der Eigenständigkeit: Ein Kapitel existiert, um eine bereits ins Auge gefasste Lösung einzuleiten, das Dokument existiert, bevor irgendeine Lösung gewählt ist.