aws / aws/aws-toolkit-vscode

Amazon Q ignores config for using AGENTS.md

Open
#8,228 3 comments 1 reaction 0 assignees View on GitHub
bug
Dominant language
TypeScript
Stars
2k
Forks
807
Avg merge
10h 12m
Merged PRs (30d)
7

Description

## Problem

I want Amazon Q to read AGENTS.md like every other agent does, but it doesn't by default and it appears to ignore the `resources` setting. The [AGENTS.md](https://agents.md/) website suggests using symlinks in such situations, but that is not a reliable solution on Windows with Git.

## Steps to reproduce the issue

1. Edit `.amazonq/agents/default.json` to add `AGENTS.md` to resources:
```json
{
"resources": [
"file://AGENTS.md",
"file://AmazonQ.md",
"file://README.md",
"file://.amazonq/rules/**/*.md"
],
}
```
2. Click Rules in Amazon Q: Chat

## Expected behavior

See `AGENTS.md` listed and enabled.

## System details (run `AWS: About` and/or `Amazon Q: About`)

OS: Windows_NT x64 10.0.26200
Visual Studio Code extension host: 1.105.1
Amazon Q: 1.101.0
node: 22.19.0
electron: 37.6.0

Contributor guide

Open the contributing guide

Research direction

Start with the `.amazonq/agents/default.json` resources configuration and reproduce the issue through Rules in Amazon Q: Chat on the reported Windows setup. Done means `AGENTS.md` is listed and enabled after adding it to `resources`, without relying on symlinks.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript, vscode
Domain
devtools
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.