We scan this tool’s changelog a few times a day and keep the changes that would alter your agent’s next action: 18 since January 2026, each linked to its source.
cdkWhen deploying a stack that may replace, delete, or orphan resources, run `cdk deploy` with `--require-approval=destructive`. The CLI lists affected resources and requires manual confirmation before deploying them.
cdk deploy --require-approval=destructive <StackName>When reviewing a proposed stack update, run `cdk diff --fail-on=destructive <StackName>` to exit with code 1 if a change would replace, delete, or orphan an existing resource. In-place updates and new resources do not trigger failure.
cdk diff --fail-on=destructive <StackName>When deploying selected stacks, prefix each stack pattern to exclude with `!` and quote it so the shell preserves it. CDK removes stacks matched by exclusion patterns from the selected stacks.
cdk deploy '<include-pattern>' '!<exclude-pattern>'When iterating on a CDK app, run `cdk synth --watch` to synthesize initially and re-synthesize when watched files change. Configure the project’s `cdk.json` with a `watch` key first.
cdk synth --watchWhen no progress preference is configured and the CLI detects an AI agent, run `cdk deploy`; it uses `errors-only` automatically. For explicit errors-only output, run `cdk deploy --progress errors-only` and inspect the result or failures.
cdk deployWhen routine deployment progress is unhelpful, run `cdk deploy --progress errors-only` to suppress routine output and retain errors.
cdk deploy --progress errors-onlyWhen importing resources into a stack that needs event notifications, run `cdk import` with `--notification-arns <ARN...>` to add SNS topic ARNs to those in the stack's `notificationArns` property.
cdk import --notification-arns <SNS_TOPIC_ARN> [<SNS_TOPIC_ARN> ...]When you want continuous CDK app validation while editing, run `cdk validate --watch`.
cdk validate --watchWhen checking a CDK project's configuration online, run `cdk validate --online` with the `validate` unstable feature enabled.
cdk --unstable=validate validate --onlineWhen using toolkit-lib to deploy a stack, inspect `deleteFailures` on the successful stack result; it lists resources CloudFormation failed to delete during a stack update. [Source](https://github.com/aws/aws-cdk-cli/blob/aws-cdk%40v2.1126.0/packages/%40aws-cdk/toolkit-lib/lib/api/deployments/deployment-result.ts)
const result = await toolkit.deploy(...); // pass the deployment arguments required by your application
for (const stack of result.stackResults) {
if (stack.type === 'did-deploy-stack') {
for (const failure of stack.deleteFailures) {
// inspect failure
}
}
}