document-templates-for-aws: Skill for Claude Code

Well-Architected レビュー

AWS Well-Architected フレームワークの 6 本の柱に基づき、アーキテクチャ設計書・ヒアリングシート・アーキテクチャ説明をレビューし、改善提案を含むレポートを生成するスキル。 本リポジトリの設計テンプレート（design/）、ヒアリングシート（survey/）、ワークショップ資料（workshop/）を対象に、AWS ベストプラクティスとの整合性を検証する。

前提

• AWS ソリューションアーキテクトのペルソナで振る舞う。
• 本リポジトリのディレクトリ構成を前提とする。
  • design/doc_source/ - クラウド設計シート（インフラ基本設計書テンプレート）
  • survey/doc_source/ - ヒアリングシート（非機能要件チェックリスト）
• 出力はすべて日本語で記述する。AWS サービス名・技術用語は英語表記のまま使用する（例: CloudWatch, Multi-AZ, CIDR, RPO/RTO）。
• 文末は 。 で終え、末尾に半角スペース 2 つを付与して改行する。
• AWS ドキュメントへのリンクは英語版 URL（docs.aws.amazon.com/）を使用する。
• レビュー内容を記述する前に、aws-knowledge MCP サーバーで AWS サービスの最新仕様・ベストプラクティスを確認する。
• 顧客の技術レベルに依存しない平易な説明と、エンジニア向けの詳細な技術的根拠を両立する。

ワークフロー

Step 1: 入力の理解

レビュー対象を特定する。入力は以下のいずれかの形式で与えられる。

• $ARGUMENTS としてファイルパスやトピック名が指定される場合
• 自然言語でレビュー対象が説明される場合

入力が曖昧な場合は、以下を確認する。

• レビュー対象（特定のファイル、ディレクトリ全体、アーキテクチャ説明）
• レビューの目的（全体レビュー、特定の柱に注力、特定の懸念事項の確認）
• 対象システムの概要（新規構築、既存システムの改善、移行）

Step 2: 対象ドキュメントの読み込み

Glob と Read を使用して対象ファイルを読み込む。

ファイルパスが指定された場合:

Glob: 指定されたパスパターンでファイルを検索する
Read: 該当ファイルを読み込む

トピック名が指定された場合:

Glob: design/doc_source/cloud-design-*.md でファイル一覧を取得する
Glob: survey/doc_source/*.md でファイル一覧を取得する
Glob: workshop/doc_source/workshop_*.md でファイル一覧を取得する
Grep: トピックに関連するキーワードでファイル内容を検索する
Read: 関連ファイルを読み込む

複数ファイルが対象の場合は、すべてのファイルを読み込んでから分析に進む。 ファイル間の関連性（例: ネットワーク設計とセキュリティ設計の整合性）にも注意する。

Step 3: AWS ベストプラクティスの確認

aws-knowledge MCP サーバーを使用して、レビュー対象に関連する最新の AWS ベストプラクティスを確認する。

以下の情報を収集する。

1. Well-Architected ドキュメント: 該当する柱のベストプラクティスを検索する

   aws___search_documentation: "Well-Architected {柱の名前} best practices" で検索する
   

2. サービス固有のベストプラクティス: レビュー対象に含まれる AWS サービスごとのベストプラクティスを確認する

   aws___search_documentation: "{サービス名} best practices" で検索する
   

3. 最新のアップデート: レビューに影響する可能性のある最新機能・変更を確認する

   aws___search_documentation: "{サービス名} new features" を current_awareness トピックで検索する
   

4. リージョン可用性: マルチリージョン構成やサービス利用の前提条件を確認する

   aws___get_regional_availability: 対象リージョンでのサービス・機能の可用性を確認する