コーディングエージェントプラグイン - Archyl Docs

Archylコーディングエージェントプラグインをインストールして、Claude Code、Codex、または互換性のあるコーディングエージェントからアーキテクチャを直接管理する方法

コーディングエージェントプラグイン

Archyl開発者プラグインを使うと、コーディングエージェント（Claude Code、Codex、または互換性のあるツール）からC4アーキテクチャモデル全体を直接管理できます。エディタとArchylダッシュボードを切り替える必要はなく、ターミナルから離れることなく、システム、コンテナ、コンポーネント、ADR、適合性ルールなどを作成できます。

このプラグインはオープンソースで、github.com/archyl-com/agent-skillsで公開されています。

できること

このプラグインは、以下のドメインにわたるArchylの200以上のMCPツールに関する深い知識をエージェントに提供します：

ドメイン 機能
C4モデリング システム、コンテナ、コンポーネント、コード要素、リレーションシップの作成と管理
ドキュメント アーキテクチャ決定記録、プロジェクトドキュメント、ユーザー/システムフロー、AIインサイト
ガバナンス 適合性ルール、ドリフト検出、DORAメトリクス、オーナーシップマッピング
運用 リリース、環境、APIコントラクト、イベントチャネル、テクノロジーレーダー
コラボレーション コメント、変更リクエスト、ホワイトボード、チーム管理
履歴 スナップショット、タイムトラベル、アーキテクチャ差分、監査ログ
インテグレーション Webhook、マーケットプレイスウィジェット、グローバルアーキテクチャビュー

前提条件

  • APIアクセスが可能なArchylアカウント
  • APIキー（Archylダッシュボードの設定 → APIキーから取得）
  • Claude Code、Codex、または互換性のあるコーディングエージェント

インストール

ステップ1：マーケットプレイスの追加

Claude Codeで以下のコマンドを実行してください：

/plugin marketplace add archyl-com/agent-skills

次に、プラグインマネージャーを開いて自動更新を設定します：

  1. /plugin を実行
  2. Marketplaces を選択
  3. リストから archyl-marketplace を選択
  4. Enable auto-update または Disable auto-update を選択

ステップ2：プラグインのインストール

/plugin install archyl-developer@archyl-com-agent-skills

インストール後、Claude Codeを再起動してください。

ステップ3：MCPサーバーの設定

プロジェクトの .mcp.json にArchyl MCPサーバーを追加します：

{
    "mcpServers": {
        "archyl": {
            "type": "http",
            "url": "https://api.archyl.com/mcp",
            "headers": {
                "X-API-Key": "arch_your_api_key_here"
            }
        }
    }
}

arch_your_api_key_here をArchylダッシュボードで取得した実際のAPIキーに置き換えてください。

その他のコーディングエージェント

プラグインのコンテンツは、プラグイン形式をサポートするすべてのエージェントと互換性があります。リポジトリ内のarchyl-developerプラグインディレクトリからスキルファイルを直接使用することもできます。

一般的なワークフロー

インストール後、コーディングエージェントに自然言語でアーキテクチャタスクを実行するよう依頼できます。以下は一般的なワークフローの例です：

新しいプロジェクトのドキュメント化

エージェントにアーキテクチャモデルのスキャフォールディングを依頼します：

Create a new Archyl project for our e-commerce platform.
Add the main systems: WebApp, PaymentService, and PostgreSQL Database.
Then create containers for the API server and React frontend inside WebApp.

エージェントは適切なMCPツール（create_project、create_system、create_container）を呼び出し、すべてを接続します。

既存アーキテクチャの分析

Get the full C4 model for my project and summarize the architecture.
Check the drift score — is the documentation still accurate?
Show me any open architecture insights.

アーキテクチャルールの適用

Create a conformance rule that prevents any container from having
more than 10 direct dependencies. Then run a conformance check.

アーキテクチャ決定の記録

Create an ADR titled "Migrate from REST to gRPC for internal services".
Set it as proposed, explain the context around latency requirements,
and link it to the ApiGateway and PaymentService containers.

デプロイパフォーマンスの確認

Show me the DORA metrics for the last month.
What's our deployment frequency and lead time trend?

テクノロジーレーダーの管理

Show me the current technology radar.
Add "Temporal" as an adopted workflow orchestration technology
and tag it on the OrderProcessing container.

仕組み

プラグインは、すべてのArchyl MCPツールに関する構造化された知識（パラメータ、期待される値、ベストプラクティスを含む）をコーディングエージェントに提供します。エージェントにアーキテクチャタスクの実行を依頼すると、以下のように動作します：

  1. 呼び出すべきMCPツールを特定する
  2. 正しいパラメータ（プロジェクトID、要素タイプ、リレーションシップタイプ）を構築する
  3. 複雑なワークフローでは複数の呼び出しを連鎖させる
  4. 作成または変更された内容のサマリーを返す

エージェントは常に list_projects を最初に呼び出して、利用可能なプロジェクトを検出し、後続の操作に必要な projectId を取得します。

C4モデルリファレンス

プラグインはC4モデルの全4レベルを理解しています：

レベル 要素 例
1 System "Payment Platform", "Email Service"
2 Container "API Server", "PostgreSQL Database", "React Frontend"
3 Component "AuthService", "PaymentProcessor", "UserRepository"
4 Code "PaymentGateway interface", "processPayment()"

命名規則

エージェントは要素を作成する際に以下の命名規則に従います：

  • Systems: PascalCase、説明的な名前（PaymentPlatform、NotificationService）
  • Containers: PascalCase、タイプのヒント付き（ApiServer、PostgresDatabase、RedisCache）
  • Components: PascalCase、モジュール指向（AuthService、PaymentProcessor）
  • Code要素: ソースコードの正確なシンボル名

リレーションシップタイプ

要素を接続する際、エージェントは適切なリレーションシップタイプを使用します：

タイプ 用途
uses システム間の一般的な依存関係
calls 同期HTTP/gRPC呼び出し
sends_to / consumes_from 非同期メッセージング（キュー、イベント）
reads_from / writes_to データベースアクセス
implements / extends コードレベルの継承

コントリビューション

このプラグインはオープンソースです。以下の方法でコントリビューションできます：

  • ツール名、パラメータ、説明の修正
  • 新しいArchyl機能のカバレッジ追加
  • ワークフロー例の改善
  • 不足しているドメインのリファレンスファイルの追加

詳細はコントリビューションガイドをご覧ください。