Backstage vs Archyl：アーキテクチャドキュメントへの2つのアプローチ
アーキテクチャドキュメントのツールを評価しているなら、おそらくBackstageを見たことがあるでしょう。オープンソースでSpotifyが支援しており、CI/CDからコスト管理まであらゆるものをカバーするプラグインエコシステムがあります。そのプラグインの一つがC4図を扱います。
Archylは正反対のアプローチを取っています。デベロッパーポータルではありません。CIパイプラインやサービスカタログを管理しません。1つのことだけを行います：C4モデルによるアーキテクチャドキュメント——そしてそれを深く追求します。
これは「どちらのツールが良いか」という記事ではありません。目的が異なります。しかし、本当に必要なのがアーキテクチャドキュメントであれば、違いは重要です。
核心的な哲学
Backstageはデベロッパーポータルフレームワークです。開発チームが使用するすべてのツール、サービス、ドキュメントを単一の内部プラットフォームに統合するのが仕事です。アーキテクチャドキュメントは利用可能な多くのプラグインの1つです。
Archylは専用に構築されたアーキテクチャドキュメントプラットフォームです。製品全体がC4モデルを使用したソフトウェアアーキテクチャのモデリング、可視化、分析、進化のために存在します。
C4モデルサポート
Backstage
BackstageのC4プラグインはカタログエンティティから図を生成します。システムコンテキストとコンテナビューをサポートします。**C4レベル3（コンポーネント）またはレベル4（コード）のネイティブサポートはありません。**コンテナレベル以下のアーキテクチャモデリングが必要な場合、壁にぶつかります。
Archyl
Archylは4つのC4レベルすべてをネイティブに実装しています。各レベルに専用のノードタイプ、ビジュアルスタイル、メタデータがあります。システムからコンテナ、コンポーネント、コード要素まで、同じインタラクティブな図内でドリルダウンできます。
可視化
Backstage
C4プラグインはカタログデータから静的または半インタラクティブな図を生成します。キャンバス操作、ドラッグ＆ドロップ、図上のリアルタイムコラボレーションはありません。
Archyl
React Flow上に構築された完全インタラクティブなキャンバスを提供します。ドラッグ配置、リレーションシップの描画、C4レベル間のナビゲーション、チームメイトのリアルタイムカーソル表示、オートレイアウト、オーバーレイが可能です。
AI駆動の発見
Backstage
組み込みのAI駆動アーキテクチャ発見はありません。200のサービスにcatalog-info.yamlがない場合、200のYAMLファイルを手書きするか、カスタムツールを構築する必要があります。
Archyl
組み込みのAI発見がGitリポジトリに接続し、コードベースを読み取り、完整なC4モデルを自動生成します。
インパクト分析
Backstage
インパクト分析機能はありません。サービスを廃止した場合の影響を理解するには、手動でカタログの依存関係を追跡します。
Archyl
インパクトレーダーが図上で直接包括的なインパクト分析を提供します。上流/下流の依存関係、リスクスコア、クリティカルパス、クロスプロジェクト依存関係、what-ifシミュレーションを即座に確認できます。
ライブ運用データ
Backstageのプラグインエコシステムはここが強みですが、プラグインはポータル内の個別ページに存在し、アーキテクチャビューには接続されていません。
ArchylのMarketplaceは、ライブデータをアーキテクチャワークスペース上のウィジェットとして直接表示する統合を提供します：CI/CD、可観測性、コード品質、インシデント管理。
比較表
| 機能 | Backstage | Archyl |
|---|---|---|
| APIコントラクト | カタログ内のAPIエンティティ | 完全なOpenAPI/gRPC/GraphQLコントラクトをC4要素にリンク |
| イベントチャネル | ネイティブサポートなし | Kafka、NATS等のチャネルを要素にリンク |
| ユーザーフロー | ネイティブサポートなし | アーキテクチャ要素に紐づくステップバイステップのフロー図 |
| アーキテクチャインサイト | ネイティブサポートなし | AI生成の重要度スコア付き推奨事項 |
| リリース管理 | ネイティブサポートなし | 環境とシステム横断のデプロイ追跡 |
| グローバルアーキテクチャ | クロスプロジェクトビューなし | 複数プロジェクトのシステムを接続するグローバルビュー |
| MCPサーバー | ネイティブサポートなし | Claude、Cursor等のAIツールがアーキテクチャモデルを読み書き |
| エクスポート/インポート | YAMLベースのカタログ | JSONエクスポート/インポートによる完全なプロジェクト移植性 |
| オンプレミス | セルフホスト（必須） | クラウドまたはセルフホスト（Docker、Kubernetes、Helm） |
どちらを選ぶか
Backstageを選ぶ場合： ドキュメント、CI/CD、サービスカタログ等を集約する統一デベロッパーポータルが必要で、ハイレベルなC4ビューで十分な場合。
Archylを選ぶ場合： アーキテクチャドキュメントが主要な関心事だが、運用の可視性を犠牲にしたくない場合。ArchylはC4モデル（全4レベル）、AI発見、インパクト分析、変更ガバナンスを深く追求しつつ、Marketplace統合がライブ運用データを直接アーキテクチャに表示します。
両者は共存も可能です。
結論
Backstageはプラグインから組み立てるプラットフォームフレームワークです。強力で柔軟ですが、アーキテクチャドキュメント機能はカタログ駆動のC4プラグインが提供できるものに限られます。
Archylはアーキテクチャに深く入り込む専門ツールです。完全なC4モデル、AI発見、インパクト分析、変更ガバナンス、リアルタイムコラボレーションをカバーし、CI/CD、可観測性、コード品質、インシデントツールに接続して運用の現実に根ざしたアーキテクチャを実現します。
あなたのアーキテクチャはカタログエントリ以上の価値があります。
C4モデルが初めてですか？C4モデル入門から始めましょう。すでにモデリング中なら、AI駆動アーキテクチャ発見でコードから最初のプロジェクトをブートストラップするか、インパクトレーダーで変更前に影響を理解しましょう。