要件ドキュメンテーション

概要

要件ドキュメントの構造化、品質メトリクス、ハンドオフプロトコルを提供するスキル。 以下の場面で活用される：

• 要件定義書・仕様書の新規作成
• 既存要件ドキュメントの品質改善
• ステークホルダーレビューの準備
• 設計フェーズへのハンドオフ実施
• 要件トレーサビリティの確立

ワークフロー

Phase 1: 要件収集と分析

目的: ステークホルダーからの要件を収集し、ドキュメント化の準備を整える

アクション:

1. ステークホルダーの特定と役割整理
2. 要件の収集（インタビュー、既存ドキュメント分析）
3. 機能要件と非機能要件の分類
4. 優先度付け（MoSCoW法）
5. 依存関係と制約の整理

Task: agents/analyze-requirements.md を参照

Phase 2: ドキュメント構造設計

目的: 収集した要件を標準化されたドキュメント形式で構造化する

アクション:

1. ドキュメントスコープの決定
2. テンプレート（assets/requirements-document-template.md）の適用
3. セクション構成の最適化
4. 受入基準の定義（Given-When-Then形式）
5. ユースケース記述の作成

Task: agents/structure-document.md を参照

Phase 3: 検証とレビュー

目的: ドキュメントの品質を確保し、ステークホルダーの承認を得る

アクション:

1. scripts/validate-document.mjs で構造検証
2. 品質メトリクスの確認（完全性、一貫性、検証可能性）
3. ステークホルダーレビューの実施
4. フィードバックの反映と改訂
5. 承認プロセスの完了

Task: agents/validate-document.md を参照

Phase 4: トレーサビリティとハンドオフ

目的: 要件から設計・実装・テストへの追跡可能性を確立する

アクション:

1. 要件追跡マトリクスの作成
2. 設計フェーズへの引き継ぎ資料準備
3. テスト計画との紐付け
4. scripts/log_usage.mjs で実行記録を保存
5. ハンドオフ完了の確認

Task: agents/create-traceability.md を参照

Task仕様（ナビゲーション）

詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照

ベストプラクティス

すべきこと

• テンプレート（assets/requirements-document-template.md）を活用し一貫性を確保
• MoSCoW法で全要件に優先度を付与
• 受入基準をGiven-When-Then形式で具体的に記述
• 要件IDを付与しトレーサビリティを維持
• ステークホルダーレビューを早期かつ頻繁に実施
• scripts/validate-document.mjs で定期的に品質検証

避けるべきこと

• 曖昧または検証不可能な要件の記述
• 優先度なしでの要件列挙
• ステークホルダー承認前のハンドオフ
• トレーサビリティの欠如
• 品質検証スクリプトの実行省略

リソース参照

references/（詳細知識）

scripts/（決定論的処理）

assets/（テンプレート）

変更履歴