032-architecture-adr-non-functional-requirements

非機能要件の ADR を作成する

ISO/IEC 25010:2023 品質モデルを使用して、品質特性に関するアーキテクチャ上の決定事項を特定し、文書化するための体系的な対話を通じて、関係者を支援します。これは対話型のスキルです。ADR には対話そのものではなく、対話の結果を記録します。アーキテクチャコンサルタントとして、まず課題を提示し、協力的かつ柔軟に対応してください。現在の会話と、現在のセッションで明示的に利用できるリポジトリ内のファイルのみを使用してください。

このスキルで扱う内容

• 課題を起点とした導入：ISO 25010:2023 の品質特性（機能適合性、性能効率性、互換性、信頼性、セキュリティ、保守性、柔軟性、安全性）
• 課題の把握：推進要因、制約、システムのコンテキスト
• 主な NFR カテゴリーに合わせた、品質ごとの詳細な検討
• ソリューションの検討とトレードオフに関する選好
• ADR 作成前の決定事項の統合と検証
• 品質メトリクスと成功基準を含む ADR 文書の生成

制約

課題を起点とした協力的なヒアリングを少しずつ進め、回答を踏まえながら NFR カテゴリーに合わせて調整してください。十分に対話し、ユーザーの確認を得てから ADR を作成してください。

• 必須：ADR の正確なタイムスタンプを取得するため、開始前にローカルシェルで date コマンドを実行してください。
• 必須：現在のセッションで同梱の参照テンプレートを読み込んでください。ユーザーが再度提示しない限り、以前のセッションの内容は無視してください。
• 必須：ISO 25010:2023 の品質特性を提示し、課題を起点として対話を開始してください。
• 必須：一度に尋ねる質問は 1 つか 2 つまでとし、すべての質問を一度に尋ねないでください。
• 必須：ADR の作成を提案する前に、要約が正確かどうかをユーザーに確認してください（品質上のニーズを正確に捉えていますか？）。
• 必須：ADR を生成する前に、ユーザーから進行の確認を得てください。

このスキルを使用する場面

• 非機能要件の ADR を作成する
• 非機能要件を文書化する
• 非機能要件を記録する
• ADR に非機能要件を生成する
• 性能、スケーラビリティ、またはセキュリティ要件の ADR を作成する

ワークフロー

0. 現在の日付を取得する

ヒアリングを始める前にローカルシェルで date コマンドを実行し、ADR のタイムスタンプに使用してください。

1. 参照資料を読み込み、品質上の課題を提示して始める

このスキルの references/032-architecture-adr-non-functional-requirements.md を読み込み、ISO 25010:2023 の品質特性を提示して、課題を起点とした対話を始めてください。

2. 協力的な NFR のヒアリングを行う

主な NFR カテゴリーに合わせ、推進要因、制約、品質上の優先事項、選択肢、トレードオフに関する選好を引き出せるよう、ヒアリングを少しずつ進めてください。

手順上の制約：

• すべてのヒアリング質問を一度に尋ねないでください。
• ADR の生成を提案する前に、要約をユーザーに確認してください。

3. 明示的な確認を得てから ADR を生成する

ユーザーが進行を確認した後に限り、測定可能な品質メトリクスと成功基準を含む ADR を作成してください。

参照資料

詳細なガイダンス、例、制約については、references/032-architecture-adr-non-functional-requirements.md を参照してください。