fix: replace dead CDK test and update stale READMEs

Author: notgitika

src/assets/__tests__/__snapshots__/assets.snapshot.test.ts.snap

@@ -13,20 +13,32 @@ exports[`Assets Directory Snapshots > CDK assets > cdk/cdk/.prettierrc should ma
 `;
 
 exports[`Assets Directory Snapshots > CDK assets > cdk/cdk/README.md should match snapshot 1`] = `
-"# Welcome to your CDK TypeScript project
+"# AgentCore CDK Project
 
-This is a blank project for CDK development with TypeScript.
+This CDK project is managed by the AgentCore CLI. It deploys your agent infrastructure into AWS using the \`@aws/agentcore-cdk\` L3 constructs.
 
-The \`cdk.json\` file tells the CDK Toolkit how to execute your app.
+## Structure
+
+- \`bin/cdk.ts\` — Entry point. Reads project configuration from \`agentcore/\` and creates a stack per deployment target.
+- \`lib/cdk-stack.ts\` — Defines \`AgentCoreStack\`, which wraps the \`AgentCoreApplication\` L3 construct.
+- \`test/cdk.test.ts\` — Unit tests for stack synthesis.
 
 ## Useful commands
 
-- \`npm run build\` compile typescript to js
-- \`npm run watch\` watch for changes and compile
-- \`npm run test\` perform the jest unit tests
+- \`npm run build\` compile TypeScript to JavaScript
+- \`npm run test\` run unit tests
+- \`npx cdk synth\` emit the synthesized CloudFormation template
 - \`npx cdk deploy\` deploy this stack to your default AWS account/region
 - \`npx cdk diff\` compare deployed stack with current state
-- \`npx cdk synth\` emits the synthesized CloudFormation template
+
+## Usage
+
+You typically don't need to interact with this directory directly. The AgentCore CLI handles synthesis and deployment:
+
+\`\`\`bash
+agentcore deploy    # synthesizes and deploys via CDK
+agentcore status    # checks deployment status
+\`\`\`
 "
 `;
 
@@ -289,21 +301,25 @@ exports[`Assets Directory Snapshots > CDK assets > cdk/cdk/package.json should m
 `;
 
 exports[`Assets Directory Snapshots > CDK assets > cdk/cdk/test/cdk.test.ts should match snapshot 1`] = `
-"// import * as cdk from 'aws-cdk-lib/core';
-// import { Template } from 'aws-cdk-lib/assertions';
-// import * as Cdk from '../lib/cdk-stack';
-
-// example test. To run these tests, uncomment this file along with the
-// example resource in lib/cdk-stack.ts
-test('SQS Queue Created', () => {
-  //   const app = new cdk.App();
-  //     // WHEN
-  //   const stack = new Cdk.CdkStack(app, 'MyTestStack');
-  //     // THEN
-  //   const template = Template.fromStack(stack);
-  //   template.hasResourceProperties('AWS::SQS::Queue', {
-  //     VisibilityTimeout: 300
-  //   });
+"import * as cdk from 'aws-cdk-lib';
+import { Template } from 'aws-cdk-lib/assertions';
+import { AgentCoreStack } from '../lib/cdk-stack';
+
+test('AgentCoreStack synthesizes with empty spec', () => {
+  const app = new cdk.App();
+  const stack = new AgentCoreStack(app, 'TestStack', {
+    spec: {
+      name: 'testproject',
+      version: 1,
+      agents: [],
+      memories: [],
+      credentials: [],
+    },
+  });
+  const template = Template.fromStack(stack);
+  template.hasOutput('StackNameOutput', {
+    Description: 'Name of the CloudFormation Stack',
+  });
 });
 "
 `;
@@ -2342,7 +2358,7 @@ packages = ["."]
 `;
 
 exports[`Assets Directory Snapshots > Python framework assets > python/python/strands/base/README.md should match snapshot 1`] = `
-"This is a project generated by the agentcore create basic CLI tool!
+"This is a project generated by the agentcore create CLI tool!
 
 # Layout
 

src/assets/cdk/README.md

@@ -1,14 +1,26 @@
-# Welcome to your CDK TypeScript project
+# AgentCore CDK Project
 
-This is a blank project for CDK development with TypeScript.
+This CDK project is managed by the AgentCore CLI. It deploys your agent infrastructure into AWS using the `@aws/agentcore-cdk` L3 constructs.
 
-The `cdk.json` file tells the CDK Toolkit how to execute your app.
+## Structure
+
+- `bin/cdk.ts` — Entry point. Reads project configuration from `agentcore/` and creates a stack per deployment target.
+- `lib/cdk-stack.ts` — Defines `AgentCoreStack`, which wraps the `AgentCoreApplication` L3 construct.
+- `test/cdk.test.ts` — Unit tests for stack synthesis.
 
 ## Useful commands
 
-- `npm run build` compile typescript to js
-- `npm run watch` watch for changes and compile
-- `npm run test` perform the jest unit tests
+- `npm run build` compile TypeScript to JavaScript
+- `npm run test` run unit tests
+- `npx cdk synth` emit the synthesized CloudFormation template
 - `npx cdk deploy` deploy this stack to your default AWS account/region
 - `npx cdk diff` compare deployed stack with current state
-- `npx cdk synth` emits the synthesized CloudFormation template
+
+## Usage
+
+You typically don't need to interact with this directory directly. The AgentCore CLI handles synthesis and deployment:
+
+```bash
+agentcore deploy    # synthesizes and deploys via CDK
+agentcore status    # checks deployment status
+```

src/assets/cdk/test/cdk.test.ts

@@ -1,16 +1,20 @@
-// import * as cdk from 'aws-cdk-lib/core';
-// import { Template } from 'aws-cdk-lib/assertions';
-// import * as Cdk from '../lib/cdk-stack';
+import * as cdk from 'aws-cdk-lib';
+import { Template } from 'aws-cdk-lib/assertions';
+import { AgentCoreStack } from '../lib/cdk-stack';
 
-// example test. To run these tests, uncomment this file along with the
-// example resource in lib/cdk-stack.ts
-test('SQS Queue Created', () => {
-  //   const app = new cdk.App();
-  //     // WHEN
-  //   const stack = new Cdk.CdkStack(app, 'MyTestStack');
-  //     // THEN
-  //   const template = Template.fromStack(stack);
-  //   template.hasResourceProperties('AWS::SQS::Queue', {
-  //     VisibilityTimeout: 300
-  //   });
+test('AgentCoreStack synthesizes with empty spec', () => {
+  const app = new cdk.App();
+  const stack = new AgentCoreStack(app, 'TestStack', {
+    spec: {
+      name: 'testproject',
+      version: 1,
+      agents: [],
+      memories: [],
+      credentials: [],
+    },
+  });
+  const template = Template.fromStack(stack);
+  template.hasOutput('StackNameOutput', {
+    Description: 'Name of the CloudFormation Stack',
+  });
 });

src/assets/python/strands/base/README.md

@@ -1,4 +1,4 @@
-This is a project generated by the agentcore create basic CLI tool!
+This is a project generated by the agentcore create CLI tool!
 
 # Layout