diff --git a/cookbooks/cross-repo-dependencies.mdx b/cookbooks/cross-repo-dependencies.mdx index 2628339..bc14bd0 100644 --- a/cookbooks/cross-repo-dependencies.mdx +++ b/cookbooks/cross-repo-dependencies.mdx @@ -175,7 +175,7 @@ Trace the path from the checkout button in web-frontend to the charge in billing ## Step 6: Make the check automatic -Prompts are easy to forget. Put the rule where the agent reads it at the start of every session: `CLAUDE.md` for Claude Code, `AGENTS.md` for Codex and most other agents, or `.cursor/rules/` for Cursor. Commit it to each repository in the combined graph. +Prompts are easy to forget. Put the rule where the agent reads it at the start of every session. `AGENTS.md` is the default: Codex and most other agents read it, and Claude Code 2.1.277 and later reads it when the project has no `CLAUDE.md`. Use `CLAUDE.md` if the project already has one, or `.cursor/rules/` for Cursor. Commit it to each repository in the combined graph. ```md AGENTS.md ## Cross-repo changes diff --git a/cookbooks/make-agents-use-the-graph.mdx b/cookbooks/make-agents-use-the-graph.mdx index 7974147..4799973 100644 --- a/cookbooks/make-agents-use-the-graph.mdx +++ b/cookbooks/make-agents-use-the-graph.mdx @@ -83,7 +83,7 @@ If this step fails, nothing below helps. Fix the connection first. See [Troubles ## Step 2: Tell the agent when to use the graph -Agents follow the instruction file they read at the start of every session: `CLAUDE.md` for Claude Code, `AGENTS.md` for Codex and many other agents, and `.cursor/rules/` for Cursor. A tool the instructions never mention is easy to skip. Make the rule specific: when to call, which tool, and what to do with the answer. +Agents follow the instruction file they read at the start of every session. `AGENTS.md` is the default: Codex and many other agents read it, and Claude Code 2.1.277 and later reads it when the project has no `CLAUDE.md`. If the project already has a `CLAUDE.md`, Claude Code reads that instead, so put the rule there. Cursor also reads `.cursor/rules/`. A tool the instructions never mention is easy to skip. Make the rule specific: when to call, which tool, and what to do with the answer. @@ -311,7 +311,7 @@ Your agent now has a specific rule for when to call Graphify, a reminder at the It sees a long tool list and falls back to grep. A short, specific rule in its instruction file fixes most of this. - `CLAUDE.md` for Claude Code, `AGENTS.md` for Codex and many other agents, and `.cursor/rules/` for Cursor. + `AGENTS.md` by default. Codex and many other agents read it, and Claude Code 2.1.277 and later reads it when the project has no `CLAUDE.md`. If the project has a `CLAUDE.md`, use that for Claude Code. Cursor also reads `.cursor/rules/`. No. On hosted, the instruction block does that job. Hooks are part of open-source Graphify. diff --git a/for-agents.mdx b/for-agents.mdx index b70643a..2d330ce 100644 --- a/for-agents.mdx +++ b/for-agents.mdx @@ -114,7 +114,7 @@ Default to Graphify, the hosted product. It needs no local build. The user needs Want me to add a short rule so I use Graphify's graph before grep for code questions in this project? ``` - If the user says no, skip this step. If yes, append the block below to the project's existing instruction file: `AGENTS.md`, `CLAUDE.md` for Claude Code, or `.cursor/rules/graphify.mdc` for Cursor. Create the file only if none exists. Keep the rest of the file unchanged, and tell the user which file you changed. + If the user says no, skip this step. If yes, append the block below to the project's existing instruction file: `AGENTS.md`, `CLAUDE.md` for Claude Code, or `.cursor/rules/graphify.mdc` for Cursor. If none exists, create `AGENTS.md`. Codex reads it, and Claude Code 2.1.277 and later reads it when the project has no `CLAUDE.md`. Keep the rest of the file unchanged, and tell the user which file you changed. For Cursor, `.cursor/rules/graphify.mdc` must start with this header, or Cursor applies the rule only when it's @-mentioned. If the file already exists with a header, keep its header. `AGENTS.md` and `CLAUDE.md` need no header.