#16 巨大な仕様書を"読ませたら"負けーーSSoTから生成する「読む人専用ビュー」

くわラジ · Aug 6, 2026 · 41m

巨大な仕様書を全員に「読ませる」運用は、もう負けかもしれません。今回のテーマはSSoT（Single Source of Truth＝信頼できる唯一の情報源）。信頼できる唯一の仕様書を一つだけ管理し、そこからCS担当者向け・パートナー企業向けなど、読む人ごとに最適化された「専用ビュー」を自動生成するという仕様書運用の考え方を深掘りします。

スーパーエンジニアのkuniwakが、巨大なシーケンス図・状態遷移図から必要な部分だけを畳んで見せる仕組みや、GitHub Actionsで日本語の仕様書から英語版を自動翻訳するパイプラインなど、実際の現場で運用している実例を紹介。

「ドキュメントが腐る」あるあるを、コミットごとの自動生成と生成AIでどう解決するのかが具体的にわかります。後半は仕様記述の理論的バックグラウンドへ。

契約による設計（Design by Contract）の事前条件・事後条件、「アサートを書けばいいんでしょ」というよくある誤解、ホーア論理からBDDまで、へんてこの質問でゆるく噛み砕いていきます。

▼この回で話していること

・SSoT（信頼できる唯一の情報源）とは？仕様書運用への応用

・巨大なシーケンス図・状態遷移図から「読む人専用ビュー」を自動生成する仕組み

・ドキュメントが腐る問題を防ぐ、コミットごとの自動生成と自動英訳パイプライン…