ドキュメント - Archyl
Archylの使い方を学ぶ。
Getting started
- Archyl の紹介 — Archyl とは何か、C4 モデルを使用してソフトウェアアーキテクチャをドキュメント化する方法を学びましょう
- クイックスタートガイド — 5 分で Archyl を始めましょう - 最初のアーキテクチャダイアグラムを作成
- コアコンセプト — Archyl で使用される主要な概念と用語を理解しましょう
C4 model
Features
- AIによるディスカバリー — Archylがコードベースからアーキテクチャを自動的に発見・ドキュメント化するAI機能について
- アーキテクチャ変更リクエスト — 構造化された変更リクエストワークフローを通じてC4アーキテクチャモデルへの変更を提案、レビュー、マージ
- ドキュメントとADR — Archylでアーキテクチャドキュメントとアーキテクチャ決定記録を作成・管理
- ユーザーフロー — アーキテクチャ全体のインタラクションのシーケンスを可視化するユーザーフローとデータフローのドキュメント化
- コードとしてのアーキテクチャ — archyl.yamlでC4アーキテクチャを定義・同期 — バージョン管理、CI/CD対応、完全な宣言型
- アーキテクチャ・タイムラプス — プロジェクトのバージョン履歴を映画のように再生 — 要素が自ら描かれ、廃止されたサービスに取り消し線が入り、エンドクレジットが流れます。そのままブラウザ内だけでレンダリングして 1080p の MP4 として書き出せます
- アーキテクチャインサイト — アーキテクチャの問題を自動検出し、システム設計改善の推奨事項を取得
- 共有とエクスポート — ステークホルダーとのアーキテクチャダイアグラムの共有と各種フォーマットへのエクスポート
- APIコントラクト — C4アーキテクチャ要素に直接リンクされたAPI仕様のドキュメント化と管理
- リリース管理 — GitHub Actions、Webhook、REST API を使用した自動取り込みで、アーキテクチャ全体のデプロイメントを追跡
- マーケットプレイス連携 — 外部サービスを接続して、アーキテクチャと共にライブメトリクス、アラート、ダッシュボードを表示
- プロダクションリアリティ（リビングダイアグラム） — Kubernetes、Datadog、New Relic などの本番ソースを接続して稼働中のサービスと依存関係を検出し、それらを C4 モデルと突き合わせて整合させます — 読み取り専用かつ非破壊的
- テクノロジーレーダー — テクノロジーランドスケープの可視化、採用レベルの追跡、すべてのプロジェクト全体での技術スタックの管理
- Webhook 通知 — プロジェクトでアーキテクチャの変更が発生した際に、リアルタイムの HTTP 通知を受信
- Slack & Teams ボット — Slack や Microsoft Teams からアーキテクチャについて Archyl に質問し、ライブ MCP ツールで回答・操作させましょう
- オーナーシップマップ — インタラクティブなバブル、依存関係ライン、カバレッジトラッキングでアーキテクチャ全体のチームとユーザーの所有権を可視化
- 適合性ルール (Guardrails) — C4 model、技術的意思決定、コーディング標準に対してコード変更を検証する決定論的なアーキテクチャルールを定義します — AI は不要
- GitHub Actions 統合 — Archyl の公式 GitHub Actions を使用して、プルリクエストでアーキテクチャ適合性チェックを実行し、プッシュごとに C4 モデルを同期します
- マネージドエージェント実行 — スケジュールに基づいて動作する自律型AIエージェントを起動し、MCPコネクタで外部サービスと連携させ、完全なアーキテクチャコンテキストを持ってコードベース上で作業させます
- 独自の AI プロバイダー — Archyl のすべての AI 機能を独自のプロバイダー(OpenAI、Anthropic、Google Gemini、AWS Bedrock、または任意の OpenAI 互換エンドポイント)経由で独自の認証情報を使用してルーティング — そして Archyl のクォータ制限をスキップ。
Guides
- 最初のプロジェクトの作成 — Archyl で最初のアーキテクチャプロジェクトを作成し、ドキュメント化するためのステップバイステップガイド
- ダイアグラムの埋め込み — インタラクティブな Archyl ダイアグラムを Confluence、Notion、Miro などのプラットフォームに埋め込む
- セキュリティ — Archyl がデータとアーキテクチャ情報をどのように保護するかを学びましょう
- 設定と構成 — AI プロバイダーの設定、サブスクリプションの管理、Archyl 体験のカスタマイズ
- コーディングエージェントプラグイン — Archylコーディングエージェントプラグインをインストールして、Claude Code、Codex、または互換性のあるコーディングエージェントからアーキテクチャを直接管理する方法
- Archyl Harness — あらゆるコーディングエージェントを5分でアーキテクチャ対応に。絞り込まれたコンテキスト、統制された作業セッション、Guardrails の強制、そしてエージェント間で積み上がるメモリ
Git integration
- Git 統合の概要 — Git リポジトリを接続して AI 搭載のアーキテクチャディスカバリーを有効にしましょう
Collaboration
- チーム管理 — Archylでチームを作成・管理し、コラボレーションを向上させる方法
- リアルタイムホワイトボード — チームとリアルタイムでアーキテクチャダイアグラム上でコラボレーション
- Team Architecture Digest — Send a recurring email recap of architecture activity to each team — drift, ADRs, conformance, discussions.