Schreiben einer PRD, die Entwickler tatsächlich lesen, mit Claude als Herausgeber
Entwickler überspringen PRDs, die sich wie Aufsätze lesen. Eine straffe Struktur und Claude als strenger Redakteur haben mir geholfen, mein Buch zu öffnen.
Meine ersten PRDs kamen mit „Kannst du einfach sagen, was ich bauen soll?“ zurück. Also hörte ich auf, Dokumente zu schreiben, und begann, Spezifikationen zu schreiben, die ein müder Ingenieur tolerieren würde. Claudes Aufgabe besteht darin, zu schneiden, nicht zu erfinden.
Zuerst die Struktur: eine Zeile zum Problem, eine Zeile zum Benutzer, eine kurze Liste dessen, was „erledigt“ bedeutet, und die Randfälle, auf die die Entwickler tatsächlich stoßen. Kein Hintergrundroman. Wenn ein Kontextabsatz erforderlich ist, gehört er in einen verlinkten Thread.
Entwerfen Sie es einfach und fügen Sie es dann mit einer Anweisung an Claude ein: „Entfernen Sie jeden Satz, den ein Entwickler ableiten kann, und kennzeichnen Sie jede Anforderung ohne Abnahmetest.“ Diese einzige Eingabeaufforderung vernichtet den Flaum, der PRDs überspringbar macht.
Dann füge ich die Abnahmetests hinzu, die Claude als fehlend gekennzeichnet hat. Eine Anforderung ohne Prüfung ist eine Meinung. Entwickler lesen Spezifikationen, die sie überprüfen können; Den Rest überfliegen sie.
Die Angewohnheit, die alles verändert hat: Ich schreibe die PRD unter der Annahme, dass der Leser Kontext hat und keine Geduld hat. Claude hilft mir, diese Linie beizubehalten, indem er die Höflichkeitsprosa streicht.
Claude (claude.ai)
Am besten geeignet für: langes Schreiben, Bearbeiten und Argumentieren durch Struktur.
Hauptmerkmale: Dokumentmodus, langer Kontext, Artefakte für Entwürfe, sorgfältige Bearbeitung.
Kostenloser Plan: eine kostenlose Stufe mit Tageslimits.
Preise: Pro etwa 20 US-Dollar pro Monat für eine höhere Nutzung.
Vorteile: Stark im Trimmen und Restrukturieren, bleibt auf dem Laufenden.
Nachteile: Eine stumpfe Spitze wird aufgeweicht, es sei denn, Sie sagen es nicht.
Mein Urteil: Ich schreibe die Knochen, Claude entfernt das Fett, ich füge die Randfälle wieder hinzu. Das resultierende Dokument ist kurz genug zum Lesen und spezifisch genug zum Erstellen.
Häufig gestellte Fragen:
F: Sollte Claude das PRD von Grund auf schreiben?
A: Ich schreibe die Struktur; Claude bearbeitet. Die gesamte Generation weicht von dem ab, was das Team tatsächlich braucht.
F: Wie kurz ist zu kurz?
A: Wenn ein Entwickler es anhand des Dokuments erstellen und testen kann, ist es lang genug. Länger ist normalerweise Polsterung.
F: Benötige ich Abnahmetests für jede Linie?
A: Für alles, was eine QS-Person überprüfen wird, ja. Vage Anforderungen werden später zur Schuld.