Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions src/components/Modal/Modal.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -65,9 +65,9 @@ export const Modal = (_props: ViewProps) => {
aria-hidden="true"
className="modal-key-point-left"
textAlign="center"
fontSize="xxxl"
fontSize="xxl"
>
🧩
<IconStar />
</View>
<Flex className="modal-key-point-right">
<Text as="h3" className="modal-key-point-heading">
Expand All @@ -81,7 +81,12 @@ export const Modal = (_props: ViewProps) => {
</Flex>
</Flex>
<Flex className="modal-key-point">
<View className="modal-key-point-left" aria-hidden="true">
<View
aria-hidden="true"
className="modal-key-point-left"
textAlign="center"
fontSize="xxl"
>
<IconAWS />
</View>
<Flex className="modal-key-point-right">
Expand Down
48 changes: 47 additions & 1 deletion src/pages/[platform]/develop-with-ai/steering-files/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { getCustomStaticPath } from '@/utils/getCustomStaticPath';
export const meta = {
title: 'Steering files',
description:
'Configure project-level context files to guide AI coding assistants when building Amplify applications.',
'Configure project-level context files to guide AI coding assistants when building Amplify applications, including AWS Blocks integration patterns.',
platforms: [
'android',
'angular',
Expand Down Expand Up @@ -118,6 +118,52 @@ globs: amplify/**/*

Download these files and place them in a `context/` folder in your project root.

## AWS Blocks integration

If your project uses [AWS Blocks](/[platform]/build-a-backend/aws-blocks/) alongside Amplify, you can guide AI coding assistants to follow the Blocks integration patterns — defining backend capability in `aws-blocks/index.ts`, authenticating with your Amplify Cognito pool, and calling the generated typed client instead of constructing requests by hand.

### Use the official AWS Blocks skill (recommended)

AWS publishes an [AWS agent toolkit](https://github.com/aws/agent-toolkit-for-aws) — official, AWS-supported skills and plugins for AI coding agents — that includes an **`aws-blocks` skill**. The skill loads on demand when your task involves AWS Blocks (for example, when your project has an `aws-blocks/` directory or imports `@aws-blocks` packages) and keeps the assistant aligned with the current Blocks APIs and best practices, so you don't have to hand-maintain steering rules.

Install it once for your assistant:

<Accordion title="Claude Code" headingLevel="4">

```bash
/plugin install aws-core@claude-plugins-official
```

If you see a "Plugin not found" error, refresh the marketplace index first with `/plugin marketplace update claude-plugins-official`.

</Accordion>

<Accordion title="Skills CLI (Cursor, and other tools)" headingLevel="4">

```bash
npx skills add aws/agent-toolkit-for-aws/skills --skill aws-blocks
```

</Accordion>

<Accordion title="Codex" headingLevel="4">

```bash
codex plugin marketplace add aws/agent-toolkit-for-aws
```

Then launch Codex, run `/plugins`, and install the **aws-core** plugin.

</Accordion>

For the full list of tools and setup options, see the [AWS agent toolkit](https://github.com/aws/agent-toolkit-for-aws) repository.

### Scaffold the project rules

`create-blocks-app` can generate an `AGENTS.md` that documents the Blocks integration patterns for AI assistants, so in most cases you don't need to write steering rules by hand. To add AWS Blocks to your project, see [Add AWS Blocks to your Amplify project](/[platform]/build-a-backend/aws-blocks/get-started/).

For authoritative, always-current guidance, point your assistant at the [`aws-blocks` skill](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-blocks) or an `AGENTS.md` rather than maintaining a separate copy of the rules, which can drift out of date as the Blocks APIs evolve.

## Tips for effective steering

- **Be specific about imports** — Tell the assistant which packages to import from (`@aws-amplify/backend` for backend, `aws-amplify` for frontend)
Expand Down
Loading