Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion cookbooks/cross-repo-dependencies.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions cookbooks/make-agents-use-the-graph.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<Tabs>
<Tab title="Graphify">
Expand Down Expand Up @@ -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.
</Accordion>
<Accordion title="Where do the instructions go?" icon="file-text">
`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/`.
</Accordion>
<Accordion title="Does the hosted MCP server have hooks?" icon="webhook">
No. On hosted, the instruction block does that job. Hooks are part of open-source Graphify.
Expand Down
2 changes: 1 addition & 1 deletion for-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Loading