ブログ - Archyl

アーキテクチャドキュメントのチュートリアルとベストプラクティス。

あなたの AI エージェントにはルールファイルがあります。システムのモデルはありません。

コーディングエージェントはどれもルールファイルを読みます。CLAUDE.md、AGENTS.md、.cursor/rules。これらのファイルは規約を運び、規約はよく持ちこたえます。同時にシステムについての主張も運びますが、それがまだ正しいかどうかを確かめるものは何もありません。私たちのファイルで何が古びたのか、そして…

Structurizr Cloud は 9 月 30 日に終了：まずモデルを取り出してください

Structurizr のクラウドサービスは 2026 年 7 月 1 日から読み取り専用になり、9 月 30 日にサービス終了を迎えます。ワークスペースを取り出すために使うはずの DSL タブも、そのサービスの一部です。サービスが消えるときに一緒に消えます。今週のうちにモデルを取り出す手順と、その置き場所となる 4…

タイムラプスでアーキテクチャの進化を30秒のフィルムで見る

あなたのアーキテクチャには歴史があります——すべてのバージョンが記録され、すべての変更が残っている。タイムラプスはそれをシネマティックなフィルムに変えます。要素はみずから描かれて登場し、カメラはすべての変更を追いかけ、廃止されたサービスには赤い線が引かれ、最後にはあなたの統計とともにクレジットが流れます。そしてその全部…

送金の解剖学:RevolutをC4でArchylにモデル化する

パリの19時47分。Léaが「送信」をタップすると、彼女がスマホを置く前に£450がロンドンの銀行口座に着金します。その3秒の裏側には:Kafkaなしのイベント駆動バックボーン、50ミリ秒未満の不正判定、そしてPostgreSQL上に構築されたledger。これがその旅、4つのC4レベルでモデル化したもの。

Reality：あなたのアーキテクチャ図が、生きはじめる

アーキテクチャ図は、描いたその日だけ正しいスナップショット。あとはひたすらズレていくだけ。Reality は本番システムとつなぎ、図を「いま実際に動いているもの」の鏡に変えます。読み取り専用。エージェント不要。変更はすべてあなたが承認します。

Archyl が Slack & Teams に登場：チャットでアーキテクチャに質問

アーキテクチャの知識はログインの向こう側に閉じ込めておくべきではありません。Slack や Microsoft Teams で @Archyl をメンションし、C4 モデル・ADR・依存関係・オーナーシップについて質問しましょう。ボットが MCP ツールを呼び出し、その過程を見せながらライブで回答します。

MCP Playground：ドキュメントから直接、エージェントのツールをライブ実行

ドキュメントは MCP ツールが「何をするはずか」を教えてくれます。新しい MCP Playground なら、実際に呼び出せます。ツールを選び、スキーマから自動生成されたフォームに入力して実行ボタンを押せば、ライブの結果をその場で確認。アーキテクチャドキュメントから、ブラウザから、直接。

C4エレメントを、すべてゼロから再デザインしました

新しいnode、新しいedge、新しいcanvas。Archylのダイアグラムは、もう読み解く必要はなく、一目で伝わるようになりました。レベルごとのパレット、フォーカスモード、アニメーションするリレーションシップ — すべて本日リリース。

ライドの解剖学:UberをArchylでC4モデリングする

雨のNYC、午後7時23分、ライダーがUberXを呼ぶをタップ。8秒後、0.4マイル先のドライバーが受諾し、ETAが画面に表示され、料金がロックされ、リアルタイムチャネルが開く。これがその旅で、4つのC4レベルでモデル化されています —…

Chargeの解剖学:StripeをC4でArchylにモデル化する

POSTリクエストがブラックフライデーの午前3時にStripeに到達。20秒後、マーチャントが入金され、cardholderの発行銀行が請求し、署名付きwebhookがマーチャントのサーバーに届きます。これがその旅、4つのC4レベルでモデル化したもの。

C4 Code図（レベル4）：必要なときと不要なとき

