Skip to content

docs: CMMI解説ページを ISACA 公式 V3.0 リファレンスに準拠して作成#39

Open
Taka-bow wants to merge 12 commits into
mainfrom
feat/cmmi-knowledge-map
Open

docs: CMMI解説ページを ISACA 公式 V3.0 リファレンスに準拠して作成#39
Taka-bow wants to merge 12 commits into
mainfrom
feat/cmmi-knowledge-map

Conversation

@Taka-bow
Copy link
Copy Markdown
Collaborator

@Taka-bow Taka-bow commented Apr 28, 2026

背景・目的

SODA ナレッジマップの pim-cmmi-summary.md / pim-cmmi-detail.md は「Coming soon...」のプレースホルダのままだった。同じ pim-* グループの DORA Core Model 詳細と同等の粒度で本文化することで、PIM(Process Improvement Management)における CMMI の位置づけを SODA の文脈で明確にする。

執筆にあたっては、ISACA / CMMI Institute 公式の「CMMI モデルクイックリファレンスガイド(日本語版)CMMI V3.0」を一次資料として、用語・分類体系・数値を全面的に同資料に準拠させた。

変更内容

docs/soda-knowledge-map/pim-cmmi-detail.md

  • Coming soon → 本文化(約 270 行)
  • 概要: 公式 V3.0 のキャッチ(14,000以上の評定組織、ISO・NIST・アジャイル・DevSecOps・AI との統合可能)を反映
  • 歴史と進化: SW-CMM(1991)から v3.0(2023)まで、ISACA 移管・DoD Software Acquisition Pathway 制定(2020)等を含む年表
  • モデルの構造: 公式の階層(区分 → 能力領域 → プラクティス領域 → プラクティスグループ → プラクティス)を Mermaid 図と表で整理。31 プラクティス領域・12 能力領域・4 区分・8 ドメインを公式略号で全列挙
  • プラクティスグループレベルと成熟度レベル: 公式の各レベル説明(QPPO 等)を反映
  • アプレイザル(評価): Benchmark / Sustainment / Evaluation / Action Plan Reappraisal の種別と PARS 登録
  • 実践への適用: 改善ロードマップ、調達要件としての歴史的役割と現状の変化(CMMC への重心移動)、共通言語としての活用
  • 現代開発との関係: アジャイル / DevOps との接続、PMBOK Guide 第8版との違い、DORA Core Model との補完関係
  • 警告ボックスで v2.0 以降の有償ライセンス化を明示
  • 文末に 著作権・商標について セクションを追加(CMMI Institute, LLC への IP 帰属を明示)

docs/soda-knowledge-map/pim-cmmi-summary.md

  • Coming soon → モーダル表示用の概要に本文化(DORA Core Model summary と同粒度)

mkdocs.yml

  • pymdownx.superfences に custom_fences を追加して Mermaid を有効化(CMMI のモデル階層図用)

影響範囲

  • 変更ファイル: 3つ(CMMI summary / CMMI detail / mkdocs.yml)
  • 既存ページへの影響なし
  • Mermaid 有効化により、今後他ページでも Mermaid 図が利用可能

Test plan

  • mkdocs build が成功することを確認(ローカルで確認済み)
  • GitHub Pages デプロイ後、該当ページで内容と Mermaid 図が表示されること
  • ナレッジマップから当該ページへの遷移とモーダル表示(summary)が機能すること
  • DORA Core Model 詳細ページなど他ページの表示に影響がないこと

🤖 Generated with Claude Code

- pim-cmmi-summary.md / pim-cmmi-detail.md を「Coming soon...」から本文化
- ISACA 公式 V3.0 の用語体系(区分・能力領域・プラクティス領域・プラクティスグループ・プラクティス)に完全準拠
- 8ドメイン × 31プラクティス領域、4区分、12能力領域を表で整理
- 歴史と進化(SW-CMM〜v3.0、DoD Software Acquisition Pathway 等)、有償ライセンス化の警告、PMBOK / DORA Core Model との比較を含む
- mkdocs.yml に Mermaid 用 superfences 設定を追加し、モデルの階層図を Mermaid で可視化
- 著作権・商標明示セクションを末尾に追加(CMMI Institute, LLC への帰属を明示)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator Author

@Taka-bow Taka-bow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/Users/hiroyuki.takahashi/GitHub_work/soda.dev/mkdocs.yml
確認

Taka-bow and others added 9 commits April 28, 2026 11:41
- LINT-NORM-003 を【禁則】として強化(境界スペースは双方向で削除する旨を明記)
- pim-cmmi-detail.md / pim-cmmi-summary.md からコードブロック外の境界スペースを削除(177件)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
LINT-NORM-003 の禁則化は別PRで扱うため、本PRからは取り除く。
CMMIページの境界スペース除去自体は維持する。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
CMMI擁護パートを先に置き、DORA への言及を末尾の「一方」段落として独立させ、
「ただし」が浮いていた接続を解消。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
「そもそも、こうした批判の多くは…に向けられたものであって、」とすることで
評論調の硬さを和らげる。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- ドメイン列挙順を detail のコード順(DATA → DEV → PPL → SAF → SEC → SVC → SPM → VRT)に揃える
- 「再定義されています」を、detail の到達点である「組織能力を俯瞰するためのリファレンスとして活用」に書き換え

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
実態以上の主張を避け、detail の「と言えるでしょう」のトーンに合わせて
「現代的なCMMIの使い方と言えます」へ。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
summary 本文では批判に言及していないため、唐突な接続を解消。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
長文かつ複数段落で `!!! warning` 内に押し込んでいたため周囲から浮いていた。
「### モデルドキュメントの入手方法」として通常段落に展開し、警告調も解消。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- 「評定レベルの取得を目的化した運用」「メダル取り」「組織開発のための包括的なベストプラクティス集」の太字を解除し、結論キーワード「組織能力を俯瞰するためのリファレンス」のみ強調を残す
- 「Benchmark Appraisalを〜手引きになります」の長文を「事実上終わりつつあります。とはいえ、〜」で分割

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Taka-bow
Copy link
Copy Markdown
Collaborator Author

