最終更新: 2026/06/22 18:56
current-spec.md テンプレート記述標準調査
調査日: 2026-05-15 調査者: [email protected] (Claude Sonnet 4.6 調査) 目的: ADR-0041「型ファーストプロセス義務化」に基づく遡及リサーチ。arc42・IEEE 29148 との整合性検証とテンプレート改善案を導出する 調査モデル: Claude Sonnet 4.6(Gemini/GPT 追加調査は別途)
1. サマリー(結論・採用判断)
現行テンプレートの骨格(概要→スコープ→フロー→データ→ルール→エラー→テスト→関連)は IEEE 29148・arc42 の推奨順序と概ね整合している。採用継続。ただし3セクション追加が必要。
追加必須:
## 2.3 前提条件・依存関係— IEEE 29148 必須項目。GAS 6分制限・依存シート明記に使用## 6.5 性能要件(非機能)— arc42 黒箱テンプレート推奨。GAS 実行時間制約を定量記録## 9. 変更履歴— 業界標準テンプレート全般で末尾に表形式
2. 調査内容
2.1 arc42 が feature-level spec に推奨するセクション
arc42 Chapter 5(Building Block View)の黒箱テンプレート推奨フィールド:
| arc42 フィールド | 現テンプレートの対応 |
|---|---|
| Purpose / Responsibility | 1. 概要 ✓ |
| Interface(s) | 3. 処理フロー(入出力) ✓ |
| Quality / Performance Characteristics | 未記載 ← 追加推奨 |
| Fulfilled Requirements | 8. 関連(部分的)△ |
| Open Issues / Risks | 未記載 |
arc42 Chapter 6(Runtime View)は「処理フロー」に相当するが、シーケンス図・相互作用シナリオを明示推奨。ASCII フローの現行方式は許容範囲。
2.2 IEEE 29148:2018 の必須セクション
SRS 項目のうち feature 仕様書に転用可能な項目:
| IEEE 29148 セクション | 現テンプレートの対応 |
|---|---|
| Purpose & Scope | 1. 概要 / 2. スコープ ✓ |
| Assumptions & Dependencies | 未記載 ← 最重要不足 |
| Design Constraints | 未記載 |
| Functional Requirements | 3. 処理フロー / 5. ビジネスルール ✓ |
| Performance Requirements | 未記載 |
| Security Requirements | 未記載 |
| Change History | frontmatter status のみ ← 不十分 |
2.3 スコープ「含む/含まない」パターン評価
確立されたベストプラクティス。PVBid・Smartsheet・Miro のテンプレートが全て採用。スコープクリープ防止・隣接機能との境界文書化に有効。CLAUDE.md「変更が依頼スコープ内のみ」ルールとも整合。維持する。
3. 参照元
- 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 参照
4. プロジェクトへの示唆
現行テンプレートに以下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 は複雑な機能のみオプション追加とする(シンプルな機能ではオーバーエンジニアリング)。