Amazon Q ignores config for using AGENTS.md
- 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
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