C4コード図（レベル4）は、コンポーネント内部のクラス、インターフェース、関数を示します。ほとんどのチームはこれを飛ばすべきですが、常にそうとは限りません。本ガイドでは、C4モデルのレベル4が価値を生むのはいつか、UMLクラス図が労力の無駄になるのはいつか、そして自動生成がトレードオフをどう変えるかを扱います。

C4 Component図：実例で学ぶ完全ガイド

C4コンポーネント図（C4モデルのレベル3）は、1つのコンテナにズームインし、その内部のコンポーネントを示します。本ガイドでは、コンポーネント図とは何か、維持する価値があるのはいつか、完全な実例、よくある間違い、そしてメンテナンスの負担なくレベル3を正確に保つ方法を解説します。

C4 Container図：実例で学ぶ完全ガイド

C4コンテナ図（C4モデルのレベル2）は、システムのデプロイ可能な構成要素、つまりWebアプリ、API、データベース、キューを示します。本ガイドでは、コンテナ図とは何か、何を含めるべきか、完全な実例、よくある間違い、そしてコードと同期させ続ける方法を解説します。

C4モデル vs UML：あなたのチームはどちらを使うべきか？

C4モデル vs UMLは、ソフトウェアアーキテクチャの図の標準を選ぶときにチームが尋ねる最も一般的な質問の1つです。この率直な比較では、UMLが依然として優れている点、C4がモダンなUMLの代替になった理由、そしてどちらがチームに合うかを判断する方法を扱います。

C4 System Context図：実例で学ぶ完全ガイド

System Context図はC4モデルのレベル1であり、チームが作成できる最も重要なアーキテクチャ図です。本ガイドでは、C4のコンテキスト図に何を含めるべきか、完全なコンテキスト図の実例、そして手作業またはコードから生成する方法を解説します。

APIコントラクトとは？定義・実例・ベストプラクティス

APIコントラクトとは、APIのインターフェース（操作、スキーマ、エラー、バージョニングルール）の形式的で合意された仕様です。本ガイドでは、APIコントラクトとは何か、REST・gRPC・GraphQL・イベント・MCPツールに使われるフォーマット、コントラクトファースト vs…

Playの解剖学:NetflixをC4でArchylにモデル化する

NetflixでPlayを押すと、~50のサービスが200ミリ秒未満で連携します。スタック全体 — Member Experience、Streaming Platform、Open Connect、Cosmos — を4つのC4レベルにわたってモデリングするとどう見えるかをご紹介。

AI ネイティブチームのための Architecture Intelligence

AI エージェントが今やコードの大部分を書いています。しかし、アーキテクチャを守っているのは誰でしょうか？本日、10のエージェントスキル、6つの GitHub Actions、コンフォーマンスルールパック、SDK、そして3つの新しい AI 搭載 API をリリースします —…

成熟度スコア：アーキテクチャの健全性を一つのグレードで

ドリフトスコアはドキュメントが正確かどうかを教えてくれます。準拠性はルールが守られているかどうかを教えてくれます。インサイトは何が壊れているかを教えてくれます。DORAは出荷できるかどうかを教えてくれます。しかし、どれも全体像を教えてくれません。成熟度スコアがそれを実現します —…

Architecture Drift Score: あなたのドキュメントは真実を語っていますか？

Architecture Drift Scoreは、ドキュメント化されたアーキテクチャのうちどれだけがコードベースにまだ存在するかを示す0から100の数値です。この記事はその仕組みそのものです。計算式、分母に入るもの、意図的に除外されるもの、このチェックに見えないもの、そしてCIで強制する方法。

Agent Hub：自律型 AI エージェントのためのアーキテクチャガードレール

AI コーディングエージェントはコードを高速に書きます。しかしガードレールがなければ、アーキテクチャの逸脱もまた高速です。本日、Agent Hub をリリースします。これは Archyl の新セクションで、適合性ルールの定義、96 個のプリビルトガードレールカタログの閲覧、そして AI…

Ownership Map：アーキテクチャ全体の責任者を可視化する

すべてのアーキテクチャにはオーナーシップの問題があります。サービスが構築され、チームが変わり、人が去っていく——そして突然、誰が何の責任者なのか誰もわからなくなります。Archylの新しいOwnership Mapは、チームの責任所在を視覚的・インタラクティブに、そして無視できない形で明らかにします。

