Claude を編集者として、開発者が実際に読む PRD を作成する

私の最初の PRD は、「何を構築するかを言っていただけますか」という内容で返されました。そこで私はドキュメントを書くのをやめ、疲れたエンジニアが耐えられるような仕様を書き始めました。この点でのクロードの仕事は、発明することではなく、カットすることです。

まず構造を説明します。問題に関する 1 行、ユーザーに関する 1 行、「完了」の意味の短いリスト、そして開発者が実際に遭遇したエッジケースです。背景小説はありません。コンテキストの段落が必要な場合は、リンクされたスレッドに属します。

プレーンな草案を作成し、次の 1 つの指示を添えてクロードに貼り付けます。「開発者が推測できるすべての文を削除し、受け入れテストのない要件にはフラグを立ててください。」この 1 つのプロンプトは、PRD をスキップ可能にする綿毛を無効にします。

次に、クロードが欠落しているとフラグを立てた受け入れテストを追加します。テストのない要件は意見です。開発者は検証可能な仕様を読み取ります。彼らは残りをすくいます。

すべてを変えた習慣: 私は読者が文脈を理解していて忍耐力がないことを前提として PRD を書いています。クロードは、礼儀正しい散文を削除することで、私がその境界線を保つのを助けてくれました。

クロード (claude.ai)

最適な用途: 長い文章の執筆、編集、構造による推論。

主な機能: ドキュメント モード、長いコンテキスト、下書き用のアーティファクト、慎重な編集。

無料プラン: 1 日あたりの制限がある無料利用枠。

価格: Pro は、使用量が多い場合は月額約 20 ドルです。

長所: トリミングと再構築が得意で、簡潔なままです。

短所: あなたがやめるよう指示しない限り、鈍い点を和らげます。

私の評決は、私が骨を書き、クロードが脂肪を取り除き、私がエッジケースを再度追加するというものです。結果として得られるドキュメントは、読むのに十分短く、構築するのに十分な具体性を持っています。

よくある質問:

Q: クロードは PRD を最初から作成する必要がありますか?

A: 私が構造を書きます。クロードが編集する。完全な世代は、チームが実際に必要とするものから逸脱します。

Q: どのくらい短いと短すぎますか?

A: 開発者がドキュメントからビルドしてテストできるのであれば、十分な長さです。通常、長い方がパディングされます。

Q: すべての行に対して受け入れテストが必要ですか?

A: QA 担当者がチェックするものについては、はい。曖昧な要件は後で非難されることになります。