ArchiMate Model Quality について
ArchiMate Model Qualityは、明確なArchiMateモデルの作成と保守を支援するガイダンススキルです。命名、粒度、視点、構成に加え、構造や関係に関する一般的な問題の確認方法を扱います。
主な機能
- 01要素の命名規則の適用
- 02適切な抽象度と粒度の選択
- 03ステークホルダーに応じた視点の選定
- 04レイヤーまたはドメイン別のモデル構成
- 05関係とモデル上の問題の確認
活用シーン
- 01ArchiMateモデル作成前の規則策定
- 02ステークホルダーの関心に合うビューの選定
- 03孤立要素や型違いの要素の点検
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ thomasrohde/ marketplace --skill archimate-model-qualityインストール後、Claude Code で/archimate-model-qualityを入力して読み込まれたか確認します。
同梱ファイルreferences/framework-integration.mdreferences/viewpoints.md
詳細
ArchiMate モデルの品質
このスキルでは、高品質で保守しやすい ArchiMate モデルを作成するためのガイダンスを提供します。
命名規則
要素タイプ別の命名
| 要素カテゴリ | 規則 | 例 |
|---|---|---|
| 構造要素 | 単数形の名詞句 | Customer Portal、Data Warehouse |
| 振る舞い要素 | 動詞句 | Manage Applications、Process Payments |
| プロセス | 現在形の動詞+名詞 | Handle Claim、Submit Order |
| サービス | 名詞または動名詞句 | Customer Information Service、Payment Processing |
| ケイパビリティ | 複合名詞/動名詞 | Risk Management、Customer Onboarding |
| バリューストリーム | 動詞+名詞の能動形 | Acquire Insurance Product |
一般的なガイドライン
- 要素名にはタイトルケースを使用します
- 明確さを高めるために複合語を使います(「System」ではなく「Student Information System」)
- ドメイン標準でない限り、略語は避けます
- ツール上で要素タイプが視覚的に示される場合、名前に要素タイプを含めないでください
- 大規模なモデルでは、名前空間のプレフィックスを使用します:[Business Systems][Customer System]
- ビューには状態を示すプレフィックスを付けます:
ASIS_ApplicationLandscape、TOBE_Integration
EA の問題点(品質上の問題)
| EA の問題点 | 説明 | 修正方法 |
|---|---|---|
| 孤立コンポーネント | 関係を持たない要素 | 孤立要素を接続するか削除します |
| 厳密なレイヤー構造への違反 | ビジネスがテクノロジーに直接リンクされている | アプリケーションレイヤーを介在させます |
| 不要な要素 | どのビューにも含まれていない要素 | 削除するか、ビューに含めるかを検討します |
| 過剰な責務を持つコンポーネント | 1つの要素に責務が集中している | 役割に特化したコンポーネントに分割します |
| 過剰に細分化されたインターフェース | 細かい関係が多すぎる | 適切な抽象度で統合します |
| 関係の欠落 | 暗黙の依存関係がモデル化されていない | 関係を明示します |
| 循環依存 | 関係が循環している | 循環をなくすように再構成します |
よくあるモデリングエラー
- 抽象度の混在:戦略的なケイパビリティと詳細なプロセスを並べて配置する
- 関連をデフォルトで使用する:より具体的な関係タイプが適用できる場合
- 過剰なモデリング:あらゆる詳細を取り込み、保守の負担を生み出す
- 要素タイプの誤り:適切なタイプがファンクションである場合にプロセスを使う
- サービスレイヤーの欠落:サービスの抽象化を介さずに直接接続する
- ビュー中心の考え方:再利用せず、単一のビューのためだけに要素を作成する
- 命名の不整合:ビューごとに同じ概念を異なる名前で表す
抽象度と粒度
目的別の抽象度
| 目的 | 抽象度 | 対象者 |
|---|---|---|
| 情報提供 | 高(概要) | CxO、幅広いステークホルダー |
| 意思決定 | 中(整合性) | マネージャー、アナリスト |
| 設計 | 低(詳細) | 分野の専門家 |
要素タイプ別の粒度
| 要素タイプ | 適切なレベル | 過剰なモデリングの兆候 |
|---|---|---|
| ビジネスプロセス | レベル2~3の分解 | すべてのタスクがモデル化されている |
| アプリケーション | 論理コンポーネント | 個々のモジュールをコンポーネントとしている |
| テクノロジー | プラットフォーム/サービスレベル | 個々のサーバー |
| ケイパビリティ | 2~3階層の深さ | 運用アクティビティ |
主な原則
- 80/20の法則:ほとんどのモデリングでは、ArchiMate の要素の一部だけで十分です
- ステークホルダーのニーズに合わせる:詳細なビューポイントは、1つのレイヤー/1つの側面に絞ります
- ビューの複雑さを抑える:ビューあたり約20要素を目標にします(最大40要素)
ビューポイントの選択
ステークホルダーとビューポイントの対応
| ステークホルダーの種類 | 推奨されるビューポイント |
|---|---|
| CxOs、ビジネスマネージャー | 戦略、ケイパビリティマップ、動機 |
| エンタープライズアーキテクト | レイヤー、アプリケーション協調、実装 |
| プロセスアーキテクト | ビジネスプロセス協調、サービス実現 |
| アプリケーションアーキテクト | アプリケーション利用、実装とデプロイメント |
| インフラストラクチャアーキテクト | テクノロジー、テクノロジー利用、物理 |
パターンとビューポイントの対応
| アーキテクチャパターン | 主なビューポイント |
|---|---|
| マイクロサービス | アプリケーション協調、レイヤー、テクノロジー利用 |
| API/統合 | アプリケーション協調、サービス実現 |
| クラウドインフラストラクチャ | テクノロジー、デプロイメント、レイヤー |
| データアーキテクチャ | 情報構造、アプリケーション協調 |
| ケイパビリティマッピング | ケイパビリティマップ、戦略、リソースマップ |
モデル品質チェックリスト
作成前
- スコープと目的を定義する
- ステークホルダーと懸念事項を特定する
- 適切なビューポイントを選択する
- 命名規則を定める
モデリング中
- 命名規則に一貫して従う
- 正しい要素タイプを使用する
- 適切な抽象化レベルでモデル化する
- 既存の要素を再利用する(重複させない)
- 要素に説明を追加する
モデルレビュー
- 要素のタイプが正しい
- 名前が命名規則に従っている
- 孤立した要素がない
- 厳格なレイヤー違反がない
- 関係の方向が正しい
- ビューに一貫性のあるストーリーが示されている
モデルの構成
フォルダー構造(レイヤー別)
Model
├── Strategy
├── Business
├── Application
├── Technology
├── Physical
├── Motivation
├── Implementation & Migration
├── Relations
└── Views
フォルダー構造(ドメイン別)
Model
├── Customer Domain
│ ├── Business
│ ├── Application
│ └── Technology
├── Finance Domain
└── Shared Services
その他のリソース
参考ファイル
ビューポイントの詳細なガイダンスとフレームワーク統合については、以下を参照してください。
references/viewpoints.md- ArchiMate ビューポイントの完全なカタログreferences/framework-integration.md- TOGAF、BPMN、IT4IT の統合パターン
コメント
Markdown 対応