write-first-design について
Write-First Designは、本格的な作業に入る前に、簡潔な文章でプロダクトの判断を明確にするデザインスキルです。目標、変更理由、非目標を整理し、実装の進行に合わせて判断の根拠を更新します。
主な機能
- 01目指すユーザー成果の明確化
- 02変更案と理由の記録
- 03有用な非目標の提示
- 04重要な未解決事項だけを確認
- 05実装中の判断根拠の更新
活用シーン
- 01実装前に曖昧なプロダクト意図を整理
- 02チームレビュー向けにデザイン判断を説明
- 03範囲が明確な場合の前提の記録
- 04実装内容に応じた判断理由の見直し
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ kemiljk/ skills --skill write-first-designインストール後、Claude Code で/write-first-designを入力して読み込まれたか確認します。
詳細
Write-First Design
変更にかかるコストが低いうちに、文章で不確かなプロダクト上の判断を解決します。明確なユーザーブリーフ、既存の意思決定文書、または範囲を限定して指定された UI の編集によって、すでに方向性が定まっている場合は、別のブリーフや承認の手順を追加で求めないでください。
目的が不明確で、相応の作業量を伴う場合は、意図するユーザーの成果、提案する変更、その理由、有用な対象外事項を記録します。永続的な文書がチームに役立つ場合を除き、回答内またはプロジェクトで既に使われている意思決定の形式にまとめてください。
有用な仮説の例:「私たちは、[理由]により、[変更]が[成果]をもたらすと考えています。」判断の内容に合わせて表現を調整してください。テンプレートよりも、成果が重要です。
コストのかかる実装に投資する前に、協力者が評価できるよう、重要な設計上の選択を説明してください。作業内容を実質的に変える未解決の選択肢についてのみ質問します。それ以外の場合は、妥当な前提を明示し、許可された範囲内で作業を続けてください。
文章を書く人を、実装する人の近くに置いてください。実装によって別のトレードオフが明らかになった場合は、理由を更新します。完了とは、依頼されたブリーフを作成すること、または実装が依頼された場合は、変更を実装して検証することです。
出典となるエッセイ
- まず書くデザイン
- 実装に夢中になる
- 引き継ぎではなく、握手のためのデザイン
コメント
Markdown 対応