クイックスタートガイド

このガイドでは、Archyl で最初のアーキテクチャダイアグラムをわずか数分で作成する方法を説明します。

ステップ 1:アカウントの作成

  1. app.archyl.com にアクセスします
  2. メールアドレスでサインアップするか、GitHub、GitLab、または Bitbucket で接続します
  3. メールアドレスでサインアップした場合は、メールを確認してください

サインインすると、すべてのプロジェクトの司令塔となるダッシュボードが表示されます:

Archyl のダッシュボード:プロジェクト、システム、コンテナ、アーキテクチャインサイトをひと目で確認

ステップ 2:最初のプロジェクトの作成

  1. ダッシュボードで 「新規プロジェクト」 をクリックします
  2. プロジェクト名を入力します(例:「EC プラットフォーム」)
  3. 必要に応じて説明とタグを追加します
  4. 「プロジェクトを作成」 をクリックします

新規プロジェクトダイアログ

ステップ 3:最初のシステムの追加

  1. 新しいプロジェクトでは、システムコンテキスト レベルから始まります
  2. 「+」 ボタンをクリックするか、キャンバス上で右クリックします
  3. 「システムを追加」 を選択します
  4. 名前を入力します(例:「EC プラットフォーム」)
  5. システムの機能の説明を追加します

ステップ 4:外部システムの追加

実際のシステムは孤立して存在しません。ソフトウェアが連携する外部システムを追加しましょう:

  1. 「+」 をクリックし、「外部システムを追加」 を選択します
  2. 「決済ゲートウェイ」、「メールサービス」、「CDN」などのシステムを追加します
  3. これらは外部であることを示す異なるスタイルで表示されます

ステップ 5:関係の作成

システム間の通信方法を示します:

  1. ソースシステムをクリックします
  2. 接続ポイントからターゲットシステムにドラッグします
  3. 関係を説明するラベルを追加します(例:「API 経由で決済処理」)

人、システム、外部プロバイダーがラベル付きの関係で結ばれた、完全なシステムコンテキストビューは次のとおりです:

ラベル付きの関係を含む完全なシステムコンテキスト図

任意の要素をクリックすると、説明、オーナー、リンクされた決定、ドキュメント、API コントラクトなどの詳細が開きます:

ライブキャンバスの横に表示される要素の詳細パネル

ステップ 6:コンテナへのズームイン

メインシステムをダブルクリックして、コンテナレベルに深入りします:

  1. 「Web アプリケーション」、「API サーバー」、「データベース」などのコンテナを追加します
  2. それらの間の通信方法を示します
  3. 外部システムに接続します

ステップ 7:コーディングエージェントの接続

プロジェクトを作成すると、ダッシュボードに 3 つのステップからなる エージェントを働かせる ブロックが表示されます。各ステップは、Archyl が完了を確認すると自動的にチェックされます。

  1. コーディングエージェントを接続 をクリックします。開いたウィンドウで使用するツール(Claude Code、Cursor、VS Code、OpenAI Codex)を選び、キーを作成 をクリックします。
  2. ウィンドウに表示された内容を貼り付けます。Claude Code では 1 行のコマンド、その他のツールでは設定ファイルです。キーはすでに含まれており、サーバー URL によってコーディング用ツールプロファイルが選択されます。これはコーディングエージェント向けに絞り込まれたツールセットです。
  3. エージェントを再起動し、Archyl のプロジェクトを一覧表示するよう依頼します。最初の呼び出しが届くとすぐに、ウィンドウに エージェントが接続されました と表示されます。
  4. エージェントに最初のタスクを与えます。ウィンドウが提案するプロンプトを使うと、エージェントはコードを変更する前に plan_work を呼び出し、Harness のもとで作業セッションを開始します。Archyl でマネージドエージェントの実行を開始しても、このステップは完了します。

ブロックを非表示にするには、隅にある × をクリックします。サポートされているツールの全一覧とその設定は、プロフィールの MCPサーバー で確認できます。

次のステップ

おめでとうございます!最初のアーキテクチャダイアグラムを作成しました。次に探索できることは以下の通りです:

成功のヒント

  • 高レベルから始める:詳細に入る前にシステムコンテキストから始めましょう
  • 明確な名前を使う:システムとコンテナに説明的な名前を付けましょう
  • 説明を追加する:将来のあなた(とチーム)が感謝するでしょう
  • 反復する:アーキテクチャドキュメントは生きたものです——システムの進化に合わせて更新しましょう