Agent Plugins for AWS 完全ガイド｜Claude Code でアーキテクチャ設計・コスト見積もり・IaC生成・デプロイを一気通貫で実行する

# リポジトリをクローン
git clone https://github.com/awslabs/agent-plugins.git /tmp/agent-plugins

# プロジェクトの .claude/commands/ ディレクトリを作成
mkdir -p .claude/commands

# deploy-on-aws のスキルファイルをコピー
cp /tmp/agent-plugins/plugins/deploy-on-aws/.claude/commands/*.md .claude/commands/

# aws-serverless も使う場合
cp /tmp/agent-plugins/plugins/aws-serverless/.claude/commands/*.md .claude/commands/

# 依存 MCP サーバーをセットアップ
cd /tmp/agent-plugins/plugins/deploy-on-aws && npm install

git clone https://github.com/awslabs/agent-plugins.git
cd agent-plugins

# deploy-on-aws の場合
cd plugins/deploy-on-aws
npm install

# .claude/commands/ にスキルファイルをコピー
cp -r skills/* /your-project/.claude/commands/

Deploy this Express app to AWS

# または同義のフレーズ
host on AWS
deploy to production on AWS
AWS architecture for this app

# アーキテクチャ提案

## バックエンド API
- サービス: AWS App Runner
- 理由: コンテナベースで自動スケーリング。ECS より設定が簡潔。

## データベース
- サービス: Amazon RDS PostgreSQL（db.t3.micro）
- 理由: 既存スキーマと完全互換。Multi-AZ は本番推奨。

## シークレット管理
- サービス: AWS Secrets Manager
- 理由: DB パスワードと API キーを安全に管理。

## 代替案
- ECS Fargate: より細かい制御が必要な場合
- Aurora Serverless v2: アクセスが不均一な場合にコスト最適化可能

続けますか？ (Y で見積もりへ)

# 月額コスト見積もり（東京リージョン / 2026年3月時点）

| サービス            | 構成                    | 月額    |
|---------------------|-------------------------|---------|
| App Runner          | 0.5 vCPU / 1GB / 2インスタンス | $35.00  |
| RDS PostgreSQL      | db.t3.micro / 20GB gp3  | $18.50  |
| Secrets Manager     | 2シークレット            | $0.80   |
| データ転送          | 10GB/月 想定             | $0.90   |
| **合計**            |                         | **$55.20** |

※ 実際のコストはトラフィックにより変動します。

続けますか？ (Y で IaC 生成へ)

# ===== ビルドステージ =====
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

# ===== 実行ステージ =====
FROM node:20-alpine AS runner
WORKDIR /app

# セキュリティ：非rootユーザーで実行
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 appuser

COPY --from=builder /app/node_modules ./node_modules
COPY --chown=appuser:nodejs . .

USER appuser
EXPOSE 3000

# ヘルスチェック（App Runner が使用）
HEALTHCHECK --interval=30s --timeout=3s \
  CMD wget -qO- http://localhost:3000/health || exit 1

CMD ["node", "src/index.js"]

import * as cdk from "aws-cdk-lib";
import * as apprunner from "@aws-cdk/aws-apprunner-alpha";
import * as rds from "aws-cdk-lib/aws-rds";
import * as ec2 from "aws-cdk-lib/aws-ec2";
import * as secretsmanager from "aws-cdk-lib/aws-secretsmanager";
import { Construct } from "constructs";

export class AppStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // VPC（App Runner から RDS へのプライベートアクセス用）
    const vpc = new ec2.Vpc(this, "AppVpc", {
      maxAzs: 2,
      natGateways: 1,
    });

    // DB パスワードを Secrets Manager で管理
    const dbSecret = new secretsmanager.Secret(this, "DbSecret", {
      generateSecretString: {
        secretStringTemplate: JSON.stringify({ username: "appuser" }),
        generateStringKey: "password",
        excludeCharacters: "/@"",
      },
    });

    // RDS PostgreSQL インスタンス
    const database = new rds.DatabaseInstance(this, "Database", {
      engine: rds.DatabaseInstanceEngine.postgres({
        version: rds.PostgresEngineVersion.VER_16,
      }),
      instanceType: ec2.InstanceType.of(
        ec2.InstanceClass.T3, ec2.InstanceSize.MICRO
      ),
      vpc,
      credentials: rds.Credentials.fromSecret(dbSecret),
      databaseName: "appdb",
      deletionProtection: false,   // 本番では true に変更
    });

    // App Runner サービス
    const service = new apprunner.Service(this, "AppService", {
      source: apprunner.Source.fromEcr({
        imageConfiguration: {
          port: 3000,
          environmentSecrets: {
            DB_PASSWORD: apprunner.Secret.fromSecretsManager(dbSecret, "password"),
          },
          environmentVariables: {
            DB_HOST: database.dbInstanceEndpointAddress,
            DB_NAME: "appdb",
            DB_USER: "appuser",
            NODE_ENV: "production",
          },
        },
        repository: /* ECR リポジトリを指定 */ undefined as any,
        tag: "latest",
      }),
      cpu: apprunner.Cpu.HALF,
      memory: apprunner.Memory.ONE_GB,
    });

    // 出力
    new cdk.CfnOutput(this, "ServiceUrl", { value: service.serviceUrl });
    new cdk.CfnOutput(this, "DbEndpoint", {
      value: database.dbInstanceEndpointAddress,
    });
  }
}

name: Deploy to AWS

on:
  push:
    branches: [main]
  workflow_dispatch:

env:
  AWS_REGION: ap-northeast-1
  ECR_REPOSITORY: my-app
  APP_RUNNER_SERVICE: my-app-service

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"
      - run: npm ci
      - run: npm test

  build-and-deploy:
    needs: test
    runs-on: ubuntu-latest
    permissions:
      id-token: write   # OIDC 認証に必要
      contents: read

    steps:
      - uses: actions/checkout@v4

      # OIDC で AWS 認証（アクセスキー不要）
      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
          aws-region: ${{ env.AWS_REGION }}

      - name: Login to Amazon ECR
        id: login-ecr
        uses: aws-actions/amazon-ecr-login@v2

      - name: Build and push Docker image
        env:
          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
          IMAGE_TAG: ${{ github.sha }}
        run: |
          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG

      - name: Deploy CDK stack
        run: |
          npm install -g aws-cdk
          cd infra && npm ci
          cdk deploy --require-approval never

# コスト見積もりだけ行う
estimate AWS cost for this app

# IaC コード生成だけ行う（デプロイはしない）
generate AWS infrastructure code

# アーキテクチャ提案だけ行う
AWS architecture recommendation for this app

# 本番向け構成で提案（Multi-AZ・冗長構成）
deploy this app to AWS production-ready

# Lambda + API Gateway 構成を作成
Create a REST API with Lambda and API Gateway

# イベント駆動アーキテクチャ
Create a Lambda function triggered by S3 events

# Step Functions ワークフロー
Create a Step Functions workflow for order processing

# SAM テンプレートを生成
Generate SAM template for this serverless application

import { APIGatewayProxyEvent, APIGatewayProxyResult } from "aws-lambda";
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { DynamoDBDocumentClient, GetCommand } from "@aws-sdk/lib-dynamodb";

const client = new DynamoDBClient({});
const docClient = DynamoDBDocumentClient.from(client);

export const handler = async (
  event: APIGatewayProxyEvent
): Promise<APIGatewayProxyResult> => {
  const id = event.pathParameters?.id;
  if (!id) {
    return { statusCode: 400, body: JSON.stringify({ error: "Missing id" }) };
  }

  const result = await docClient.send(
    new GetCommand({ TableName: process.env.TABLE_NAME!, Key: { id } })
  );

  if (!result.Item) {
    return { statusCode: 404, body: JSON.stringify({ error: "Not found" }) };
  }

  return {
    statusCode: 200,
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(result.Item),
  };
};

# Amplify フルスタックアプリをセットアップ
Set up a full-stack app with Amplify Gen 2

# 認証機能を追加
Add Cognito authentication with email and Google OAuth

# GraphQL API を設計
Create a GraphQL API for a blog with posts and comments

# リアルタイム機能を追加
Add real-time updates with AppSync subscriptions

# GCP から AWS への移行計画を立てる
Analyze this GCP project and create an AWS migration plan

# コスト比較
Compare costs between current GCP setup and equivalent AWS services

# 特定サービスの移行
Migrate this Cloud Run service to AWS App Runner

Version: "2012-10-17"
Statement:
  - Effect: Allow
    Action:
      - apprunner:*
      - rds:CreateDBInstance
      - rds:DescribeDBInstances
      - secretsmanager:CreateSecret
      - secretsmanager:PutSecretValue
      - iam:CreateRole
      - iam:AttachRolePolicy
      - iam:PassRole
    Resource: "*"
    Condition:
      StringEquals:
        aws:RequestedRegion: "ap-northeast-1"  # 東京リージョンに限定

# 現在のバージョン確認
/plugin list

# アップデート
/plugin update deploy-on-aws
/plugin update aws-serverless

# または GitHub から直接クローンしてセットアップしている場合
cd agent-plugins && git pull