mcpField
A
ArchiMate Model Quality

ArchiMate Model Quality

github.com/thomasrohde開発238 回インストール26 週間前に更新
リポジトリ

ArchiMate Model Quality について

ArchiMate Model Qualityは、明確なArchiMateモデルの作成と保守を支援するガイダンススキルです。命名、粒度、視点、構成に加え、構造や関係に関する一般的な問題の確認方法を扱います。

主な機能

  1. 01要素の命名規則の適用
  2. 02適切な抽象度と粒度の選択
  3. 03ステークホルダーに応じた視点の選定
  4. 04レイヤーまたはドメイン別のモデル構成
  5. 05関係とモデル上の問題の確認

活用シーン

  1. 01ArchiMateモデル作成前の規則策定
  2. 02ステークホルダーの関心に合うビューの選定
  3. 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つの要素に責務が集中している役割に特化したコンポーネントに分割します
過剰に細分化されたインターフェース細かい関係が多すぎる適切な抽象度で統合します
関係の欠落暗黙の依存関係がモデル化されていない関係を明示します
循環依存関係が循環している循環をなくすように再構成します

よくあるモデリングエラー

  1. 抽象度の混在:戦略的なケイパビリティと詳細なプロセスを並べて配置する
  2. 関連をデフォルトで使用する:より具体的な関係タイプが適用できる場合
  3. 過剰なモデリング:あらゆる詳細を取り込み、保守の負担を生み出す
  4. 要素タイプの誤り:適切なタイプがファンクションである場合にプロセスを使う
  5. サービスレイヤーの欠落:サービスの抽象化を介さずに直接接続する
  6. ビュー中心の考え方:再利用せず、単一のビューのためだけに要素を作成する
  7. 命名の不整合:ビューごとに同じ概念を異なる名前で表す

抽象度と粒度

目的別の抽象度
目的抽象度対象者
情報提供高(概要)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 の統合パターン

コメント