Was verwaltest du außer dem Dokument?
Ein Dokument ist nur eine Möglichkeit, eine Entscheidung festzuhalten. Sie müssen auch wissen, welche Punkte vereinbart wurden, welche noch Vorschläge sind, wer Fragen beantwortet und was sich ändert, wenn ein Punkt überarbeitet wird. So lässt sich vermeiden, dass auf Grundlage unterschiedlicher Auslegungen derselben Anfrage gearbeitet wird.
Der gleiche Ansatz kann bei der App-Entwicklung, internen Tools, Produktbedingungen und Betriebsregeln helfen. Beginnen Sie mit einer Funktion oder einem Arbeitsablauf, statt alles auf einmal dokumentieren zu wollen.
Verknüpfen Sie Ziel, Anforderung, Spezifikation und Akzeptanzkriterien
Teams verwenden diese Begriffe unterschiedlich. In diesem Beispiel beschreibt eine Anforderung ein benötigtes Ergebnis oder eine Einschränkung, eine Spezifikation hält das vereinbarte Verhalten fest und Abnahmekriterien erläutern, wie es überprüft wird. Stimmen Sie diese Bedeutungen mit den Personen ab, mit denen Sie zusammenarbeiten.
Ziel: manuelle Übertragung reduzieren
Für die monatlichen Berichte werden Datensätze derzeit von Hand übertragen. Der Export soll diese Arbeit erleichtern.
Anforderung: die für den Bericht benötigten Datensätze exportieren
Ein Mitarbeiter muss die Datensätze für einen ausgewählten Monat exportieren, und zwar innerhalb des Bereichs, auf den er zugreifen darf.
Spezifikation: Datei und ihr Verhalten definieren
Einigen Sie sich auf Spalten, Reihenfolge, Textkodierung, Datumsformat, das Verhalten bei leeren Ergebnissen und die Fehlerbehandlung. Dies sind Entscheidungen für dieses Beispiel, keine allgemeingültigen Standardeinstellungen.
Abnahmekriterien: Ergebnisse überprüfbar machen
Bereiten Sie Datensätze mit bekannten Daten und Berechtigungen vor, führen Sie den Export durch und vergleichen Sie die Ausgabe mit dem vereinbarten Ergebnis.
Pro Eintrag eine überprüfbare Idee notieren
Eine Formulierung wie „Export komfortabel gestalten“ lässt wichtige Entscheidungen offen. Trennen Sie die Auswahl eines Zeitraums, die Festlegung der Ausgabefelder, den Umgang mit fehlenden Treffern und die Prüfung der Zugriffsrechte, wenn sich diese Punkte unabhängig voneinander ändern oder überprüfen lassen.
Verwenden Sie konkrete Bedingungen statt Wörtern wie „schnell“ oder „einfach“. Wenn eine angestrebte Antwortzeit wichtig ist, halten Sie neben dem Zahlenwert auch Arbeitslast, Umgebung und Messmethode fest. Kennzeichnen Sie noch nicht festgelegte Werte deutlich als offen.
Vorher: “CSV-Export ermöglichen.”
Danach: „Exportieren Sie den ausgewählten Monat mit den vereinbarten Spalten und der festgelegten Sortierreihenfolge. Definieren Sie leere Ergebnisse und Zugriffsprüfungen in separaten Punkten.“
Die überarbeitete Formulierung macht deutlich, welche Entscheidungen abgestimmt werden müssen, und erleichtert die Zuweisung und Überprüfung der Arbeit. Vor der Umsetzung sind dennoch konkrete Felddefinitionen erforderlich.
Ein kleiner Satz von Feldern für den Anfang
ID, Titel und Beschreibung
Vergeben Sie für jeden Eintrag eine feste ID, beispielsweise REQ-001. Geben Sie Gegenstand, Bedingung und erwartetes Ergebnis an. Eine feste ID ermöglicht es, auch nach einer Titeländerung auf den Eintrag zu verweisen.
Grund und Quelle
Halten Sie fest, welches Problem der Eintrag löst und woher er stammt, etwa aus einem Gespräch, einer Anfrage oder einem unterstützenden Dokument.
Priorität und Umfang
Unterscheiden Sie zwischen dem, was für diese Version erforderlich ist, und dem, was warten kann. Begründen Sie die Priorität, statt jedem Punkt die höchste Priorität zu geben.
Verantwortliche Person und Entscheidungsstatus
Halten Sie fest, wer den Eintrag klärt und ob er ein Entwurf ist, geprüft wird oder bereits abgestimmt wurde. Die für die Umsetzung verantwortliche Person und die genehmigende Person können unterschiedlich sein.
Abnahmekriterien und zugehörige Informationen
Verknüpfen Sie den Eintrag mit relevanten Spezifikationen, Entwürfen, Aufgaben und Prüfnachweisen. Halten Sie diese Verknüpfungen aktuell, wenn sich die Anforderung ändert.
Beispiel: drei Anforderungen für einen monatlichen CSV-Export
Das Folgende ist ein veranschaulichendes Beispiel. Feldnamen und Verhalten sollten für das von Ihnen entwickelte Produkt abgestimmt werden; das Beispiel ist keine vollständige Spezifikation für sämtliche Exportfunktionen.
REQ-001: Datensätze für den ausgewählten Monat
Beispielspezifikation: Verwenden Sie den ausgewählten Monat in der vereinbarten geschäftlichen Zeitzone und exportieren Sie ID, Erfassungsdatum und Titel in UTF-8, sortiert zuerst nach Datum und dann nach ID. Abnahmebeispiel: Drei passende Datensätze ergeben eine Kopfzeile und genau diese drei Datenzeilen, ohne Datensätze aus anderen Monaten.
REQ-002: keine passenden Datensätze
Beispielspezifikation: Exportieren Sie die vereinbarte Kopfzeile auch dann, wenn keine Datensätze übereinstimmen. Abnahmebeispiel: Der leere Testdatensatz erzeugt eine Datei mit dieser Kopfzeile und ohne Datenzeilen. Wenn Sie statt einer Datei eine Meldung bevorzugen, vereinbaren und dokumentieren Sie dieses abweichende Verhalten.
REQ-003: Zugriff wird vor dem Export geprüft
Beispielspezifikation: Benutzer ohne Exportberechtigung können die Datei nicht erzeugen, und Datensätze außerhalb des erlaubten Bereichs werden nicht einbezogen. Abnahmebeispiele sollten sowohl einen Benutzer ohne Exportberechtigung als auch einen Benutzer mit eingeschränktem Zugriff auf Datensätze abdecken.
Nutzen Sie Hierarchien, ohne einzelne Entscheidungen zu verlieren
Gruppieren Sie Einträge nach Zweck oder Funktion und ordnen Sie die detaillierten Bedingungen der jeweiligen Gruppe zu. Beispiel: Berichte → Monatlicher CSV-Export → Zieldatensätze / Dateiformat / Leere Ergebnisse / Zugriff. Halten Sie Hintergrundinformationen und offene Fragen in Notizen fest, statt sie in einer langen Anforderung zu vermischen.
Wenn eine Bedingung mehrere Funktionen betrifft, halten Sie einen eindeutigen Verweis auf die vereinbarte Version fest, statt unterschiedliche Versionen in jeden Abschnitt zu kopieren. Prüfen Sie vor einer Änderung, welche nachgelagerten Spezifikationen und Prüfpunkte davon abhängen.
Vereinbarung, Umsetzung und Überprüfung getrennt halten
„Abgestimmt“ bedeutet, dass der Inhalt für den vorgesehenen Umfang akzeptiert wurde. Es bedeutet nicht, dass die Funktion implementiert ist. „Implementiert“ belegt weder, dass die vereinbarten Abnahmekriterien erfüllt wurden, noch, dass die Funktion veröffentlicht wurde. Halte diese Unterschiede auch bei einer einfachen Statusliste sichtbar.
Prüfen Sie den Normalfall, leere oder fehlende Eingaben, Berechtigungen und gegebenenfalls externe Fehler. Legen Sie fest, welche Nachweise aufbewahrt werden, wer sie prüft und wer eine ungeklärte Frage abschließend klären darf.
Dokumentieren Sie eine Änderung und ihre Auswirkungen, bevor sie als vereinbart gilt
Eine neue Anfrage bleibt ein Vorschlag, bis sich die Verantwortlichen darauf geeinigt haben, wie damit umzugehen ist. Dokumentieren Sie den Änderungsgrund, die betroffenen IDs und die Auswirkungen auf Arbeiten, Termine, Spezifikationen und Prüfungen. Berücksichtigen Sie auch, ob die Änderung für Datensätze oder Nutzer gilt, die die Funktion bereits verwenden.
Aktualisieren Sie nach der Entscheidung die aktuelle Spezifikation und informieren Sie die betroffenen Personen. Bewahren Sie die zuvor vereinbarte Version oder eine Änderungsnotiz auf, wenn Sie erklären müssen, was sich geändert hat. Gehen Sie nicht davon aus, dass ein Tool jede Genehmigung und Überarbeitung automatisch protokolliert.
Wähle einen Ort, den du aktuell halten kannst
Für eine kleine Liste kann ein gemeinsames Dokument oder eine Tabellenkalkulation ausreichen. Wenn Diskussion, Implementierung und Überprüfung auf mehrere Tools verteilt sind, wählen Sie eine zentrale Referenz und verlinken Sie dort die zugehörigen Materialien. Entscheidend ist, dass alle den aktuell vereinbarten Inhalt erkennen können.
Nutzen Sie AI für einen Entwurf und bestätigen Sie anschließend die Entscheidungen
KI kann dabei helfen, mögliche Anforderungen aufzulisten, einen Entwurf zu strukturieren und fehlende Fragen vorzuschlagen. Trennen Sie im Prompt bestätigte Fakten von Annahmen und weisen Sie die KI an, noch nicht festgelegte Werte als Fragen stehen zu lassen. Prüfen Sie das Ergebnis mit den Personen, die die vorgesehene Nutzung kennen.
In ReqSpec AI kannst du Anforderungen und Spezifikationen hierarchisch organisieren und KI zur Unterstützung beim Erstellen, Bearbeiten und Prüfen nutzen. Stelle eine gezielte Frage wie „Welche Bedingungen für leere Ergebnisse sind noch nicht definiert?“ Betrachte jede Antwort als Vorschlag, den du anhand der erfassten Inhalte überprüfen musst, nicht als Nachweis für eine Freigabe oder Vollständigkeit.
Mit einer Funktion und einer Überprüfung beginnen
Wählen Sie eine Funktion aus, listen Sie die benötigten Ergebnisse auf, vergeben Sie IDs für die einzelnen Punkte und ergänzen Sie Abnahmekriterien und offene Fragen. Gehen Sie alles einmal mit einer zuständigen Person durch und halten Sie anschließend die Entscheidungen und die nächste verantwortliche Person fest. Eine kleine, gepflegte Sammlung ist hilfreicher als ein umfangreiches Dokument, das niemand aktualisiert.
Anforderungen und Spezifikationen mit ReqSpec AI organisieren
ReqSpec AI bietet eine einfache Möglichkeit, Anforderungen und Spezifikationen auf dem Smartphone und im Web zu organisieren. Entdecken Sie die Funktionen auf der App-Seite.