2. システム仕様の書き方ガイド

このドキュメントは、システム仕様書テンプレートを使用して、プロジェクトのシステム仕様（要求仕様）を記述するための具体的な方法とベストプラクティスを解説します。

1. 基本的な考え方

システム仕様書は、開発するプロダクトが「何を(What)」実現すべきかを定義する、プロジェクトの最も重要なドキュメントの一つです。このドキュメントに基づいて、後続のユースケース、設計、テストが作成されます。

明確かつ測定可能に: 「使いやすいUI」のような曖昧な表現ではなく、「主要な操作は3クリック以内で完了できること」のように、具体的で検証可能な記述を心がけます。
「なぜ」を記述する: 可能であれば、その要件が必要となった背景や目的を追記することで、設計者がより適切な技術的判断を下す助けとなります。

ファイルの作成:
- Docs/00_はじめに/02_ドキュメント作成ガイド/テンプレート/から01_システム仕様書テンプレート.mdをコピーします。
- Docs/01_システム仕様/配下の適切な場所に、[章番号]_[仕様名].mdという形式で配置します。（例: 01_機能要件.md）
各セクションの記述:
- テンプレート内のコメント（）を参考に、各セクションを埋めていきます。不要なセクションは削除しても構いません。

プロジェクト内のすべての要求、仕様、制約などを一意に識別し、トレーサビリティを確保するために、要求IDを付与します。

[種別]-[カテゴリ]-[メジャー番号]-[マイナー番号]

カテゴリ (Category):
- 機能のドメインを表す、3〜4文字の大文字略称です。（例: AUTH (認証), USER (ユーザー), POST (投稿)）
メジャー番号 (Major):
- カテゴリ内の大きな機能の塊を表す番号です。（例: 1）
マイナー番号 (Minor):
- メジャー番号に属する、より詳細な個別の要件を表す番号です。（例: 1, 2）
- 0は、そのメジャー番号全体の概要を示す要件に使用することを推奨します。

要求IDを定義する際は、Markdownの見出しに アンカー ({ #... }) を付与します。これにより、他のドキュメントから直接その要件にリンクできるようになります。

例:

#### FUNC-AUTH-1-1: パスワードポリシー { #FUNC-AUTH-1-1 }

- **要件:** パスワードは、最低8文字以上で、大文字、小文字、数字、記号をそれぞれ1文字以上含む必要がある。

作成した要求IDは、後続のドキュメントで必ず参照します。これにより、「この設計（またはテスト）は、どの要求を実現（検証）するためのものか」を追跡できます。

例 (設計仕様書での参照):

このパスワード検証モジュールは、要件 [FUNC-AUTH-1-1](./01_機能要件.md#FUNC-AUTH-1-1) を満たすために設計される。