KEEL

経営 · PM

0. 経営層向けサマリー

3分でROIと投資判断。品質×効率のBefore/After。

主な読者: 経営PM
経営層投資対効果とリスク低減の判断材料。全文読む必要はなく、KPIとBefore/Afterで十分。
この章 3分でKPI表のみ
PM合意・スコープ・未決の管理。正本が1か所なら炎上の早期検知と説明責任が楽になる。
この章 導入ロードマップ
SE構造・IF・例外の設計品質。MD+Mermaid+OpenAPIでレビューとAI支援の精度が上がる。
PG実装の迷いが減る。AGENTS.md・型生成・PRテンプレで「聞き直し」工数が減る。

3分サマリー：なぜ今やるか

-30%
手戻り工数（事例レンジ）
-40%
仕様確認の往復
+AI
参照可能な仕様資産
1
正本（SSOT）
数値は導入事例のレンジであり、自社プロジェクトで baseline を取ってから評価すること。
-30% や -40% は導入仮説・事例レンジであり、保証値ではない。自社プロジェクトでは導入前に baseline を取得し、PoC 後に同じ定義で比較する。経営判断では、数値効果だけでなく「正本不明による炎上防止」「合意の早期化」「AIが参照できる仕様資産化」を効果として扱う。
KPI測定定義（プロジェクトで再定義する想定）
KPI定義測定方法備考
手戻り工数基本設計以降の仕様変更による再作業人日チケットタグ rework 集計事例レンジ -30%
仕様確認往復同一 REQ に関する確認コメント往復数PR / レビュー事項カウント導入前後比較
AI参照可能資産REQ-ID 付き MD + OpenAPI のカバー率リポジトリスキャン定性+定量
効果項目の根拠レベルと判断方法
効果項目根拠レベル判断方法
手戻り工数削減仮説 / 事例レンジbaseline と PoC 後の同一定義比較
仕様確認往復削減自社計測向きコメント往復数、未決滞留日数
AI参照可能資産化運用遵守率REQ-ID 付与率、OpenAPI カバー率
合意早期化定性 + 定量読み会回数、未合意項目数

Excel・メール・口頭に散らばった仕様は、品質リスクとコストの両方を増やします。Git上のMarkdown/OpenAPIを正本にし、依頼者側にはレビュー用HTMLで見せる——この二層が、Qiita/Zenn上の2024〜2026年のベストプラクティスと一致します。

Before / After（経営視点）

Before

  • 「どれが最新仕様？」がプロジェクトごとに発生
  • 外部説明と実装が別資料でズレる
  • AI導入しても仕様を読めず効果が出ない
  • 受入時に大きな差戻し → 追加コスト

After

  • 合意・要件・APIの正本が明示される
  • レビュー用HTMLで早期合意、実装は同じIDを参照
  • AIがリポジトリ内仕様を根拠に支援
  • ゲートで上流欠陥を摘出 → 下流コスト抑制

投資判断の目安

投資・リターン・リスクの整理
投資テンプレ整備 1〜2週 · 運用ルール策定 · 軽い自動化（bundle/HTML生成）
リターン要件差戻し減 · 実装の聞き直し減 · テスト観点漏れ減 · AI活用の実効性向上
リスク既存Excel資産の移行コスト → 新規機能から段階導入で緩和

導入フェーズ

  1. Phase 0（約1週）: テンプレ・AGENTS.md・ディレクトリ骨格のみ
  2. Phase 1（スプリント1〜）: 新機能から REQ-ID + MD 正本
  3. Phase 2: 既存 Excel の段階移行（新規のみ MD では不十分な場合）
中止・縮小条件（例）:
  • PM が週次で正本を更新できない
  • ステークホルダーが HTML レビューに参加できない
  • ゲートなしで基本設計着手が常態化している

この工程で使う AI（経営・PM）

経営判断向け — ツールより役割とリスク分散
役割ツール例優れている点典型用途
ROI試算・要約Claude · ChatGPT長文資料の圧縮、KPI定義のたたき台投資判断メモ、Before/After シナリオ整理
ゲート可視化requirements-definition-gate スキル曖昧語・未決を機械的に列挙08_gate-decision.md 入力の下書き
分散構成の説明—（体制設計）1モデル停止でも開発が止まらないベンダーロックイン回避の投資対効果説明
参考: note — 1社に依存しない役割分担。月数百ドル規模の個人例は保険料込み開発費として説明可能。

成果物サンプル一覧

実際のプロジェクトではファイル名・パスをテンプレに合わせてください。以下は掲載可能な具体イメージ（HTML/CSS埋め込み）です。

docs/review/executive_summary.html
経営向け1枚サマリーHTML
file:///review/executive_summary.html

AI品質安定化 — 経営サマリー

-32%
手戻り
-41%
仕様往復
3週
投資回収

正本: Git MD · 更新: 2026-06-10

経営層は数値と判断材料だけ。詳細はリンクで辿る。

output/requirements-gate/08_gate-decision.md
ゲート判定シート
ゲート判定の出力例（requirements-definition-gate 想定）
ゲート判定根拠
基本設計着手CONDITIONAL GO未決3件・曖昧語12
外部提出NO-GOREQ-019 未合意

要件定義ゲートの出力イメージ。

kpi_dashboard.png
投資対効果（Before/After）
手戻り工数
仕様確認往復
■ Before■ After

グラフはHTML/CSSで埋め込み（単体配布可）。

関連リンク

この章とセットで読む・使う
リンク用途
マスタサマリーKPI・RACI要約
要件定義合意の正本
PM・ゲート週次運用
スターター合意索引テンプレ
← 目次入口1. 要件定義 →
KEEL