@aws/nx-plugin-mcp 1.0.0-rc.98 → 1.0.0

package/docs/get_started/building-with-ai.mdx

@@ -6,14 +6,23 @@ description: Building with AI and the Nx Plugin for AWS MCP Server
 import Link from "@components/link.astro";
 import Snippet from "@components/snippet.astro";
 import { Steps, Tabs, TabItem } from "@astrojs/starlight/components";
+import Prompt from "@components/prompt.astro";
 
-Install the [Claude Plugin](https://code.claude.com/docs/en/plugins), [Kiro Power](https://kiro.dev/docs/powers/), or [MCP Server](https://modelcontextprotocol.io/introduction) to enable AI assistants to work effectively with the plugin. By using these, you can accelerate your development workflow with AI while benefitting from your projects being scaffolded in a consistent fashion, spending less time on setting up the main components and benefitting from the security, observability, type-safety and local development built into the plugin.
+## Already configured in your workspace
 
-## Configure your AI Assistant
+Workspaces created with the Nx Plugin for AWS preset include project-level MCP configuration for common coding agents — Claude Code, Cursor, Kiro, Gemini CLI, GitHub Copilot and OpenAI Codex — so an agent working inside the workspace can use the plugin's [MCP server](https://modelcontextprotocol.io/introduction) with no further setup.
 
-:::tip[Project-level configuration is automatic]
-Workspaces created with the Nx Plugin for AWS preset already include project-level MCP configuration for common coding agents (Claude Code, Cursor, Kiro, Gemini CLI, GitHub Copilot and OpenAI Codex). Any agent working inside the workspace can use the MCP server without further setup. The steps below configure the MCP server globally for use across all of your projects.
-:::
+Open your workspace in your assistant and ask it for what you want:
+
+<Prompt>
+Add a React website with an AG-UI agent, an MCP server for its tools and a DynamoDB table, and wire them together.
+</Prompt>
+
+It looks up the generators the plugin offers, runs them in the order their dependencies need. Use your agent to fill in the business logic from there.
+
+## Install globally
+
+The workspace configuration above is enough to build with. You can install globally if you'd like to use AI to create new workspaces, or <Link path="get_started/existing-project">add the Nx Plugin for AWS to an existing project</Link>:
 
 <Tabs syncKey="ai-assistant">
   <TabItem label="Kiro">
@@ -101,16 +110,14 @@ Workspaces created with the Nx Plugin for AWS preset already include project-lev
 
 ## Start Vibe Coding
 
-Ask your AI Assistant to build something using the `nx-plugin-for-aws`! It will typically create a workspace, scaffold with the applicable generators, then fill in the business logic.
+With the plugin available globally, your assistant can create the workspace too. Try a prompt like:
 
-Try a prompt like:
-
-> _"Build a multi-agent application using the Nx Plugin for AWS. I want a React frontend that talks to a backend orchestrator agent which delegates to specialised research and writing agents."_
+<Prompt>
+Build a multi-agent application using the Nx Plugin for AWS. I want a React frontend that talks to a backend orchestrator agent which delegates to specialised research and writing agents.
+</Prompt>
 
 Or for a smaller starting point:
 
-> _"Use the Nx Plugin for AWS to scaffold a React website backed by a tRPC API, with Cognito auth and CDK infrastructure."_
-
-## Build your own MCP Server
-
-Check out the <Link path="/guides/ts-mcp-server">`ts#mcp-server` generator guide</Link> for details about building your own MCP Server.
+<Prompt>
+Use the Nx Plugin for AWS to scaffold a React website backed by a tRPC API, with Cognito auth and CDK infrastructure.
+</Prompt>

package/docs/get_started/concepts.mdx

@@ -50,7 +50,7 @@ In practice:
 - **Upgrading is automated, not a re-adoption exercise.** A workspace generated months ago can move forward with the plugin rather than drifting further from it.
 - **Customisations are pattern-matched, not overwritten.** Migrations check that a file still matches the shape the generator produced. Where it has diverged beyond what they can safely update, they leave your code alone and report the manual follow-up instead.
 - **Some changes arrive as agent prompts.** Where the right edit depends on what you've built, the migration is a prompt your AI coding agent applies rather than a codemod.
-- **Upgrades are opt-in.** Nothing in your workspace changes until you choose to run `nx migrate`.
+- **Upgrades are opt-in.** Nothing in your workspace changes until you choose to run `nx migrate`. After running, you drop any changes you'd rather not take before you commit.
 
 Migrations narrow the gap rather than close it: how far your code has moved decides how much they can do, and some steps will still need your hands.
 

package/docs/get_started/existing-project.mdx

@@ -10,13 +10,16 @@ import NxCommands from '@components/nx-commands.astro';
 import NxInitCommand from '@components/nx-init-command.astro';
 import TsConfigBaseCompilerOptions from '@components/tsconfig-base-compiler-options.astro';
 import GeneratorParameters from '@components/generator-parameters.astro';
+import Prompt from '@components/prompt.astro';
 
 Not every project starts with `pnpm create @aws/nx-workspace`. If you already have an [Nx workspace](https://nx.dev) — or a monorepo you can add Nx to — you can adopt `@aws/nx-plugin` incrementally without recreating your project.
 
-<Aside type="tip">
-You can use your agentic coding tool of choice to add the plugin for you, using the <Link path="get_started/building-with-ai">MCP server</Link>. Try the prompt:
+<Aside type="tip" title="Use your coding agent">
+Your agentic coding tool of choice can add the plugin for you, using the <Link path="get_started/building-with-ai">MCP server</Link>. Try the prompt:
 
-> Add the Nx Plugin for AWS to this project.
+<Prompt>
+Add the Nx Plugin for AWS to this project.
+</Prompt>
 </Aside>
 
 ## Prerequisites

package/docs/get_started/quick-start.mdx

@@ -13,96 +13,100 @@ import RunGenerator from '@components/run-generator.astro';
 import NxCommands from '@components/nx-commands.astro';
 import Infrastructure from '@components/infrastructure.astro';
 import EmbeddedGraph from '@components/embedded-graph.astro';
+import Diff from '@components/diff.astro';
+import Prompt from '@components/prompt.astro';
 
 This guide walks you through the basics of installing and using `@aws/nx-plugin` to rapidly build projects on AWS.
 
-:::tip[Full-Stack Tutorial]
-For a more in-depth tutorial for building a full-stack application, check out the <Link path="get_started/tutorials/dungeon-game/overview">Dungeon Adventure Tutorial</Link>.
-:::
-
 ## Prerequisites
 
 The following global dependencies are needed before proceeding:
 
 <Snippet name="prerequisites" />
 
-## Step 1: Initialize a New Nx Workspace
+## Step 1: Create a Workspace
 
-Run the following command to create an <Link path="guides/workspace">Nx workspace</Link> with the package manager of your choice:
+Create an <Link path="guides/workspace">Nx workspace</Link> with the package manager of your choice, and open the directory it creates:
 
 <CreateNxWorkspaceCommand workspace="my-project" />
 
-:::tip[Choosing an IaC Provider]
-You will be prompted for your preferred infrastructure as code (IaC) provider, either [CDK](https://docs.aws.amazon.com/cdk/) or [Terraform](https://developer.hashicorp.com/terraform). You can skip the prompt by running the command with `--iac`, ie:
+```sh
+cd my-project
+```
 
-<Infrastructure>
-<Fragment slot="cdk">
-<CreateNxWorkspaceCommand workspace="my-project" iac="cdk" />
-</Fragment>
-<Fragment slot="terraform">
-<CreateNxWorkspaceCommand workspace="my-project" iac="terraform" />
-</Fragment>
-</Infrastructure>
+You are prompted to choose your infrastructure as code provider, either [CDK](https://docs.aws.amazon.com/cdk/) or [Terraform](https://developer.hashicorp.com/terraform), and the container engine used by generators which build container images.
 
-You are also prompted for the container engine used by generators which build container images. Accept the default (`infer`) to select Docker if it is installed, otherwise Finch.
-:::
+## Step 2: Build Your Application
 
-Once complete, navigate to the project directory:
+We'll build a full-stack application: a tRPC API, a React website, Cognito authentication, and CDK or Terraform infrastructure. Ask an AI assistant to scaffold it for you, or run the generators yourself — both routes reach the same workspace.
 
-```sh
-cd my-project
-```
+### With AI
 
-## Step 2: Use Generators to Scaffold your Project
+<Steps>
+1. Open the workspace in your AI coding assistant.
 
-We'll add a tRPC API, React Website, Cognito Authentication, and CDK or Terraform Infrastructure in this quick-start guide. Depending on the type of project you're building, you can choose any combination of generators to quickly bootstrap your project. Check out the __Generators__ in the navigation bar to the left to see the full list of options, or try the <Link path="get_started/graph-builder">graph builder</Link> to construct your workspace visually.
+    New workspaces come with the plugin's <Link path="get_started/building-with-ai">MCP server</Link> already configured for Kiro, Claude Code, Cursor, Gemini CLI, GitHub Copilot and OpenAI Codex, so your assistant can look up the plugin's generators and run them without any setup.
 
-As a shortcut, you can use the button below to copy the commands to scaffold the full application.
+2. Ask for the application:
 
-<EmbeddedGraph preset="quick-start" workspace="my-project" iac="cdk" orientation="horizontal" skipWorkspace />
+    <Prompt>
+    Create a tRPC API called demo-api, and a React website called demo-website. Add Cognito authentication to the website, connect the website to the API, and add an infrastructure project called infra. Then instantiate the generated infrastructure components so the website and API deploy, granting authenticated users access to the API.
+    </Prompt>
 
-:::tip[Build with AI]
-The <Link path="get_started/building-with-ai">Nx Plugin for AWS MCP Server</Link> is already configured in your workspace, so you can ask your favourite AI coding agent like Kiro or Claude to build these projects for you instead of typing the CLI commands yourself.
-:::
+    Your assistant discovers the generators through the MCP server and runs them, in the order their dependencies need. Review the changes it makes, then carry on at Step 3.
+</Steps>
 
-Otherwise, follow the steps below to run each generator yourself.
+### With the CLI
 
-### Add a tRPC API
+Run the generators that scaffold the application. Use the button below to copy them all, or run each one yourself as described beneath the diagram.
 
-<RunGenerator generator="ts#api" requiredParameters={{ name: 'demo-api', framework: 'trpc', auth: 'iam' }} noInteractive />
+<Infrastructure>
+<Fragment slot="cdk">
+<EmbeddedGraph preset="quick-start" workspace="my-project" iac="cdk" orientation="horizontal" skipWorkspace />
+</Fragment>
+<Fragment slot="terraform">
+<EmbeddedGraph preset="quick-start" workspace="my-project" iac="terraform" orientation="horizontal" skipWorkspace />
+</Fragment>
+</Infrastructure>
+
+Depending on the type of project you're building, you can choose any combination of generators to quickly bootstrap your project. Check out the __Generators__ in the navigation bar to the left to see the full list of options, or try the <Link path="get_started/graph-builder">graph builder</Link> to construct your workspace visually.
+
+#### Add a tRPC API
+
+<RunGenerator generator="ts#api" requiredParameters={{ name: 'demo-api', framework: 'trpc' }} positional={['name']} noInteractive />
 
 This will create the API inside the `packages/demo-api` folder.
 
-### Add a React Website
+#### Add a React Website
 
-<RunGenerator generator="ts#website" requiredParameters={{ name: 'demo-website' }} noInteractive />
+<RunGenerator generator="ts#website" requiredParameters={{ name: 'demo-website' }} positional={['name']} noInteractive />
 
 This scaffolds a new React website in `packages/demo-website`.
 
-### Add Cognito Authentication
+#### Add Cognito Authentication
 
-<RunGenerator generator="ts#website#auth" requiredParameters={{ project: '@my-project/demo-website', cognitoDomain: 'my-demo' }} noInteractive />
+<RunGenerator generator="ts#website#auth" requiredParameters={{ project: 'demo-website' }} noInteractive />
 
 This sets up the necessary infrastructure and React code to add Cognito Authentication to your website.
 
-### Connect Frontend to Backend
+#### Connect Frontend to Backend
 
-<RunGenerator generator="connection" requiredParameters={{ sourceProject: '@my-project/demo-website', targetProject: '@my-project/demo-api' }} noInteractive />
+<RunGenerator generator="connection" requiredParameters={{ sourceProject: 'demo-website', targetProject: 'demo-api' }} noInteractive />
 
 This configures the necessary providers to ensure your website can call your tRPC API.
 
-### Add Infrastructure
+#### Add Infrastructure
 
 Add the infrastructure project based on your chosen IAC provider.
 
 <Infrastructure>
 <Fragment slot="cdk">
-<RunGenerator generator="ts#infra" requiredParameters={{ name: 'infra' }} noInteractive />
+<RunGenerator generator="ts#infra" requiredParameters={{ name: 'infra' }} positional={['name']} noInteractive />
 
 This configures a CDK App which you can use to deploy your infrastructure on AWS.
 </Fragment>
 <Fragment slot="terraform">
-<RunGenerator generator="terraform#project" requiredParameters={{ name: 'infra' }} noInteractive />
+<RunGenerator generator="terraform#project" requiredParameters={{ name: 'infra' }} positional={['name']} noInteractive />
 
 This configures a Terraform project which you can use to deploy your infrastructure on AWS.
 </Fragment>
@@ -118,6 +122,67 @@ Your website will be available at `http://localhost:4200`.
 
 Changes to both your website and API will be reflected in real-time as both the local website and API servers will hot-reload.
 
+<Drawer title="Calling your API from your website" trigger="Try it: call the API from your website">
+
+Connecting the website to the API added a `useDemoApi` hook, which returns a [tRPC options proxy](https://trpc.io/docs/client/tanstack-react-query): every procedure on your API offers `queryOptions` and `mutationOptions` to hand to [TanStack Query](https://tanstack.com/query/latest).
+
+Update `packages/demo-website/src/routes/index.tsx` to call the API's `echo` procedure, showing a spinner while the request is in flight:
+
+<Diff lang="tsx" before={`import { createFileRoute } from '@tanstack/react-router';
+
+export const Route = createFileRoute('/')({
+  component: RouteComponent,
+});
+
+function RouteComponent() {
+  return (
+    <div className="text-center">
+      <header>
+        <h1>Welcome</h1>
+        <p>Welcome to your new React website!</p>
+      </header>
+    </div>
+  );
+}
+`} after={`import { useQuery } from '@tanstack/react-query';
+import { createFileRoute } from '@tanstack/react-router';
+import { Spinner } from '../components/spinner';
+import { useDemoApi } from '../hooks/useDemoApi';
+
+export const Route = createFileRoute('/')({
+  component: RouteComponent,
+});
+
+function RouteComponent() {
+  const trpc = useDemoApi();
+  const echo = useQuery(
+    trpc.echo.queryOptions({ message: 'Hello from the API!' }),
+  );
+
+  return (
+    <div className="text-center">
+      <header>
+        <h1>Welcome</h1>
+        <p>Welcome to your new React website!</p>
+      </header>
+      {echo.isLoading ? (
+        <Spinner />
+      ) : echo.error ? (
+        <p>Error: {echo.error.message}</p>
+      ) : (
+        <p>{echo.data?.message}</p>
+      )}
+    </div>
+  );
+}
+`} />
+
+Save the file and the page reloads with the message your API echoed back. The call is type-safe end to end — rename `message` in `packages/demo-api/src/schema/echo.ts` and your website stops compiling until you follow the change through.
+
+See the <Link path="guides/connection/react-trpc">React to tRPC connection guide</Link> for mutations, subscriptions, error handling and optimistic updates.
+
+</Drawer>
+
 ## Step 4: Define Cloud Resources and Deploy to AWS
 
 <Infrastructure>
@@ -154,11 +219,6 @@ This is all the CDK we need to write to deploy our full stack application.
 Open `packages/infra/src/main.tf` and add the following code:
 
 ```hcl
-# Include metrics tracking for @aws/nx-plugin usage
-module "metrics" {
-  source = "../../common/terraform/src/metrics"
-}
-
 # Deploy user identity
 module "user_identity" {
   source = "../../common/terraform/src/core/user-identity"
@@ -213,6 +273,15 @@ module "demo_website" {
 
   depends_on = [module.user_identity, module.demo_api]
 }
+
+# Print the website URL and user pool id when the deployment finishes
+output "website_url" {
+  value = module.demo_website.website_url
+}
+
+output "user_pool_id" {
+  value = module.user_identity.user_pool_id
+}
 ```
 
 This is all the Terraform we need to write to deploy our full stack application.
@@ -231,7 +300,7 @@ If you encounter any lint or formatting errors, you can run the following comman
 <PackageManagerShortCommand commands={["lint"]} />
 :::
 
-:::tip[The workspace is out of sync]
+:::note[The workspace is out of sync]
 If the build reports `The workspace is out of sync`, accept the prompt to sync the workspace or run the following sync command directly before retrying the build:
 
 <NxCommands commands={["sync"]} />
@@ -246,7 +315,9 @@ Bootstrap your infrastructure:
 <NxCommands commands={['bootstrap infra']} />
 
 :::tip[Bootstrap Regions]
-CDK bootstrapping is required for both your target deployment AWS region, and `us-east-1` to allow deployment of the AWS WAF WebACL for the website.
+CDK bootstrapping is required for both your target deployment AWS region, and `us-east-1` to allow deployment of the AWS WAF WebACL for the website. If you are deploying elsewhere, bootstrap `us-east-1` too:
+
+<NxCommands commands={['run infra:bootstrap --args="aws://<account-id>/us-east-1"']} />
 :::
 </Fragment>
 <Fragment slot="terraform">
@@ -308,6 +379,8 @@ The first time you sign in as this user you are prompted to choose a new passwor
 
 Your website is also served from CloudFront. Open its distribution domain name (which is printed to your terminal after deployment) to use the version running entirely on AWS.
 
+Congratulations! 🎉 You have successfully built and deployed a full-stack application using `@aws/nx-plugin`!
+
 ## Step 6: Clean Up
 
 When you have finished, delete the resources you deployed to avoid ongoing costs:
@@ -315,16 +388,47 @@ When you have finished, delete the resources you deployed to avoid ongoing costs
 <Infrastructure>
 <Fragment slot="cdk">
 <NxCommands commands={['destroy-sandbox infra']} />
+
+:::note[Retained Resources]
+The Cognito user pool is created with deletion protection enabled, so it is not removed automatically. Delete it (and the IAM role Cognito uses to send SMS messages) manually if you no longer need them.
+:::
 </Fragment>
 <Fragment slot="terraform">
 <NxCommands commands={['destroy infra']} />
+
+:::note[Retained Resources]
+The Cognito user pool is created with deletion protection enabled, so it is not removed automatically (the destroy command will report a failure). Delete it (and the IAM role Cognito uses to send SMS messages) manually if you no longer need them.
+:::
 </Fragment>
 </Infrastructure>
 
-:::note[Retained Resources]
-The Cognito user pool is created with deletion protection enabled, so it is not removed automatically. Delete it (and the IAM role Cognito uses to send SMS messages) manually if you no longer need them.
+To remove bootstrap resources, follow below:
+
+<Infrastructure>
+<Fragment slot="cdk">
+Delete the bootstrap stack in every region you bootstrapped, including `us-east-1`. This removes the bootstrap roles and the container image repository:
+
+```sh
+aws cloudformation delete-stack --stack-name CDKToolkit --region <region>
+```
+
+:::note[Asset Bucket]
+The asset bucket is retained on purpose, so delete it separately.
 :::
+</Fragment>
+<Fragment slot="terraform">
+<NxCommands commands={['bootstrap-destroy infra']} />
+
+:::caution[Your Terraform State Is Deleted Too]
+This empties and deletes the S3 bucket holding your Terraform state, so only run it once you have torn down all deployed infrastructure.
+:::
+</Fragment>
+</Infrastructure>
 
 ---
 
-Congratulations! 🎉 You have successfully built and deployed a full-stack application using `@aws/nx-plugin`!
+## Next Steps
+
+- <Link path="get_started/tutorials/dungeon-game/overview">Dungeon Adventure Tutorial</Link> — build a full-stack AI dungeon adventure game, for a more in-depth walkthrough than this guide.
+- <Link path="guides/workspace">Workspaces</Link> — how your workspace is laid out, and the configuration the generators share.
+- <Link path="get_started/existing-project">Add to an Existing Project</Link> — adopt the plugin in your existing codebase.

package/docs/get_started/tutorials/dungeon-game/overview.mdx

@@ -10,7 +10,6 @@ import Drawer from '@components/drawer.astro';
 import RunGenerator from '@components/run-generator.astro';
 import NxCommands from '@components/nx-commands.astro';
 import InstallCommand from '@components/install-command.astro';
-import Link from '@components/link.astro';
 
 import baselineWebsitePng from '@assets/baseline-website.png'
 import baselineGamePng from '@assets/baseline-game.png'
@@ -138,8 +137,4 @@ Before you proceed, you will need the following global dependencies:
 
 <Snippet name="required-prerequisites" />
 - [AWS Credentials](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) configured to your target AWS account, since this tutorial deploys the application and invokes Amazon Bedrock
-- [Docker](https://www.docker.com/) (or [Finch](https://github.com/runfinch/finch)) is required for local DynamoDB development
-
-:::tip[AI Assistant Setup]
-If you use an AI Assistant such as Kiro, Kiro CLI, Cursor, Claude Code or Cline, refer to the <Link path="/get_started/building-with-ai">install the Nx Plugin for AWS MCP server</Link> page.
-:::
+- [Docker](https://www.docker.com/) (or [Finch](https://github.com/runfinch/finch)) is required for local DynamoDB development

package/docs/snippets/pdk-migration/example/01-migrate-api.mdx

@@ -8,6 +8,7 @@ import Link from '@components/link.astro';
 import NxCommands from '@components/nx-commands.astro';
 import Drawer from '@components/drawer.astro';
 import InstallCommand from '@components/install-command.astro';
+import PackageManagerShortCommand from '@components/package-manager-short-command.astro';
 
 The `TypeSafeApiProject` used in the shopping list application made use of:
 
@@ -114,12 +115,12 @@ Now that we have the basic structure for our Smithy API project, we can migrate
 
 At this point, let's run a build to check our model changes and ensure we have some generated server code to work with. There will be some failures in the backend project (`@shopping-list/api`) but we'll address those next.
 
-<NxCommands commands={["run-many --target build"]} />
+<PackageManagerShortCommand commands={["build"]} />
 
 :::note
 You may see a build failure due to lint issues. These can usually be automatically fixed:
 
-<NxCommands commands={["run-many --target lint --fix"]} />
+<PackageManagerShortCommand commands={["lint"]} />
 :::
 
 #### Migrate the Lambda Handlers
@@ -132,7 +133,7 @@ The shopping list application's lambda handlers rely on the `@aws-sdk/client-dyn
 
 <InstallCommand pkg="@aws-sdk/client-dynamodb" project="@shopping-list/api" />
 
-Then, let's copy the `handlers/src/dynamo-client.ts` file from the PDK project to `backend/src/operations` so it's available for our handlers.
+Then, let's copy the `handlers/typescript/src/dynamo-client.ts` file from the PDK project to `backend/src/operations` so it's available for our handlers.
 
 The `ts#smithy-api` generator scaffolds an example `Echo` operation. Since we removed this from our model, delete the corresponding handler in `backend/src/operations/echo.ts`. We'll register our migrated operations in `service.ts` further below.
 
@@ -587,6 +588,7 @@ Additionally, update `packages/api/backend/project.json` and update `metadata.ap
 +    "apiName": "my-api",
     "auth": "iam",
     "modelProject": "@shopping-list/api-model",
+    "iac": "cdk",
     "ports": [3001]
   },
 ```
@@ -595,10 +597,10 @@ Additionally, update `packages/api/backend/project.json` and update `metadata.ap
 
 We can now build the project to check that the migration has worked so far:
 
-<NxCommands commands={["run-many --target build"]} />
+<PackageManagerShortCommand commands={["build"]} />
 
 :::note
 You may see a build failure due to lint issues. These can usually be automatically fixed:
 
-<NxCommands commands={["run-many --target lint --fix"]} />
+<PackageManagerShortCommand commands={["lint"]} />
 :::

package/docs/snippets/pdk-migration/example/02-migrate-website.mdx

@@ -8,6 +8,7 @@ import Link from '@components/link.astro';
 import NxCommands from '@components/nx-commands.astro';
 import Drawer from '@components/drawer.astro';
 import InstallCommand from '@components/install-command.astro';
+import PackageManagerShortCommand from '@components/package-manager-short-command.astro';
 
 The `CloudscapeReactTsWebsiteProject` used in the shopping list application configured a React website with CloudScape and Cognito authentication built in.
 
@@ -100,7 +101,7 @@ Since we're using [file-based routing](https://tanstack.com/router/latest/docs/f
 
 Let's start the local website server:
 
-<NxCommands commands={["dev website"]} />
+<PackageManagerShortCommand commands={["dev"]} />
 
 :::tip
 We're using the `dev` target here, which also starts local servers for any APIs which have been connected with `connection`, and hot-reloads if your website, model, or backend changes! This allows us to test our API and website locally before we've even written any CDK code.

package/docs/snippets/pdk-migration/example/03-migrate-infra.mdx

@@ -8,6 +8,7 @@ import Link from '@components/link.astro';
 import NxCommands from '@components/nx-commands.astro';
 import Drawer from '@components/drawer.astro';
 import InstallCommand from '@components/install-command.astro';
+import PackageManagerShortCommand from '@components/package-manager-short-command.astro';
 
 The last project we need to migrate for our shopping list application is the `InfrastructureTsProject`. This is a TypeScript CDK project, for which the Nx Plugin for AWS equivalent is the <Link path="/guides/typescript-infrastructure">`ts#infra` generator</Link>.
 
@@ -152,10 +153,10 @@ Notice that we don't pass the identity or API to the website - runtime config is
 
 Let's build the project now that we've migrated all the relevant parts of the codebase to our new project.
 
-<NxCommands commands={["run-many --target build"]} />
+<PackageManagerShortCommand commands={["build"]} />
 
 :::caution
 You may see a build failure due to lint issues. These can usually be automatically fixed:
 
-<NxCommands commands={["run-many --target lint --fix"]} />
+<PackageManagerShortCommand commands={["lint"]} />
 :::

package/docs/snippets/pdk-migration/example/04-deploy.mdx

@@ -8,6 +8,7 @@ import Link from '@components/link.astro';
 import NxCommands from '@components/nx-commands.astro';
 import Drawer from '@components/drawer.astro';
 import InstallCommand from '@components/install-command.astro';
+import PackageManagerShortCommand from '@components/package-manager-short-command.astro';
 
 
 Now we've got our fully migrated codebase, we can look at deploying it. There are two paths we can take at this point.
@@ -22,7 +23,7 @@ The simplest approach is to treat this as a completely new application, meaning
 
 1. Deploy the new application:
 
-    <NxCommands commands={["deploy infra shopping-list-infra-sandbox/*"]} />
+    <NxCommands commands={['deploy-sandbox infra']} />
 
 </Steps>
 
@@ -63,7 +64,7 @@ For our shopping list application, the stateful resources we care about are the
 
     ```diff lang="ts"
     // packages/common/constructs/src/core/user-identity.ts
-    -this.userPool = this.createUserPool();
+    -this.userPool = this.createUserPool(mfa, mfaSecondFactor);
     +this.userPool = UserPool.fromUserPoolId(
     +  this,
     +  'UserPool',
@@ -73,9 +74,9 @@ For our shopping list application, the stateful resources we care about are the
 
 1. Build and deploy the new application:
 
-    <NxCommands commands={["run-many --target build"]} />
+    <PackageManagerShortCommand commands={["build"]} />
 
-    <NxCommands commands={["deploy infra shopping-list-infra-sandbox/*"]} />
+    <NxCommands commands={['deploy-sandbox infra']} />
 
     Now we have our new application stood up referencing the existing resources, not yet taking any traffic.
 
@@ -98,7 +99,7 @@ For our shopping list application, the stateful resources we care about are the
 
     ```diff lang="ts"
     // packages/common/constructs/src/core/user-identity.ts
-    +this.userPool = this.createUserPool();
+    +this.userPool = this.createUserPool(mfa, mfaSecondFactor);
     -this.userPool = UserPool.fromUserPoolId(
     -  this,
     -  'UserPool',
@@ -108,7 +109,7 @@ For our shopping list application, the stateful resources we care about are the
 
     And then run a build
 
-    <NxCommands commands={["run-many --target build"]} />
+    <PackageManagerShortCommand commands={["build"]} />
 
 1. Use `cdk import` in your new application's `packages/infra` folder to see which resources we'll be prompted to import.
 
@@ -199,7 +200,7 @@ For our shopping list application, the stateful resources we care about are the
 
 1. Deploy the new application again to make sure that any changes to these existing resources (now managed by your new stack) are made:
 
-    <NxCommands commands={["deploy infra shopping-list-infra-sandbox/*"]} />
+    <NxCommands commands={['deploy-sandbox infra']} />
 
 1. Perform a full test of your new application again
 

package/docs/snippets/pdk-migration/faq/type-safe-api.mdx

@@ -14,7 +14,7 @@ The most commonly used components from Type Safe API are covered in the example
 
 #### APIs Modelled with OpenAPI
 
-The Nx Plugin for AWS supports APIs modelled in Smithy, but not those modelled directly OpenAPI. The <Link path="/guides/ts-smithy-api">`ts#smithy-api` generator</Link> is a good starting point which you can then modify. You can define your OpenAPI specification in the `model` project's `src` folder instead of Smithy, and modify the `build.Dockerfile` to use your desired code generation tool for clients/servers if they aren't available on NPM. If your desired tools are on NPM, you can just install them as dev dependencies to your Nx workspace and call them directly as Nx build targets.
+The Nx Plugin for AWS supports APIs modelled in Smithy, but not those modelled directly OpenAPI. The <Link path="/guides/ts-smithy-api">`ts#smithy-api` generator</Link> is a good starting point which you can then modify. You can define your OpenAPI specification in the `model` project's `src` folder instead of Smithy, and update the `model` project's `compile` target to run your desired code generation tool for clients/servers. If your desired tools are on NPM, you can install them as dev dependencies to your Nx workspace and call them directly as Nx build targets.
 
 ##### Backend
 
@@ -153,7 +153,7 @@ const pythonLambdaHandler = new Function(this, 'PythonImplementation', {
   ...
 });
 
-new MyApi(this, 'MyApi', {
+new Api(this, 'MyApi', {
   integrations: Api.defaultIntegrations(this)
     .withOverrides({
       echo: {

package/docs/snippets/prerequisites.mdx

@@ -1,7 +1,6 @@
 ---
 title: Prerequisites
 ---
-import Link from '@components/link.astro';
 import Snippet from '@components/snippet.astro';
 
 ### Required
@@ -11,7 +10,3 @@ import Snippet from '@components/snippet.astro';
 ### Recommended
 
 <Snippet name="recommended-prerequisites" parentHeading="Recommended" />
-
-:::tip[AI Assistant Setup]
-If you use an AI Assistant such as Kiro, Kiro CLI, Cursor, Claude Code or Codex, you may also wish to <Link path="/get_started/building-with-ai">install the Nx Plugin for AWS MCP server.</Link>
-:::

package/docs/snippets/recommended-prerequisites.mdx

@@ -1,7 +1,7 @@
 ---
 title: Recommended Prerequisites
 ---
-- [PNPM >= 11](https://pnpm.io/installation#using-npm) (you can also use [Yarn >= 4](https://yarnpkg.com/getting-started/install), [Bun >= 1](https://bun.sh/docs/installation), or [NPM >= 10](https://nodejs.org/en/learn/getting-started/an-introduction-to-the-npm-package-manager) if you prefer)
+- [PNPM >= 11](https://pnpm.io/installation#using-npm) (you can also use [Yarn >= 4](https://yarnpkg.com/getting-started/install), [Bun >= 1](https://bun.sh/docs/installation), or [NPM >= 11](https://nodejs.org/en/learn/getting-started/an-introduction-to-the-npm-package-manager) if you prefer)
   - verify by running `pnpm --version`, `yarn --version`, `bun --version` or `npm --version`
 - [AWS Credentials](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) configured to your target AWS account are required to deploy your application (as well as for some local development workflows).
 - [Docker](https://www.docker.com/) or [Finch >= 1.6.0](https://runfinch.com/) is required for some generators. For Docker, [multi-platform builds](https://docs.docker.com/build/building/multi-platform/) must be set up; Finch supports [multi-platform builds](https://runfinch.com/docs/getting-started/building-images/#building-a-multi-architecture-container-image) out of the box.

package/docs/snippets/workspace-prerequisite.mdx

@@ -0,0 +1,8 @@
+---
+title: Workspace Prerequisite
+---
+import Link from '@components/link.astro';
+
+:::note[Start here]
+Generators run inside an Nx workspace with `@aws/nx-plugin` installed. If you don't have one yet, start by <Link path="guides/workspace">creating a workspace</Link>, or <Link path="get_started/existing-project">adding the plugin to an existing project</Link>.
+:::

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/nx-plugin-mcp",
-  "version": "1.0.0-rc.98",
+  "version": "1.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",