Architecture as Code：YAMLファイルでC4モデル全体を定義する

アーキテクチャドキュメントをコードベースのファーストクラスシチズンに変える機能をリリースしました。archyl.yaml をご紹介します — 完全なC4モデルを記述し、Gitに格納され、コードレビューを経て、CI/CDで自動同期される宣言型DSLです。

Webhook：アーキテクチャ変更のリアルタイム通知

アーキテクチャは常に変化しています——システムが追加され、コンポーネントが進化し、ADRが書かれ、リリースがデプロイされます。その変更が起きた瞬間に通知を受け取れるようになりました。Archylの新しいWebhook通知機能で、アーキテクチャイベントを任意のHTTPエンドポイントにリアルタイムでプッシュできます。

テクノロジーレーダー：テクノロジーランドスケープを一目で可視化する

Archyl がアーキテクチャを支えるテクノロジーを追跡するようになりました。言語、フレームワーク、データベース、ツールをあらゆる C4 要素にアタッチし、インタラクティブなレーダーでテクノロジーランドスケープ全体を探索できます。採用レベルでフィルタリング、クアドラントで分類、使用する各要素へのディープリンク付き。

オートレイアウト：アーキテクチャ図を一瞬で整理

C4図上で何十ものノードを手動配置する作業は、アーキテクチャ的な価値を何も生まない退屈な仕事です。オートレイアウトはELK.jsのグラフアルゴリズムを使用して、図内のすべての要素、オーバーレイ、リレーションシップの最適位置を計算し、ワンクリックですべてをアニメーション配置します。

インパクトレーダー：変更する前に変更を理解する

すべてのアーキテクチャ変更は波紋を送ります。インパクトレーダーは、コミットする前にその波紋がどこに向かうかを正確に確認できます。C4モデルの任意の要素を右クリックし、上流の依存者、下流の依存関係、影響を受けるフロー、クロスプロジェクトリスクを即座に可視化します。

Backstage vs Archyl：アーキテクチャドキュメントへの2つのアプローチ

Backstageは偶然C4プラグインを含むデベロッパーポータルです。ArchylはC4モデルを中心にゼロから構築されたアーキテクチャドキュメントプラットフォームです。両者ともアーキテクチャの可視性を解決すると主張していますが、まったく異なる方法で解決します。正直な比較をお届けします。

オンプレミスデプロイ：コードと同じ場所に住むアーキテクチャドキュメント

すべての組織がアーキテクチャデータをクラウドに送れるわけではありません。規制産業、政府機関、セキュリティを重視するチームは、ツールを自社のインフラで実行する必要があります。Archyl は自社インフラで実行できるセルフホスト型デプロイメントとして提供されます。同じ機能、あなたのネットワーク、あなたのルールで。

Marketplace統合：ツールのライブデータをアーキテクチャ上に

アーキテクチャ図は何が存在するかを教えてくれます。ダッシュボードはその状態を教えてくれます。この2つは常に別々のツールにありました。今日それを統合します。Archylの新しいMarketplaceでDatadog、GitHub、SonarQube、Prometheus、ArgoCD、GitLab、PagerDutyを接…

リリース管理：アーキテクチャ全体のデプロイメントを追跡する

アーキテクチャダイアグラムは何が存在するかを示します。今やそれに加えて、何がリリースされたかも示します。Archyl の新しいリリース管理機能では、GitHub Actions、Webhooks、REST API からの取り込みにより、システムと環境をまたいでデプロイメントを追跡できます。

APIコントラクト：アーキテクチャにリンクされたAPI仕様

API仕様はコードベースで最も価値のある成果物の一つですが、アーキテクチャドキュメントにはほとんど登場しません。これを変えます。ArchylではOpenAPI、gRPC、GraphQL、AsyncAPIのコントラクトをインポートし、C4モデルに直接リンクできるようになりました。

エンタープライズSSO：CustomプランのSAMLとOIDC認証

