senior-architect

シニアアーキテクト

十分な情報に基づく技術的な意思決定を支援する、アーキテクチャの設計・分析ツールです。システム構造の可視化、依存関係と結合度の分析、アーキテクチャパターンの検出に加え、データベース、パターン、モノリスとマイクロサービスのトレードオフに関する意思決定ワークフローを実行できます。

主な機能

• 図の生成 — プロジェクトディレクトリから、Mermaid、PlantUML、ASCII 形式でコンポーネント図、レイヤー図、デプロイ図を生成します。
• 依存関係の分析 — npm、pip、Poetry、Go modules、Cargo 全体の依存関係ツリーをマッピングし、結合度をスコア化（0～100）して循環依存を検出します。
• パターンの検出 — 既存のコードベースを評価し、レイヤード、MVC、ヘキサゴナル、クリーン、マイクロサービスの各パターン、レイヤー違反、ゴッドクラス、関心事の混在を検出します。
• データベースの選定 — データの特性、規模、一貫性の要件に基づいて SQL／NoSQL の選択肢を照合し、ADR テンプレートを提示します。
• パターンとトポロジーの選定 — チームの規模、デプロイ方法、データ境界の要件に基づいてアーキテクチャパターンを選びます。
• モノリスとマイクロサービスの比較 — 意思決定チェックリストと、モジュラーモノリスを優先するハイブリッド戦略を適用します。

使用する場面

• 新しいシステムの設計、または既存のアーキテクチャのリファクタリング。
• マイクロサービスとモノリスの評価、またはデータベースの選定。
• ADR の作成、スケーラビリティの計画、またはシステム設計のレビュー。
• ドキュメント作成やチームレビューに向けたアーキテクチャ図の生成。

最初に確認すること

図や評価を生成する前に、次の入力内容を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• プロジェクトのルートディレクトリ — 分析対象のコードベースのディレクトリです（パターン検出、依存関係のスコアリング、図の内容に影響します）。
• 図の種類と形式 — Mermaid／PlantUML／ASCII 形式のコンポーネント図／レイヤー図／デプロイ図です（生成される図の種類を決定します）。
• 検討中のアーキテクチャ上の意思決定 — 例：データベースの選定、またはモノリスとマイクロサービスの比較（意思決定ワークフローと ADR を決定します）。

停止ルール：出力を最も大きく左右する2～3項目だけを質問してください。ユーザーが「とりあえず下書きを作成して」と言った場合は、作成を進め、成果物の冒頭に前提を列挙してください。

ツール

ツール	目的	コマンド
architecture_diagram_generator.py	プロジェクト構造からコンポーネント図、レイヤー図、デプロイ図を生成します	python scripts/architecture_diagram_generator.py ./project --format mermaid --type component
dependency_analyzer.py	パッケージマネージャー全体の結合度をスコア化し、循環依存を検出します	python scripts/dependency_analyzer.py ./project --output json --check circular
project_architect.py	アーキテクチャパターン、レイヤー違反、コードの問題点を検出します	python scripts/project_architect.py ./project --check layers --verbose

使用できるすべてのフラグを確認するには、各スクリプトに --help を付けて実行してください。

参考資料

タスクに合った参考資料を読み込みます。このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/architecture_patterns.md — 9 種類のアーキテクチャパターン（モノリス、モジュラーモノリス、マイクロサービス、イベント駆動型、CQRS、イベントソーシング、ヘキサゴナル、クリーン、API ゲートウェイ）と、トレードオフおよびコード例です。「どのパターン？」「マイクロサービスとモノリスの比較」「イベント駆動型」「CQRS」について尋ねられた場合に読みます。
• references/system_design_workflows.md — 6 つのステップごとのワークフローです。設計面接、キャパシティプランニング、API 設計、データベーススキーマ設計、スケーラビリティ評価、移行計画が含まれます。「設計方法」「キャパシティプランニング」「API 設計」「移行」について尋ねられた場合に読みます。
• references/tech_decision_guide.md — データベース、キャッシュ、メッセージキュー、認証、フロントエンドフレームワーク、クラウドプロバイダー、API スタイルの意思決定フレームワークと比較マトリクスです。「どのデータベース／フレームワーク／クラウド／キャッシュを選ぶべきか？」と尋ねられた場合に読みます。
• references/decision_workflows.md — データベース選定、アーキテクチャパターン選定、モノリスとマイクロサービスの比較に関する意思決定ワークフローと、マトリクス、チェックリスト、ADR テンプレートです。文書化されたアーキテクチャ上の意思決定を行う場合に読みます。
• references/tools-and-usage.md — 各ツールの詳細な使用方法、出力例、完全なフラグ一覧、一般的なコマンドのカタログ、技術スタックの対応状況、トラブルシューティング表、成功基準です。スクリプトの実行時や出力の解釈時に読みます。

対象範囲と制限事項

対象範囲： 既存のコードベースを対象としたシステムレベルのアーキテクチャ分析（パターン検出、レイヤー検証、コンポーネント図の作成）、npm、pip、Poetry、Go modules、Cargo にまたがるテクノロジーに依存しない依存関係分析、アーキテクチャの意思決定ワークフロー（データベース、パターン、モノリスとマイクロサービスの比較）、Mermaid、PlantUML、ASCII による図の生成です。

対象外：

• 実行時のパフォーマンスプロファイリングや負荷テスト — キャパシティプランニングには senior-devops、パフォーマンステストハーネスには senior-qa を使用してください。
• 依存関係のセキュリティ脆弱性スキャン — CVE／SAST／DAST には senior-security または senior-secops を使用してください。
• フロントエンドのコンポーネントアーキテクチャとデザインシステムの監査 — senior-frontend と design-auditor を使用してください。
• CI/CD パイプラインの設計とデプロイのオーケストレーション — senior-devops と release-orchestrator を使用してください。

統合ポイント

スキル	統合	データフロー
senior-backend	アーキテクチャパターンが、バックエンドのサービス境界と API コントラクトの設計に役立ちます	Architect の評価出力（検出されたパターン、レイヤーの割り当て）をバックエンドモジュールのスキャフォールディングに活用します
senior-devops	デプロイ図とテクノロジーの検出結果が、Infrastructure as Code の意思決定に役立ちます	デプロイ図の種類の出力と検出されたテクノロジーの一覧を DevOps が Terraform／K8s の設定に使用します
senior-security	依存関係分析によって、セキュリティレビューが必要なパッケージが明らかになります	依存関係一覧の JSON（--output json）をセキュリティスキャンに渡し、CVE と照合します
senior-fullstack	アーキテクチャパターンの選定によって、使用するフルスタックのスキャフォールドテンプレートが決まります	パターン選定ワークフローの結果（例：モジュラーモノリス）を project_scaffolder.py --type フラグに対応付けます
code-reviewer	レイヤー違反やゴッドクラスの検出結果を、レビュー用チェックリストの項目にします	project_architect.py --output json の issues 配列をコードレビューチェックリストに統合します
tech-stack-evaluator	テクノロジーの検出結果を、アップグレードや移行の意思決定に向けた技術スタック評価に活用します	検出されたテクノロジーの一覧と依存関係のバージョンを、スタック評価の意思決定マトリクスに反映します