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

アーキテクチャインサイトはリリース以来、Archylで最も人気のある機能の一つです。アナライザーをアーキテクチャに向けると、潜在的な問題を特定します：単一障害点、循環依存、孤立した要素、不足しているドキュメント。チームからは、シニアアーキテクトがシステム設計を継続的にレビューしているようだと言われます。

しかし、同じフィードバックを繰り返し聞きました：「その警告は私たちには当てはまりません。」

段階的な移行中にマイクロサービスが意図的にデータベースを共有しているかもしれません。コンポーネントに多くの入力依存関係があるのは、共有ユーティリティライブラリだからかもしれません——カップリングの問題ではなく、良いコード再利用です。あるいは、チームはサービスへの8つの接続は問題ないと判断しているのに、デフォルトの閾値がフラグを立ててしまう。

汎用ルールはあなたのコンテキストを考慮できません。そこで制御をあなたに委ねます。

7つのルール、あなたの閾値

Archylではアーキテクチャを分析するインサイトルールをカスタマイズできるようになりました。アーキテクチャの健全性に重要な7つのパターンを特定し、チームの基準に合わせて各ルールを調整できます。

単一障害点検出器は、他の多くのコンポーネントが依存する要素を見つけます。デフォルトでは3つ以上の入力依存関係があるものをフラグ立てしますが、アーキテクチャが特定の関心事を意図的に集中させている場合、閾値を5、10、または適切な値に引き上げられます。

高カップリング分析は両方向を見ます：多くのものに依存する要素（出力）と、多くのものが依存する要素（入力）。デフォルト——出力6、入力4——はほとんどのコードベースに適していますが、共有ライブラリを構築するプラットフォームチームは、集中した機能を構築するプロダクトチームより高い閾値が必要かもしれません。

過度に接続された要素は異なる問題を検出します：総接続数が多すぎて推論が難しいコンポーネントです。

循環依存はほぼ常に問題です。このルールはバイナリです：オンかオフ。

孤立した要素は接続が一切ないアーキテクチャコンポーネントを見つけます。

セキュリティパターンは、外部システムによる直接データベースアクセスなど、懸念されるアーキテクチャの選択を検出します。

不足しているドキュメントはカバレッジの維持に役立ちます。

組織全体の一貫性

これらの設定はプロジェクトごとではなく、組織全体に適用されます。これは意図的な選択です。

アーキテクチャの基準は一貫しているべきです。プラットフォームチームが入力依存関係4つを高カップリングの閾値と決めたら、その基準はどこでも適用されるべきです。新しいプロジェクトは自動的に組織のルールを継承します。

はじめかた

カスタムインサイトルールはすべてのプランで利用可能です。インサイトに移動し、ルールタブをクリックして調整を始めてください。

デフォルトから始めて、表示される内容に基づいて調整することをお勧めします。特定のルールが常に無視する警告を生成する場合、基盤となるアーキテクチャを修正するか閾値を調整するシグナルです。どちらも有効な選択です——目標はインサイトをアクション可能にすることであり、任意のメトリクスを追いかけることではありません。

あなたのアーキテクチャには独自の特性、意図的なトレードオフ、「十分」の定義があります。ガバナンスがそれを反映できるようになりました。

AI駆動のインサイトの仕組みを知りたいですか？AI駆動のアーキテクチャ発見を読んで、Archylがコードベースを分析しアーキテクチャの推奨を生成する仕組みを理解してください。