current-spec テンプレート 3-vendor ベストプラクティス調査
調査日: 2026-05-26 (初版 Claude 分析: 2026-05-15)
調査者: [email protected]
目的: ADR-0041「型ファーストプロセス義務化」に基づく遡及リサーチ。_meta/templates/current-spec.md (62 行) の設計妥当性を 3 vendor で検証する
調査モデル: Claude Sonnet 4.6 → Opus 4.7 / Gemini 1.5 Pro (pending) / GPT-4o (pending)
先行調査: rq-045 (Claude Sonnet 4.6)
0. 調査設問
- 現行
current-spec.mdのセクション構成 (概要→スコープ→フロー→データ→ルール→エラー→テスト→関連) は IEEE 29148・arc42 等と整合しているか？ - 不足セクションがあればどれか？追加優先順位は？
- GAS 固有制約 (6 分実行制限・シート依存・Env モジュール) をテンプレートにどう反映すべきか？
1. サマリー（3-vendor 統合結論）
注: 現時点は Claude 単独分析。Gemini/GPT 追加後に統合結論を更新する。
現行テンプレートの骨格は IEEE 29148・arc42 の推奨順序と概ね整合。採用継続。3 セクション追加が必要。
| # | 追加セクション | 根拠 |
|---|---|---|
| 1 | ## 2.3 前提条件・依存関係 | IEEE 29148 必須項目。GAS 6 分制限・依存シート明記 |
| 2 | ## 6.5 性能要件（非機能） | arc42 黒箱テンプレート推奨。実行時間制約を定量記録 |
| 3 | ## 9. 変更履歴 | 業界標準全般で末尾に表形式 |
2. Vendor 別分析
2.1 Claude 分析
モデル: Claude Sonnet 4.6 (2026-05-15)、Opus 4.7 (2026-05-26 確認) 情報源: arc42 Section 5, IEEE 29148 SRS Template (ReqView), Docsie Feature Spec Best Practices 2026
arc42 との整合
| arc42 フィールド | テンプレート対応 |
|---|---|
| Purpose / Responsibility | 1. 概要 |
| Interface(s) | 3. 処理フロー（入出力） |
| Quality / Performance | 未記載 — 追加推奨 |
| Fulfilled Requirements | 8. 関連（部分的） |
| Open Issues / Risks | 未記載 |
IEEE 29148 との整合
| IEEE 29148 セクション | テンプレート対応 |
|---|---|
| Purpose & Scope | 1. 概要 / 2. スコープ |
| Assumptions & Dependencies | 未記載 — 最重要不足 |
| Design Constraints | 未記載 |
| Functional Requirements | 3. 処理フロー / 5. ビジネスルール |
| Performance Requirements | 未記載 |
| Change History | frontmatter status のみ — 不十分 |
結論
スコープ「含む/含まない」パターンは PVBid・Smartsheet・Miro が全て採用する確立ベストプラクティス。維持する。セキュリティ要件・Open Issues は複雑な機能のみオプション追加（シンプル機能ではオーバーエンジニアリング）。
詳細: rq-045 全文
2.2 Gemini 分析
Status: PENDING
調査プロンプト (Gemini 1.5 Pro 用)
あなたはソフトウェアドキュメンテーションの専門家です。以下の「機能仕様テンプレート」を評価し、業界ベストプラクティスとの整合性を分析してください。
テンプレート (current-spec.md, 62 行):
# <機能名> — 現行仕様
## 1. 概要
## 2. スコープ
### 2.1 含む
### 2.2 含まない
## 3. 処理フロー (入力/処理/出力)
## 4. データ仕様 (テーブル形式)
## 5. ビジネスルール
## 6. エラーハンドリング (条件/対処テーブル)
## 7. テスト (外部参照)
## 8. 関連 (旧仕様書/ADR/データ定義)
プロジェクト文脈:
- Google Apps Script (V8) + Google Sheets の法人会計自動化
- GAS 実行制限: 1 関数 6 分以内
- 監査要件あり (J-SOX 準拠を目指す)
- テンプレートはドキュメントの型 (type) として CI で存在検証される
評価軸:
- セクション構成は IEEE 29148 / arc42 / 業界標準と整合しているか
- 不足セクション top 3 と追加理由
- GAS プロジェクト固有の制約への対応案
- テンプレート改善案（具体的なマークダウン例）
2.3 GPT 分析
Status: PENDING
調査プロンプト (GPT-4o 用)
あなたはソフトウェアドキュメンテーションの専門家です。以下の「機能仕様テンプレート」を評価し、業界ベストプラクティスとの整合性を分析してください。
テンプレート (current-spec.md, 62 行):
# <機能名> — 現行仕様
## 1. 概要
## 2. スコープ
### 2.1 含む
### 2.2 含まない
## 3. 処理フロー (入力/処理/出力)
## 4. データ仕様 (テーブル形式)
## 5. ビジネスルール
## 6. エラーハンドリング (条件/対処テーブル)
## 7. テスト (外部参照)
## 8. 関連 (旧仕様書/ADR/データ定義)
プロジェクト文脈:
- Google Apps Script (V8) + Google Sheets の法人会計自動化
- GAS 実行制限: 1 関数 6 分以内
- 監査要件あり (J-SOX 準拠を目指す)
- テンプレートはドキュメントの型 (type) として CI で存在検証される
評価軸:
- セクション構成は IEEE 29148 / arc42 / 業界標準と整合しているか
- 不足セクション top 3 と追加理由
- GAS プロジェクト固有の制約への対応案
- テンプレート改善案（具体的なマークダウン例）
3. 3-vendor 一致度分析
| 論点 | Claude | Gemini | GPT | 一致 |
|---|---|---|---|---|
| 前提条件セクション追加 | 必須 | — | — | pending |
| 性能要件セクション追加 | 必須 | — | — | pending |
| 変更履歴セクション追加 | 必須 | — | — | pending |
| スコープ含む/含まない維持 | 維持 | — | — | pending |
一致率: 未確定 (1/3 vendor 完了)
ADR-0041 §8:
agreement_rate = majority_decisions / total_RQs * 100%。2/3 以上の一致で majority 採用。全 split 時は起案者裁定。
4. 参照元
- arc42 Section 5: Building Block View — 2026-05
- ISO/IEC/IEEE 29148 SRS Template — ReqView — 2026-05
- Feature Specification Best Practices 2026 — Docsie — 2026-05
5. プロジェクトへの示唆
テンプレートに以下 3 セクションを追加することで IEEE 29148 / arc42 の重要不足が解消される:
### 2.3 前提条件・依存関係
- <!-- GAS V8 ランタイム / 依存シート（例: 11_mst_account 初期化済）/ Env モジュール -->
### 6.5 性能要件（非機能）
| 指標 | 目標値 |
|---|---|
| 最大実行時間 | ≤ 5 分（GAS 6 分制限に対するバッファ） |
## 9. 変更履歴
| 日付 | バージョン | 変更内容 |
|---|---|---|
| YYYY-MM-DD | v1.0 | 初版作成 |
セキュリティ要件・Open Issues は複雑機能のみオプション追加。