How do I install the Deploy Cdk Stack skill?

Run npx skillmds@latest add aws-samples/deploy-cdk-stack in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Deploy Cdk Stack safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Deploy Cdk Stack?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Deploy Cdk Stack free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Deploy Cdk Stack?

aws-samples (@aws-samples) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Deploy Cdk Stack by aws-samples — Agent Skill

Name: Deploy Cdk Stack
Author: aws-samples

Deploy Cdk Stack

Deploy RAPID application AWS infrastructure using CDK, including stack deployment, database migrations, and post-deployment verification. Use when explicitly asked to deploy, when running CDK bootstrap for first-time setup, or when deploying after code or infrastructure changes. Only execute when user says "please deploy".

aws-samples 99bbbab 3.8 KB Updated Sep 17, 2026

File contents

Deploy CDK Stack

Only execute when explicitly asked to "please deploy".

Prerequisites

aws sts get-caller-identity    # AWS credentials configured
docker ps                      # Docker running
cd backend && npm ci && npm run prisma:generate && npm run build  # Backend built
cd ../cdk && npm ci            # CDK dependencies installed

Deployment Sequence

Quick Deploy (Recommended)

cd cdk
npm run deploy

Full Deployment (Manual Steps)

cd backend && npm ci && npm run prisma:generate && npm run build
cd ../cdk && npm ci
npx cdk synth                              # Validate (optional)
npx cdk deploy --require-approval never --all

First-Time Deployment

cd cdk
npx cdk bootstrap
npx cdk deploy --require-approval never --all

Parameter Customization

Edit parameter.ts

// cdk/lib/parameter.ts
export const parameters = {
  allowedIpV4AddressRanges: ["192.168.0.0/16"],
  bedrockRegion: "ap-northeast-1",
  documentProcessingModelId: "jp.anthropic.claude-sonnet-4-6",
  cognitoSelfSignUpEnabled: false,
  autoMigrate: false,
};

Command Line Parameters

npx cdk deploy -c rapid.bedrockRegion="ap-northeast-1"
npx cdk deploy -c rapid='{"bedrockRegion":"us-west-2","documentProcessingModelId":"us.anthropic.claude-sonnet-4-6"}'

Precedence: Command line > parameter.ts > parameter-schema.ts defaults

Deployment Scenarios

Scenario	Commands
Code only	`cd backend && npm run build && cd ../cdk && npx cdk deploy --all`
Infra only	`cd cdk && npx cdk deploy --all`
Schema change	Deploy + run migration command (see below)
Full stack	Build all + `npx cdk deploy --require-approval never --all`

The default (CloudFront) mode synthesizes two stacks (RapidStack + the us-east-1 RapidFrontendWafStack), so a bare npx cdk deploy is rejected by the CDK CLI ("specify which stacks to use"). Always pass --all (dependency order is resolved by the CLI).

Post-Deployment

# Get URLs
aws cloudformation describe-stacks --stack-name RapidStack \
  --query "Stacks[0].Outputs[?OutputKey=='FrontendURL'].OutputValue" --output text

aws cloudformation describe-stacks --stack-name RapidStack \
  --query "Stacks[0].Outputs[?OutputKey=='ApiEndpoint'].OutputValue" --output text

Database Migration

Manual Migration

MIGRATION_COMMAND=$(aws cloudformation describe-stacks \
  --stack-name RapidStack \
  --query "Stacks[0].Outputs[?OutputKey=='DeployMigrationCommand'].OutputValue" \
  --output text)
eval $MIGRATION_COMMAND

CDK Commands

Command	Description
`npx cdk synth`	Validate and synthesize templates
`npx cdk diff`	Show changes vs deployed stack
`npx cdk deploy --require-approval never --all`	Deploy without prompts
`npx cdk deploy --all`	Deploy all stacks
`npx cdk bootstrap`	Bootstrap CDK (first-time only)

Production Warnings

NEVER in production: Database reset, cdk destroy, prisma db push, autoMigrate: true

ALWAYS in production: Test in staging first, review changeset, backup DB before migrations, monitor CloudWatch logs.

Success Criteria

CloudFormation stack shows CREATE_COMPLETE or UPDATE_COMPLETE
API health endpoint responds with 200 OK
CloudFront URL loads application
CloudWatch logs show no critical errors
Database migration completed (if applicable)

---name: deploy-cdk-stackdescription: Deploy RAPID application AWS infrastructure using CDK, including stack deployment, database migrations, and post-deployment verification. Use when explicitly asked to deploy, when running CDK bootstrap for first-time setup, or when deploying after code or infrastructure changes. Only execute when user says "please deploy".---# Deploy CDK Stack**Only execute when explicitly asked to "please deploy".**## Prerequisites```bashaws sts get-caller-identity # AWS credentials configureddocker ps # Docker runningcd backend && npm ci && npm run prisma:generate && npm run build # Backend builtcd ../cdk && npm ci # CDK dependencies installed```## Deployment Sequence### Quick Deploy (Recommended)```bashcd cdknpm run deploy```### Full Deployment (Manual Steps)```bashcd backend && npm ci && npm run prisma:generate && npm run buildcd ../cdk && npm cinpx cdk synth # Validate (optional)npx cdk deploy --require-approval never --all```### First-Time Deployment```bashcd cdknpx cdk bootstrapnpx cdk deploy --require-approval never --all```## Parameter Customization### Edit parameter.ts```typescript// cdk/lib/parameter.tsexport const parameters = { allowedIpV4AddressRanges: ["192.168.0.0/16"], bedrockRegion: "ap-northeast-1", documentProcessingModelId: "jp.anthropic.claude-sonnet-4-6", cognitoSelfSignUpEnabled: false, autoMigrate: false,};```### Command Line Parameters```bashnpx cdk deploy -c rapid.bedrockRegion="ap-northeast-1"npx cdk deploy -c rapid='{"bedrockRegion":"us-west-2","documentProcessingModelId":"us.anthropic.claude-sonnet-4-6"}'```Precedence: Command line > parameter.ts > parameter-schema.ts defaults## Deployment Scenarios| Scenario | Commands ||----------|----------|| Code only | `cd backend && npm run build && cd ../cdk && npx cdk deploy --all` || Infra only | `cd cdk && npx cdk deploy --all` || Schema change | Deploy + run migration command (see below) || Full stack | Build all + `npx cdk deploy --require-approval never --all` |> The default (CloudFront) mode synthesizes **two** stacks (`RapidStack` + the> us-east-1 `RapidFrontendWafStack`), so a bare `npx cdk deploy` is rejected by> the CDK CLI ("specify which stacks to use"). Always pass `--all` (dependency> order is resolved by the CLI).## Post-Deployment```bash# Get URLsaws cloudformation describe-stacks --stack-name RapidStack \ --query "Stacks[0].Outputs[?OutputKey=='FrontendURL'].OutputValue" --output textaws cloudformation describe-stacks --stack-name RapidStack \ --query "Stacks[0].Outputs[?OutputKey=='ApiEndpoint'].OutputValue" --output text```## Database Migration### Manual Migration```bashMIGRATION_COMMAND=$(aws cloudformation describe-stacks \ --stack-name RapidStack \ --query "Stacks[0].Outputs[?OutputKey=='DeployMigrationCommand'].OutputValue" \ --output text)eval $MIGRATION_COMMAND```## CDK Commands| Command | Description ||---------|-------------|| `npx cdk synth` | Validate and synthesize templates || `npx cdk diff` | Show changes vs deployed stack || `npx cdk deploy --require-approval never --all` | Deploy without prompts || `npx cdk deploy --all` | Deploy all stacks || `npx cdk bootstrap` | Bootstrap CDK (first-time only) |## Production Warnings**NEVER in production**: Database reset, `cdk destroy`, `prisma db push`, `autoMigrate: true`**ALWAYS in production**: Test in staging first, review changeset, backup DB before migrations, monitor CloudWatch logs.## Success Criteria- CloudFormation stack shows `CREATE_COMPLETE` or `UPDATE_COMPLETE`- API health endpoint responds with 200 OK- CloudFront URL loads application- CloudWatch logs show no critical errors- Database migration completed (if applicable)

Frequently asked questions