senior-architect

シニアアーキテクト

使用するタイミング

具体的なユーザータスクについて、システムの境界、依存関係、デプロイ設計をレビューまたは計画します。技術を推奨する前に要件を収集します。これは手動の設計ワークフローです。付属する3つのPythonファイルは互換性を保つためのスタブであり、自動分析ツールではありません。

ワークフロー

1. 現在のリポジトリの指示と実際のサービスインターフェースを確認します。ユーザー、主要なフロー、データの所有者、測定済みの信頼性・レイテンシー・容量に関するニーズを記録します。不明な制約は不明のままにします。
2. 実際のエンドポイント、プロデューサー／コンシューマー、ストレージに基づいて現在のシステムを図示します。推測した接続にはラベルを付け、信頼境界を含めます。ファイル名だけから依存関係を作り上げてはいけません。
3. 現状またはシンプルな選択肢と、提案する変更を少なくとも比較します。コスト、運用負荷、障害ドメイン、データ整合性、テナント分離、移行／ロールバックの動作を説明します。
4. 採用した前提、却下した代替案、検証計画を記載した簡潔な決定記録を作成します。証拠を正確に反映している場合に限り図を提示します。アーキテクチャの形式を整えても、正しさが証明されるわけではありません。
5. 実装する前に、依頼された範囲を確認します。インフラストラクチャのプロビジョニング、デプロイ、データ移動、外部呼び出しには、該当するユーザーの許可が必要です。インストール前に依存関係を確認し、ドキュメントに認証情報を記載しないでください。

参考資料

• アーキテクチャパターン
• システム設計ワークフロー
• 技術選定ガイド

付属スクリプト

architecture_diagram_generator.py、dependency_analyzer.py、project_architect.py は、意図的に未完成のCLIを共有しています。コードの検査、図の生成、依存関係の検出、ベンチマーク、修正の推奨、プロジェクトの変更は行いません。検出事項がない状態で成功したと報告すると誤解を招くため、有効な呼び出しでは not_implemented を報告してexit2で終了します。無効なターゲット／パスではexit1で終了します。

ソースを読んだ後、意図されたワークスペースからスタブを明示的に実行する場合は、次のようにします。

python /path/to/this/skill/scripts/project_architect.py . --json

スキルのパスは実際のインストールによって指定され、プロジェクトのスクリプトディレクトリによって指定されるわけではありません。省略可能な --output は、現在のワークスペース内に新しいJSONファイルを作成し、既存のファイルがある場合は作成を拒否します。分析を完全なものにする機能ではありません。requirements.txt、.env.example、パッケージ設定、デプロイマニフェスト、自動修正は付属していません。このスキルを根拠に、汎用的なインストール／デプロイコマンドを実行しないでください。

例

チェックアウト処理が遅いタスクでは、実際のリクエスト経路とレイテンシーの内訳を調べます。クエリ／インデックスの修正と、キューの導入またはサービスの分割を比較します。根拠のある最小限の選択肢を選び、その障害時の動作を列挙し、データ量とコストの上限を定めた、観測可能な負荷テストを提案します。実行した証拠がない限り、測定結果や本番環境への対応準備が整っていることを主張しないでください。

制限事項

手動の設計ガイダンスは、実行可能なアーキテクチャ検証ツールでもセキュリティ認証でもありません。このドキュメントによって、インストール先のホストにデプロイ、メッセージング、認証情報、データ転送の権限が付与されることはありません。スタブの結果は、分析やベンチマークを示すものではありません。