Leitfaden für Problembeschreibungen

Schreibe klare Problembeschreibungen, um die Team-Abstimmung zu verbessern und die Priorisierung zu beschleunigen. Gut definierte Issues helfen Teams, Aufgaben klar zu verstehen, Missverständnisse zu reduzieren und bessere Ergebnisse schneller zu liefern.

Eine Geschichte voller Schmerz

Problembeschreibungen waren früher unser größter Schwachpunkt. Wir haben Stunden verschwendet, um darüber zu streiten, was zu tun ist. Viele Aufgaben sind wegen Missverständnissen schiefgelaufen, und unser Backlog füllte sich mit unvollständigen Issues.

Wir haben das Kernproblem entdeckt, als wir mit der Priorisierung begannen. Wir haben Kriterien in Ducalis eingerichtet und versucht, Bewertungen zuzuweisen, um herauszufinden, welche Issues den größten Einfluss auf das Produkt haben würden. Da wurde uns klar, dass die Aufgaben selbst unklar und unmöglich zu bewerten waren. Die Priorisierung endete dort, wo sie begonnen hatte. Das Team war verwirrt und nicht abgestimmt. Jeder interpretierte die Aufgaben anders und vergab völlig unterschiedliche Bewertungen. Niemand von uns konnte verstehen, woran das Team arbeitete.

Verstreute Bewertungen signalisieren mangelnde Team-Abstimmung

Wir haben klare Regeln für Problembeschreibungen eingeführt, die wir in diesem Artikel teilen. Wir verbringen jetzt mehr Zeit mit Issue-Beschreibungen, aber sie sind selbst ohne vollständigen Kontext klar.

Klare Issue-Beschreibungen optimieren Arbeitsstunden und reduzieren Fehler. Je weniger Fragen beim Lesen nötig sind, desto schneller und besser wird die Arbeit erledigt.

Allgemeine Prinzipien

Die Projektentwicklung beginnt mit einer Problembeschreibung.

Ein Issue ist die zentrale Arbeitseinheit. Es definiert, was zu tun ist, wie es zu testen ist und welches Ergebnis zu erreichen ist. Issues werden typischerweise von einem Reporter erstellt. Bitte nicht die Assignees, die Problembeschreibungen selbst zu schreiben – sie könnten Nuancen übersehen, und ihre Vision könnte abweichen.

1. Klar und prägnant

Jeder im Team sollte das Problem ohne vollständigen Kontext verstehen. Überprüfe den Text und antizipiere Fragen, die Teammitglieder haben könnten. Beantworte sie direkt in der Beschreibung. Überprüfe noch einmal, was du geschrieben hast. Sei prägnant – kein freier Essay, aber mehr als zwei Sätze.

2. Spezifisch und untermauert

Alle Verweise müssen Hyperlinks zu verwandten Materialien enthalten. Füge Screenshots hinzu, wenn möglich. Hänge vorhandene Dateien (Bilder, Dokumente oder ähnliche Elemente) an, die Assignees möglicherweise benötigen. Lass die Leute nicht raten oder nach Daten suchen.

3. Lesbar

Mache den Text leicht verständlich. Hilf Assignees, wesentliche Punkte zu erkennen – vermeide dichte, unstrukturierte Beschreibungen. Verwende Absätze, Aufzählungszeichen, nummerierte Listen, fetten und kursiven Text. Hebe alle wesentlichen Details hervor.

4. Angemessen

Unterteile große Issues in Teilaufgaben für Zwischenziele. Sonst könntest du am Ende mit dem falschen Ergebnis dastehen. Wenn du ein komplexes Problem nicht in Zwischenaufgaben unterteilen kannst, überlege, ob es einen klaren Endpunkt hat und in dieser Form existieren sollte.

Issue-Struktur

Ein Issue muss mehrere erforderliche Abschnitte haben, die mit fettem Text hervorgehoben sind.

1. Problem

Dieser Absatz beschreibt das Problem, das innerhalb der Aufgabe gelöst werden soll. Beschreibe es ausreichend detailliert, damit Assignees verstehen, was sie tun müssen und warum. Je klarer du das Problem beschreibst, desto wahrscheinlicher wird der Assignee es tiefgehend verstehen und alternative Lösungen vorschlagen.

2. Ergebnis

Dieser Absatz beschreibt das gewünschte Ergebnis. Je detaillierter dieser Abschnitt ist, desto klarer wird es für Assignees sein zu verstehen, was du erwartest und welche Ergebnisse zu erreichen sind. Für Tester beschreibt es, was zu überprüfen ist.

3. Lösung oder Kommentare (optional)

Verwende diesen Absatz, wenn der Reporter weiß, wie das Problem zu lösen ist. Andere Teilnehmer können hier ebenfalls ihre Kommentare schreiben.

Du kannst erhebliche Zeit damit verbringen, Kriterien auszuwählen, die perfekt zu den Werten und Zielen deines Produkts passen. Aber um eine Aufgabe nach diesen Kriterien zu bewerten, benötigst du ein klares Bild davon, wie sie das Ergebnis beeinflusst. Kannst du das tun, wenn du nicht vollständig verstehen kannst, worum es bei der Aufgabe geht?

Ein gut geschriebenes Issue spart Zeit bei Bewertung, Diskussion und Implementierung und senkt somit die Kosten. Verbringe mehr Zeit mit der Problembeschreibung und denke zweimal nach, anstatt zweimal zu arbeiten.

Du kannst unseren Leitfaden gerne verwenden und anpassen. Teile diesen Artikel, wenn du ihn hilfreich findest. Lass uns die Arbeit füreinander leichter machen.

Bonus

Wir haben ein Plugin mit einer Vorlage erstellt, die auf unserem Leitfaden basiert. Es fügt automatisch Problem-, Ergebnis- und Lösungsabschnitte hinzu, wenn du eine neue Aufgabe erstellst. Funktioniert mit Google Chrome + Jira. Hol es dir hier kostenlos.