SODA品質レビュー結果

Risk Gate: ✅PASS

Lint Gate: ✅PASS(検出: 0件)

点数: 100 点 / 100 点

企画価値: ✅実現

レビュー依頼: ✅可能

良いところ

  • ISACA 公式 V3.0 リファレンスに準拠した正確な体系記述
  • 批判 → フォロー → DORA併用 への誘導という丁寧な現代的位置づけ
  • APA形式の参考文献20件超で根拠が明示
  • Mermaid 図と本文の階層(区分 → CA → PA → PG → プラクティス)が一致
  • 太字を結論キーワード「組織能力を俯瞰するためのリファレンス」に絞り、視認性を確保
  • 著作権・商標の取り扱いが ISACA 公式資料への準拠を明示し、二次資料としての位置づけが適切

改善ポイント

  • 修正済み(L40 の太字密度・長文分割)

次のアクション

  • このまま公開可能

🤖 Generated with Claude Code

Taka-bow and others added 2 commits April 28, 2026 12:55
案A適用:
- 「実践への適用」から「調達要件・契約要件として使う」「組織横断の共通言語として使う」を削除
- 「歴史と進化」のDORA移行段落の直後に、調達要件としての位置づけ変化(Gansler Memo / SAP / CMMC / アジア勢4,500件超)を1段落で簡潔に追記
- 「実践への適用」は ### 改善活動のロードマップとして使う の小見出しも外し、6ステップのみのフラット構造に整理

これにより概要・歴史・アプレイザルとの内容重複が解消される。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

CMMI(Capability Maturity Model Integration、能力成熟度モデル統合)は、組織のプロセス能力(capability)と成熟度(maturity)を評価し、継続的に改善するためのフレームワークです。米カーネギーメロン大学のソフトウェア工学研究所(Software Engineering Institute, SEI)が1990年代に開発し、その後CMMI Instituteを経て、2016年以降は **[ISACA](https://www.isaca.org/)** がその知的財産と運営を引き継いでいます。

CMMIは単なるチェックリストではなく、「組織として何を、どの水準で実践しているか」を **プラクティス領域(Practice Area, PA)** の集合と達成レベルで記述するモデルです。最新版は2023年4月にリリースされた **[CMMI v3.0](https://cmmiinstitute.com/cmmi/v3)** で、開発・サービス・データ・人材・セキュリティ・セーフティ・供給者・バーチャル作業の **8つのドメイン** を統合的に扱える設計になっており、ISO・NIST・アジャイル・DevSecOps・AIなど他の標準や手法とも統合・連携できることがISACA公式に明示されています。世界では14,000以上の評定済み組織がCMMIを活用し、ビジネス目標の設定・達成を報告しています(ISACA / CMMI Institute, 2025)。
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CMMIのURLが無効です。


## 歴史と進化

CMMIの系譜は、1980年代後半のSW-CMM(Capability Maturity Model for Software)に遡ります。米国防総省がソフトウェア調達におけるサプライヤー評価のためにSEIに委託したことが起点です。
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

米国防総省(DoD)としてほしいです。以下年表の2020年でDoDってなんだ?となったため。


### 能力領域(Capability Area, CA)

複数のプラクティス領域を、ビジネス目的の観点でまとめた区分です。CMMI v3.0の能力領域は次のとおりです:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

プラクティス領域とプラクティスグループの対応付けが知りたくなります。
それはクイック・リファレンス参照ですか?


## プラクティスグループレベルと成熟度レベル

CMMI v3.0では、達成度を表現する2つの軸があります。**プラクティスグループレベル** は個別のプラクティス領域ごとの達成度、**成熟度レベル** は組織単位(OU)全体の達成度を表します。
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ここがちょっと入ってこない・・・・。

達成度はプラクティスグループ単位でレベルがある。それらを総合的に判断して、成熟度は組織単位で1つ設定されるということ?
2つの軸の関係性がわからないのと、組織単位(OU)という言葉がここで初めてでてきたのでなじまなかったです。


### 成熟度レベル(Maturity Level, ML)

組織単位(OU)におけるプロセスが、あらかじめ定義されたプラクティス領域と指定されたプラクティスグループレベルの **意図と価値をどの程度満たしているか** を示すものです。**段階的(staged)表現** と呼ばれ、組織横断のベンチマークでよく用いられます。ML1〜ML5は上記プラクティスグループレベルの段階に対応します。
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

「意図と価値」は上記プラクティスグループレベルの「状態」とは別?
(プラクティスグループレベルと成熟度レベル入ったあたりからモヤモヤが深まってくるかも。)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants