// 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".
| name | deploy-cdk-stack |
| description | 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". |
Only execute when explicitly asked to "please deploy".
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
cd cdk
npm run deploy
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
cd cdk
npx cdk bootstrap
npx cdk deploy --require-approval never --all
// cdk/lib/parameter.ts
export const parameters = {
allowedIpV4AddressRanges: ["192.168.0.0/16"],
bedrockRegion: "ap-northeast-1",
documentProcessingModelId: "apac.anthropic.claude-sonnet-4-20250514-v1:0",
cognitoSelfSignUpEnabled: false,
autoMigrate: false,
};
npx cdk deploy -c rapid.bedrockRegion="ap-northeast-1"
npx cdk deploy -c rapid='{"bedrockRegion":"us-west-2","documentProcessingModelId":"us.anthropic.claude-sonnet-4-20250514-v1:0"}'
Precedence: Command line > parameter.ts > parameter-schema.ts defaults
| Scenario | Commands |
|---|---|
| Code only | cd backend && npm run build && cd ../cdk && npx cdk deploy |
| Infra only | cd cdk && npx cdk deploy |
| Schema change | Deploy + run migration command (see below) |
| Full stack | Build all + npx cdk deploy --require-approval never --all |
# 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
MIGRATION_COMMAND=$(aws cloudformation describe-stacks \
--stack-name RapidStack \
--query "Stacks[0].Outputs[?OutputKey=='DeployMigrationCommand'].OutputValue" \
--output text)
eval $MIGRATION_COMMAND
| Command | Description |
|---|---|
npx cdk synth | Validate and synthesize templates |
npx cdk diff | Show changes vs deployed stack |
npx cdk deploy --require-approval never | Deploy without prompts |
npx cdk deploy --all | Deploy all stacks |
npx cdk bootstrap | Bootstrap CDK (first-time only) |
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.
CREATE_COMPLETE or UPDATE_COMPLETEAdd new example use cases to the Examples feature, including file setup, metadata registration, thumbnail generation, and link verification. Use when a contributor provides PDF/PNG/TXT files for a new use case, when adding entries to the Examples page, or when verifying existing example GitHub URLs are accessible.
Run build verification and code formatting across all RAPID project components (backend, frontend, CDK). Use after implementing code changes, before committing, after modifying Prisma schema, or before creating a pull request.
Modify the review-item-processor agent's prompts, model configuration, confidence thresholds, JSON output schemas, and tool setup. Use when changing document or image review prompts, adjusting model IDs, modifying output format, updating citation settings, or adding new tools to the agent.
Modify CDK Step Functions workflows (ReviewProcessor and ChecklistProcessor) for the RAPID application, including workflow step changes, Map State concurrency, retry/timeout configuration, error handling, and parameter updates. Use when changing workflow step sequences, adjusting concurrency, modifying retry logic, or adding/removing workflow steps.
Create implementation plans for backend API endpoints and frontend features following RAPID layered architecture (domain/usecase/routes pattern, SWR hooks, feature-based organization). Use when adding or modifying backend APIs, frontend components, database schemas, or repository implementations. Also use for refactoring backend/frontend code.
Run repository integration tests against a local MySQL database for the RAPID backend. Use after implementing new repository methods, modifying Prisma database schema, testing use cases that depend on database access, or verifying data access patterns.