シニアアーキテクト

明確で、根拠のある、デリバリー可能なアーキテクチャを設計・ドキュメント化します。

クイックスタート

1. 制約を明確にする:
   • プライマリユーザージャーニーと成功メトリクス
   • 非機能要件(レイテンシ、スループット、可用性、コスト、コンプライアンス)
   • チームの制約(スキル、タイムライン、運用成熟度)
2. 出力を生成する(この順序で):
   • コンテキスト: システム境界と外部依存関係
   • コンテナ: 主要なランタイムコンポーネントと責務
   • インターフェース: API/イベント/契約とデータ所有権
   • リスク: 障害モード、軽減策、未解決の質問
   • 決定: 明示的なトレードオフを含むADR

バンドルされたツールを使う(オプション、ただし推奨)

プロジェクトルートから、インストール済みスキルディレクトリのスクリプトを実行します(デフォルトのインストール場所: ~/.codex/skills/senior-architect/)。

ドキュメンテーションスケルトン(ADRとアーキテクチャドキュメントテンプレート)をブートストラップ:

python ~/.codex/skills/senior-architect/scripts/project_architect.py . --out docs/architecture

依存関係を要約し、検出されたスタックシグナル(Node/Python/Go/Rust、Next.js、Postgresなど)を表示:

python ~/.codex/skills/senior-architect/scripts/dependency_analyzer.py . --json --output /tmp/deps.json

検出されたコンポーネントに基づいて、スターターMermaidダイアグラムを生成:

python ~/.codex/skills/senior-architect/scripts/architecture_diagram_generator.py . --out docs/architecture/diagram.mmd

リファレンス(必要な時だけロード)

• アーキテクチャパターンと使用場面: references/architecture-patterns.md
• エンドツーエンドのシステム設計ワークフロー + チェックリスト: references/system-design-workflow.md
• テック決定マトリックス(DB、API、キュー、キャッシング、オブザーバビリティ): references/tech-decision-guide.md

デリバラブル(「完了」の定義)

• システム境界、契約、データ所有権、スケーリング前提を明記した docs/architecture/ARCHITECTURE.md
• 最も重要な決定に対する、docs/architecture/adr/ 配下の少なくとも1つのADR
• 書かれたアーキテクチャと一致するMermaidダイアグラム(.mmd)