From 6467bff1769a9bacdb1ca4115f7e582869375574 Mon Sep 17 00:00:00 2001 From: Angie Jones Date: Tue, 26 Aug 2025 09:31:06 -0500 Subject: [PATCH] docs: AGENTS.md is read by default (#4346) --- documentation/docs/guides/using-goosehints.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/docs/guides/using-goosehints.md b/documentation/docs/guides/using-goosehints.md index 977118f8..64201f1c 100644 --- a/documentation/docs/guides/using-goosehints.md +++ b/documentation/docs/guides/using-goosehints.md @@ -131,9 +131,9 @@ Like prompts, this is not an extensive list to shape your `.goosehints` file. Yo ## Custom Context Files -Goose looks for `.goosehints` files by default, but you can configure a different filename or multiple context files using the `CONTEXT_FILE_NAMES` environment variable. This is useful for: +Goose looks for `AGENTS.md` then `.goosehints` files by default, but you can configure a different filename or multiple context files using the `CONTEXT_FILE_NAMES` environment variable. This is useful for: -- **Tool compatibility**: Use conventions from other AI tools (`AGENTS.md`, `CLAUDE.md`) +- **Tool compatibility**: Use conventions from other AI tools (e.g. `CLAUDE.md`) - **Organization**: Separate frequently-used rules into multiple files that load automatically - **Project conventions**: Use context files from your project's established toolchain (`.cursorrules`) @@ -143,7 +143,7 @@ Here's how it works: ### Configuration -Set the `CONTEXT_FILE_NAMES` environment variable to a JSON array of filenames. The default is `[".goosehints"]`. +Set the `CONTEXT_FILE_NAMES` environment variable to a JSON array of filenames. The default is `["AGENTS.md", ".goosehints"]`. ```bash # Single custom file