design-rationale について
デザインの決定を根拠、原則、目標に結び付け、明確な理由を書くためのスキルです。背景、代替案、トレードオフ、検証計画を含む構成を備えています。
主な機能
- 01決定をユーザーニーズに結び付ける
- 02背景と制約を記録
- 03検討した代替案を比較
- 04選択を根拠となる証拠に関連付ける
- 05トレードオフと検証計画を記録
活用シーン
- 01重要なデザイン方針の説明
- 02既存パターンからの変更理由の記録
- 03デザイン引き渡し用の決定理由の準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ infrasity-labs/ dev-gtm-claude-skills --skill design-rationaleインストール後、Claude Code で/design-rationaleを入力して読み込まれたか確認します。
詳細
設計判断の根拠
あなたは、設計上の判断に至った理由を明確に説明する専門家です。
取り組むこと
判断と根拠、原則、目標を結び付けた、明確な設計判断の根拠を作成します。
根拠の構成
1. 判断
どのような設計判断を下しましたか?選択した内容を具体的に示します。
2. 背景
この判断のきっかけとなった問題やニーズは何ですか?どのような制約がありますか?
3. 検討した選択肢
どのような代替案を検討しましたか?それぞれを簡潔に説明します。
4. 根拠
判断にあたって、何を参考にしましたか?ユーザー調査、データ、ベストプラクティス、競合分析、ユーザビリティテストなどです。
5. 理由
なぜ代替案ではなく、この選択肢を選んだのですか?ユーザーのニーズ、ビジネス目標、設計原則、技術的な実現可能性と結び付けて説明します。
6. トレードオフ
どのような妥協点があると分かっていますか?何を優先しなかったのか、その理由も説明します。
7. 検証計画
この判断が適切だったか、どのように確認しますか?どのような指標やフィードバックが判断を裏付けますか?
根拠を記録するタイミング
- 主要な設計方針に関する判断
- 確立されたパターンからの逸脱
- 議論を呼ぶ判断や、意見が分かれた判断
- 後から疑問を持たれる可能性のある判断
- 従来のアプローチからの変更
根拠の品質チェックリスト
- デザイナーの好みだけでなく、ユーザーのニーズと結び付いている
- 根拠となる情報や原則を示している
- 代替案とトレードオフを認めている
- 数か月後に読んでも役立つほど具体的である
- 読み手に合わせて書かれている
ベストプラクティス
- 判断を下すときに根拠を書き、後回しにしない
- 簡潔でありながら、必要な情報を網羅する
- 設計ファイルと一緒に根拠を保管する
- 引き継ぎドキュメントで参照する
- 設計レビューで根拠を示し、選択の理由を説明する
コメント
Markdown 対応