Skip to content

chore: move CLAUDE.md to AGENTS.md, and stop turbo writing to it - #171

Merged
btravers merged 1 commit into
mainfrom
chore/agents-md
Oct 6, 2026
Merged

btravers merged 1 commit into
mainfrom
chore/agents-md

Conversation

@btravers

@btravers btravers commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • CLAUDE.md → AGENTS.md, moved with git mv so history follows the file. Only its title line changed ("guidance to AI coding agents").
  • The untracked AGENTS.md it replaces was turbo's. Turbo (2.11.7) keeps a managed block in the root AGENTS.md whenever it detects an AI agent, and its docs say it re-adds that block after removal. Left alone, it would have injected the block into the moved file on the next run.
  • "agentGuidance": false in turbo.json opts out. I checked it: after a turbo run, AGENTS.md contains no turborepo block.
  • .coderabbit.yaml already names both files, and nothing else in the repo references CLAUDE.md.

No code change. No changeset.

🤖 Generated with Claude Code

The repository's agent instructions now live in AGENTS.md, the
tool-neutral name; the file is moved, so its history follows it.

The untracked AGENTS.md it replaces was turbo's own: turbo maintains a
managed block in the root AGENTS.md whenever it detects an AI agent, and
would have re-added that block to the moved file on the next run.
`"agentGuidance": false` in turbo.json opts out.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
Copilot AI balanced review requested due to automatic review settings October 6, 2026 13:15
@coderabbitai

coderabbitai Bot commented Oct 6, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 13 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration
  • Configuration used: Repository: btravstack/entity/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 66389cd0-13b0-476c-aa91-48823084b5a7
📥 Commits

Reviewing files that changed from the base of the PR and between 7eb045c and fe4b2fa.

📒 Files selected for processing (2)
  • AGENTS.md
  • turbo.json
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@btravers
btravers merged commit 228151a into main Oct 6, 2026
15 checks passed
@btravers
btravers deleted the chore/agents-md branch October 6, 2026 13:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

It is a verified documentation rename plus a confirmed-valid turbo config opt-out with no code changes and no dangling references.

Review effort: Balanced
Findings: None

What changed in this PR

This PR renames the repository's AI-agent guidance file from CLAUDE.md to the now-conventional AGENTS.md, and opts the repo out of Turborepo's automatic AGENTS.md management. The move was done via git mv so history follows the file, with only the title and intro sentence updated to be agent-agnostic. The agentGuidance: false setting prevents turbo (2.11.7) from re-injecting its managed block into the file on subsequent runs. This is a documentation/configuration-only change with no code impact.

Changes:

  • Rename CLAUDE.md → AGENTS.md, updating only the heading and the intro line to reference "AI coding agents" instead of "Claude Code".
  • Add "agentGuidance": false to turbo.json to disable turbo's automatic AGENTS.md block injection.
File Description
AGENTS.md Retitled from CLAUDE.md; intro line generalized to "AI coding agents"; body content unchanged.
turbo.json Adds agentGuidance: false to stop Turborepo managing the root AGENTS.md.

Notes from verification:

  • A repo-wide search confirms the only remaining mention of CLAUDE.md is in .coderabbit.yaml, where it legitimately lists both filenames as documentation types to watch — not a stale path reference, so no update is needed.
  • agentGuidance: false is a valid root turbo.json option that opts out of the managed-block injection, consistent with turbo 2.11.7.
  • AGENTS.md is not gitignored, so the moved file is tracked correctly.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants