senior-architect

senior-architect skill の概要

senior-architect の用途

senior-architect は、曖昧なシステム設計の相談を、構造化されたアーキテクチャ判断、図解、依存関係レビュー、実装上のトレードオフへ落とし込むための Software Architecture skill です。一般的なブレインストーミング回答ではなく、アーキテクチャ計画、ADR 形式の判断整理、技術スタック比較、スケーラビリティレビュー、コードベース単位のアーキテクチャ評価が必要なユーザーに向いています。

向いているユーザーと用途

senior-architect skill は、モノリス、モジュラーモノリス、マイクロサービス、イベント駆動、CQRS、ヘキサゴナルアーキテクチャ、クリーンアーキテクチャといったパターンのどれを採用するか検討しているときに使うと効果的です。既存リポジトリをレビューするチームにも有用です。同梱の Python スクリプトでプロジェクト構造をスキャンし、アーキテクチャレイヤーの推定、結合度の検出、Mermaid、PlantUML、ASCII 図の生成ができます。

何が違うのか

この skill は、プロンプトの指針と具体的なリポジトリ分析ツールを組み合わせています。参照資料にはアーキテクチャパターン、システム設計の進め方、技術選定マトリクスが含まれ、スクリプトではプロジェクト図の生成、依存関係分析、アーキテクチャ評価を実行できます。コードベースから根拠を得たい場合、単なる「シニアアーキテクトとして振る舞って」というプロンプトより実務的です。

導入前に知っておきたい制約

スクリプトはヒューリスティックなスキャナーであり、正式なアーキテクチャ検証ツールではありません。一般的なプロジェクト構造や、Node、Python、Go、Rust、Java、Docker、Kubernetes などのよく使われるエコシステムで特に力を発揮します。高度にカスタマイズされたモノレポでは、生成された結果を最終判断ではなく、レビューの出発点として扱うべきです。

senior-architect skill の使い方

senior-architect のインストールと最初に読むファイル

GitHub skill directory から次のコマンドでインストールします。

npx skills add alirezarezvani/claude-skills --skill senior-architect

インストール後は、まず SKILL.md を読み、トリガー範囲とコマンド例を確認します。続いて以下を確認してください。

• references/architecture_patterns.md：パターンごとのトレードオフと「使うべきでない場合」の指針
• references/system_design_workflows.md：キャパシティプランニング、API 設計、移行、スケーラビリティのワークフロー
• references/tech_decision_guide.md：データベース、キャッシュ、キュー、認証、フロントエンド、クラウド、API スタイルの選択
• scripts/architecture_diagram_generator.py
• scripts/dependency_analyzer.py
• scripts/project_architect.py

この順番で読むことで、出力に依存する前に、判断フレームワークと実行可能な分析ツールの両方を把握できます。

より良いアーキテクチャ出力につながる入力

senior-architect skill は、ビジネス背景と技術制約の両方を与えたときに最も有効です。弱いプロンプトは「スケーラブルなバックエンドを設計して」です。より良いプロンプトは次のようになります。

Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.

有用な入力には、想定ユーザー数、リクエスト量、読み書き比率、レイテンシ目標、可用性目標、データ保持期間、コンプライアンス要件、チーム規模、デプロイ環境、現在の技術スタック、移行制約、すでに却下した選択肢などがあります。

実務での senior-architect 活用フロー

新規システムでは、まず参照ワークフローから始めます。機能要件を明確にし、規模を見積もり、非機能要件を洗い出したうえで、トレードオフ付きの候補アーキテクチャを依頼します。既存コードベースの場合は、提案を求める前にスクリプトを実行します。

python scripts/architecture_diagram_generator.py ./my-project --format mermaid

python scripts/dependency_analyzer.py ./my-project --output json

python scripts/project_architect.py ./my-project --verbose

検出されたパターン、結合度スコア、循環依存、欠けているレイヤー、パッケージマネージャー、推奨事項など、特に重要な結果をプロンプトに貼り付けます。これにより、曖昧な説明からアーキテクチャを推測させるのではなく、モデルに根拠のある材料を与えられます。

判断とレビューに使えるプロンプトの型

設計判断では、明示的な判断フォーマットを指定します。文脈、選択肢、判断基準、推奨案、却下した代替案、リスク、移行計画、未解決の論点を含めるよう依頼します。レビューでは、「観察された事実」「解釈」「推奨される変更」を分けるよう求めます。これにより、自信過剰なアーキテクチャ助言を減らし、ADR、ロードマップ項目、エンジニアリング提案へ変換しやすくなります。

senior-architect skill FAQ

senior-architect は大規模システム専用ですか？

いいえ。小規模チームがシンプルなアーキテクチャを選び、時期尚早なマイクロサービス化を避けるためにも役立ちます。同梱のアーキテクチャパターン参照では、モノリスとモジュラーモノリスのトレードオフも明示的に扱っているため、「もっとシンプルに保つ」が最適解になる場面でも有用です。

通常のアーキテクチャ相談プロンプトより何が優れていますか？

通常のプロンプトは、主にユーザーが思い出して書いた情報に依存します。senior-architect skill は、再利用可能な判断ワークフロー、パターン参照、技術比較マトリクス、コードベーススキャン用スクリプトを追加します。この組み合わせは、単発の助言ではなく、再現性のあるアーキテクチャレビューが必要なときに特に価値があります。

初心者でも senior-architect skill を使えますか？

はい。ただし初心者は、これを絶対的な判断者ではなく、意思決定をガイドする補助として使うべきです。トレードオフの説明、用語の定義、前提条件の明示を依頼してください。規模、可用性目標、運用上の制約が分からない場合は、設計を推奨させる前に、不足している確認事項を列挙してもらうとよいでしょう。

使わないほうがよい場面は？

セキュリティクリティカル、コンプライアンス要件が重い、本番移行に関わる判断では、唯一の情報源として使うべきではありません。また、プロファイリング、負荷テスト、クラウドコストのモデリング、特殊なドメインに対する専門家レビューの代替にもなりません。低レベルの実装バグには、言語特化のデバッグ skill のほうが適している場合があります。

senior-architect skill を改善する方法

測定可能な制約で senior-architect への入力を改善する

最もよくある失敗は、もっともらしく聞こえるものの実行に移せないアーキテクチャ助言です。結果を改善するには、ユーザー数、秒間リクエスト数、ストレージ増加量、ピーク時倍率、レイテンシ予算、稼働率目標、チーム規模、リリース頻度、コスト上限といった数値を追加します。「高スケール」「エンタープライズ級」のような形容詞より、概算でも数値のほうが役に立ちます。

変更を求める前にリポジトリの根拠を使う

既存プロジェクトでは、スクリプトの出力と簡単なファイルツリー要約を含めます。コードが controllers/services/repositories、domain/application/infrastructure フォルダ、Docker、Kubernetes、メッセージキュー、複数のデプロイ可能サービスを使っているかどうかも書いてください。これにより、senior-architect は意図されたアーキテクチャと、たまたまそう見えるフォルダ名を区別しやすくなります。

大まかな設計から具体的な成果物へ反復する

最初のアーキテクチャ提案で止めないでください。ADR、Mermaid 図、移行手順、リスク登録簿、データベース選定、API 境界、サービス所有モデルについて追加で依頼します。よい進め方は、ハイレベル設計 → トレードオフ比較 → 採用アーキテクチャ → 図解 → ADR → 段階的な実装計画、という流れです。

過剰設計と不足している前提に注意する

出力がマイクロサービス、イベントソーシング、CQRS、分散メッセージングを推奨する場合は、その追加の運用複雑性がなぜ正当化されるのかを確認してください。前提が不足している場合は、不明点を明記し、よりシンプルなデフォルト案を提示するよう再依頼します。senior-architect を最も効果的に使うには、理論上のスケーラビリティだけでなく、チームの実行能力に設計を合わせることが重要です。