コーディングエージェントスキル

Archylは、アーキテクチャ全体をコーディングエージェント（Claude Code、Codex、Cursor、または互換性のあるツール）に取り込む11個のコーディングエージェントスキルを提供しています。エディタとArchylダッシュボードを行き来する必要はありません。エージェントがコーディング前に変更を検証し、リリースした内容を文書化し、C4モデルに照らしてプルリクエストをレビューし、アーキテクチャのドリフトを予測します。すべてターミナルから行えます。

スキルはオープンソースで、github.com/archyl-com/agent-skillsで公開されています。

AIネイティブなアーキテクチャワークフロー

11個のスキルは連携して、継続的なアーキテクチャのループを形成します：

preflight → code → review → CI (GitHub Actions) → postship → generate context
    ↑                                                              |
    └──────────────────────────────────────────────────────────────┘

前提条件

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

インストール

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

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

/plugin marketplace add archyl-com/agent-skills

次に、自動更新を設定します：

1. /plugin を実行
2. Marketplaces を選択
3. archyl-marketplace を選択
4. Enable auto-update を選択

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

/plugin install archyl-developer@archyl-marketplace

archyl-developer プラグインで、11 個のスキルすべてと Guard フックがインストールされます。インストール後、コーディングエージェントを再起動してください。

ステップ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キーに置き換えてください。

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

スキルファイルは、プラグイン形式をサポートするすべてのエージェントと互換性があります。Cursor、Codex、その他のツールでは、agent-skillsリポジトリから直接使用することもできます。

クイックセットアップ

最も手早く始める方法はセットアップスクリプトです。エージェントに必要な設定ファイルをすべて生成します。

セットアップスクリプト

プロジェクトのルートで実行します：

npx archyl-setup

次の3つのファイルが作成されます：

テンプレート：CLAUDE.md

生成される CLAUDE.md には、次のような指示が含まれます：

# Architecture

This project is documented in Archyl (project ID: `proj_xxx`).

## Before coding
Run `/archyl-preflight` to validate your approach against the architecture.

## After shipping
Run `/archyl-postship` to update the C4 model and create ADRs.

## Architecture rules
Always run `/archyl-review` before requesting a code review.

これらのテンプレートは、チームのワークフローに合わせてカスタマイズできます。

コアスキル

archyl-developer

基盤となるスキルです。以下のドメインにわたるArchylの200以上のMCPツールに関する構造化された知識をエージェントに提供します：

プロンプト例：

Create a new system called PaymentPlatform with containers for
the API server, a PostgreSQL database, and a React frontend.

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 technology radar. Add Temporal as an adopted workflow
orchestration technology and tag it on the OrderProcessing container.

archyl-preflight

コーディングを始める前に実行し、計画しているアプローチを既存のアーキテクチャに照らして検証します。プリフライトは、計画をC4モデル、適合性ルール、最近のADRと突き合わせ、違反を早い段階で見つけます。

プロンプト例：

/archyl-preflight I'm planning to add a new Redis cache between the
API server and the database to reduce read latency.

/archyl-preflight We want to split the UserService into separate
authentication and profile services.

このスキルは、依存関係の違反、名前の衝突、既存のADRと矛盾するアプローチなどの問題を、コードを1行も書く前に指摘します。

archyl-postship

リリース後に実行し、アーキテクチャドキュメントを自動的に更新します。コードベースで何が変わったかを分析し、次のことを行います：

• C4モデルを更新（新しいコンテナ、コンポーネント、リレーションシップ）
• 重要な決定についてADRを作成
• 必要に応じて、チームのレビュー用に変更リクエストを作成

プロンプト例：

/archyl-postship We just shipped the Redis caching layer.
Update the architecture to reflect the new cache container
and its relationships.

/archyl-postship Document the authentication service split
we shipped this sprint.

archyl-harness

ガバナンスのもとでコーディングするための作業セッションプロトコルで、Archyl Harnessを支えるスキルです。開始前の plan_work、絞り込まれたコンテキストとアドバイザリーリースを得るための start_work_session、プロジェクトのナレッジグラフを扱う remember/recall、そしてアーキテクチャ変更リクエストを作成できる結果を伴う finish_work_session という、ループ全体をエージェントに教えます。

