amazon-q-developer-cli icon indicating copy to clipboard operation
amazon-q-developer-cli copied to clipboard

Feature: Read AGENTS.md on project start

Open BartVB opened this issue 4 months ago • 2 comments

We are using several different AI tools. Most of these seem to be converging to using AGENTS.md in the project folder for agent instructions and project specific tools, conventions and hints.

It would be great if Amazon Q would read this when opening a project. Creating AGENTS.md, CLAUDE.md and ~/.amazonq/rules/* all for the same purpose is quite messy.

BartVB avatar Aug 28 '25 08:08 BartVB

I worked around this by creating:

~/.aws/amazonq/cli-agents/default.json

Copy pasting the default agent from: https://github.com/aws/amazon-q-developer-cli/blob/main/docs/default-agent-behavior.md#3-built-in-default-agent

and then adding the AGENTS.md file (and some other things while I was at it).

Still would be much more convenient if Q Chat would read it by default.

BartVB avatar Aug 28 '25 21:08 BartVB

This is feeling fairly standard at this point - Codex, Cursor, RooCode etc. all support this.

cerdman avatar Nov 18 '25 21:11 cerdman