Skip to content

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

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

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

Conversation

@Taka-bow
Copy link
Copy Markdown
Collaborator

@Taka-bow Taka-bow commented Apr 28, 2026 •
edited
Loading

背景・目的

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

@Taka-bow @claude
docs: CMMI解説ページを ISACA 公式 V3.0 リファレンスに準拠して作成
5ae444f 
- 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>
Taka-bow
Taka-bow commented Apr 28, 2026
View reviewed changes
Copy link
Copy Markdown
Collaborator Author

@Taka-bow Taka-bow left a comment •
edited
Loading

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
@Taka-bow @claude
style: 半角英数字と全角文字の境界スペースを禁則化し、CMMIページから一括除去
2642e30 
- LINT-NORM-003 を【禁則】として強化（境界スペースは双方向で削除する旨を明記）
- pim-cmmi-detail.md / pim-cmmi-summary.md からコードブロック外の境界スペースを削除（177件）

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

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Taka-bow @claude
docs: 「批判の核心は…にあり」をより自然な日本語に書き直し
7e3bd76 
「そもそも、こうした批判の多くは…に向けられたものであって、」とすることで
評論調の硬さを和らげる。

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Taka-bow @claude
docs: summary の「広がっています」を断定の弱い表現に修正
6cec0d3 
実態以上の主張を避け、detail の「と言えるでしょう」のトーンに合わせて
「現代的なCMMIの使い方と言えます」へ。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Taka-bow @claude
docs: summary から「批判を踏まえた」を削除
6825742 
summary 本文では批判に言及していないため、唐突な接続を解消。

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

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

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

Taka-bow commented Apr 28, 2026

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
@Taka-bow @claude
refactor: 実践への適用セクションをロードマップに絞り、調達要件を歴史へ統合
b7f8526 
案A適用：
- 「実践への適用」から「調達要件・契約要件として使う」「組織横断の共通言語として使う」を削除
- 「歴史と進化」のDORA移行段落の直後に、調達要件としての位置づけ変化（Gansler Memo / SAP / CMMC / アジア勢4,500件超）を1段落で簡潔に追記
- 「実践への適用」は ### 改善活動のロードマップとして使う の小見出しも外し、6ステップのみのフラット構造に整理

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Taka-bow @claude
docs: Benchmark Appraisalの初出に日本語訳を併記
ce1d754 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Taka-bow Taka-bow self-assigned this Apr 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@rojoudotcom rojoudotcom Awaiting requested review from rojoudotcom

@daitoyama1080 daitoyama1080 Awaiting requested review from daitoyama1080

@ynaito-ktc ynaito-ktc Awaiting requested review from ynaito-ktc

At least 2 approving reviews are required to merge this pull request.

Assignees

@Taka-bow Taka-bow

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@Taka-bow