Work under the harness: plan, declare a session, respect the
guardrails, and finish with an honest summary.

レビューとガバナンスのスキル

archyl-review

構造化されたアーキテクチャレビューボットです。C4モデル、適合性ルール、ADRに照らして差分を分析し、アーキテクチャを踏まえたコードレビューコメントを提供します。

プロンプト例：

/archyl-review Review the current branch against the architecture.
Flag any conformance violations or undocumented dependencies.

/archyl-review Check if PR #42 introduces any new cross-system
dependencies that aren't in the C4 model.

archyl-changelog

アーキテクチャの変更履歴を生成します。ADR、リリース、適合性チェック、ドリフトイベント、モデルの更新を含む変更のタイムラインです。

プロンプト例：

/archyl-changelog Show the architecture timeline for the last month.

/archyl-changelog What changed in the PaymentPlatform system
since the v2.0 release?

archyl-autofix

コードとアーキテクチャドキュメントの間でドリフトが検出されると、autofixは両者を再び同期させるための具体的な修正を、コードまたはモデルのいずれかに対して提案します。

プロンプト例：

/archyl-autofix We have drift on the PaymentService container.
Propose fixes to resolve it.

/archyl-autofix Show all current drift issues and suggest
the fastest path to zero drift.

インテリジェンススキル

archyl-dora

アーキテクチャの変更とDORAのデリバリーパフォーマンスメトリクスを関連付けます。アーキテクチャ上の決定が、デプロイ頻度、リードタイム、変更失敗率、平均復旧時間にどう影響するかを確認できます。

プロンプト例：

/archyl-dora Show DORA metrics for the last quarter.
Did the microservice split improve deployment frequency?

/archyl-dora Correlate recent architecture changes
with our change failure rate trend.

archyl-roi

アーキテクチャ上の決定がもたらす財務的な影響を算出します。アーキテクチャの改善によって節約される時間、防がれるインシデント、開発者の生産性の変化を見積もります。

プロンプト例：

/archyl-roi What's the estimated ROI of our migration
from monolith to microservices?

/archyl-roi Calculate the cost of our current architectural
drift vs the cost of fixing it.

archyl-predict

将来起こりうるアーキテクチャの問題を、発生する前に予測します。過去の傾向をもとに、ドリフト、DORAメトリクスの悪化、複雑さのホットスポットを予測します。

プロンプト例：

/archyl-predict Which components are most likely to drift
in the next 30 days?

/archyl-predict Based on current trends, will our deployment
frequency regress this quarter? Which services are at risk?

オーケストレーション

archyl-orchestrate

同じコードベースで作業する複数のエージェントを調整します。サービス間のAPIコントラクトの調整や依存関係の衝突の解決を行い、エージェント同士が矛盾するアーキテクチャ変更を加えないようにします。

プロンプト例：

/archyl-orchestrate Two agents are modifying services that share
an API contract. Coordinate the changes to avoid conflicts.

/archyl-orchestrate Agent A is adding a new field to the
UserService API. Check if Agent B's PaymentService integration
will break.

このスキルは、異なるエージェントがそれぞれ別のサービスを担当し、互いの作業を妨げずに共有コントラクトを調整する必要があるマルチエージェント構成で特に役立ちます。

適合性ルールパック

Archylは、マイクロサービス、イベント駆動、レイヤードなど、一般的なアーキテクチャパターン向けの構築済み適合性ルールパックを提供しています。これらのルールパックは上記のすべてのスキルと連携し、アーキテクチャを自動的に強制します。

利用可能なルールパックとカスタムルールの作成方法については、適合性ルールガイドをご覧ください。

SDK

コーディングエージェント以外の独自ツールにArchylを組み込みたい場合は、TypeScript、Python、Go向けのSDKを利用できます。

SDKの詳細とAPIリファレンスについては、MCPサーバーのドキュメントをご覧ください。

仕組み

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

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

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

C4モデルリファレンス

スキルはC4モデルの全4レベルを理解しています：

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

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

コントリビューション

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

• ツール名、パラメータ、説明の修正
• 新しいArchyl機能のカバレッジ追加
• ワークフロー例の改善
• 追加のユースケース向けの新しいスキルファイルの作成

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