エンタープライズチームには集中ID管理が必要です。ArchylはSAML 2.0とOpenID ConnectによるカスタムSSO接続をサポートし、チームが会社のIDプロバイダーを通じてサインインできるようになりました——個別のパスワード不要、手動プロビジョニング不要。

C4 ダイアグラムとグローバルアーキテクチャでのリアルタイムコラボレーション

アーキテクチャのコラボレーションはホワイトボードで止まるべきではありません。リアルタイムプレゼンス、ライブカーソル、要素フォーカストラッキングをプロジェクト C4 ダイアグラムとグローバルアーキテクチャビューに拡張します。チーム全体が同じアーキテクチャで同時に作業できます。

リビングアーキテクチャドキュメンテーション：ドキュメントを常に最新に保つ

リビングアーキテクチャドキュメンテーションはフォーマットではなく、働き方です。モデルはコードから導出され、更新は変更と同じプルリクエストに同乗し、それがうまくいったかを何かがチェックします。それを成立させる5つのプラクティス、それぞれのコスト、そしてそれぞれが破綻する場所を解説します。

ソフトウェアアーキテクチャチームのためのDORAメトリクス

DORAメトリクスはエンジニアリングパフォーマンスを測定しますが、ほとんどのチームはアーキテクチャと切り離して追跡しています。このガイドでは、DORAメトリクスをアーキテクチャの意思決定に接続し、システム設計のガイドに活用し、ArchylのDORA統合でアーキテクチャを認識したパフォーマンス追跡を行う方法を解説します。

MCPサーバーをアーキテクチャドキュメンテーションに活用する方法

AIアシスタントは開発者の仕事を変革していますが、あなたのアーキテクチャドキュメンテーションを見ることはできません。MCPサーバーはそのギャップを埋めます。このガイドでは、MCPとは何か、なぜアーキテクチャにとって重要か、そしてArchylの181のMCPツールでClaudeやCursorから直接アーキテクチャをクエリ…

アーキテクチャドリフト検出：コードと設計の整合性を保つ

アーキテクチャドリフトとは、文書化したシステムと実際に手元にあるシステムとのギャップです。これに対する定番のアドバイス（ドキュメントをコードの隣に置く、同じプルリクエストでレビューする）は正しいものですが、それが機能したかどうかは何ひとつ教えてくれません。このガイドでは、ドリフトとは何か、検出する方法、そしてすでに存在…

AI搭載アーキテクチャドキュメンテーション：未来はここにある

手動のアーキテクチャドキュメンテーションは勝ち目のない戦いです。コードは毎日変わり、図は四半期ごとに更新されます。AIはこの方程式を変えつつあります。コードからアーキテクチャを発見し、ドリフトを自動検出し、AIエージェントにアーキテクチャの認識を与えます。その仕組みと今後の方向性を解説します。

Architecture Decision Records (ADR): 完全ガイド

Architecture Decision Recordsは、技術的な意思決定の「なぜ」を記録するものです。この完全ガイドでは、ADRのフォーマット、テンプレート、ベストプラクティス、ツール、そしてADRをチームのワークフローに統合する方法を解説し、意思決定の経緯が失われることを防ぎます。

2026年版C4モデルツールベスト5：完全比較

C4アーキテクチャ図を作成・維持するための適切なツールをお探しですか？2026年のC4モデルツールベスト5——Archyl、Structurizr、IcePanel、Visual C4、Draw.io——を機能、価格、実用性の観点から比較しました。

C4モデルとは？ソフトウェアチームのための完全ガイド

C4モデルはソフトウェアアーキテクチャを可視化するための最も実践的なフレームワークです。この完全ガイドでは4つのレベルすべて、各レベルの使い方、実例、そしてArchylのようなツールを使った現代的なチームのC4実践方法を解説します。

カスタムインサイトルール：あなたのアーキテクチャ、あなたの基準

すべての組織には固有のアーキテクチャ基準があります。汎用的なチェックでは一部の問題は検出できますが、チームにとって最も重要なものを見逃します。カスタマイズ可能なインサイトルールをリリースします——閾値を調整し、関連しないチェックを無効にし、コードベースで本当に重要なことをArchylに適用させましょう。