Skip to content

CLI-1511 Experiment: nested AGENTS.md only (remove CLAUDE.md) - #1236

Closed
sophio-japharidze-sonarsource wants to merge 1 commit into
masterfrom
cursor/agents-md-only-experiment-1989
Closed

sophio-japharidze-sonarsource wants to merge 1 commit into
masterfrom
cursor/agents-md-only-experiment-1989

Conversation

@sophio-japharidze-sonarsource

Copy link
Copy Markdown
Member

Summary

  • Remove root CLAUDE.md and the AGENTS.md → CLAUDE.md symlink; a single root AGENTS.md is the source of truth.
  • Rename every in-repo nested CLAUDE.md to AGENTS.md and update internal cross-references (integration tests that assert on end-user ~/.claude/CLAUDE.md are unchanged).
  • Add per-directory canary codewords and docs/experiments/nested-agents-md-canaries.md plus scripts/list-nested-agents-canaries.sh to test whether agents auto-load nested AGENTS.md.

How to verify nested loading

  1. Check out this branch and start a new Claude Code or Cursor session.
  2. Run ./scripts/list-nested-agents-canaries.sh.
  3. Open a source file under a directory (e.g. src/core/stats/stats-queries.ts) without @-mentioning that directory's AGENTS.md.
  4. Send the probe prompt from docs/experiments/nested-agents-md-canaries.md (e.g. ask for LOADED=CANARY-STATS-PLUM).

Note

sonar integrate claude still targets the product filename CLAUDE.md for user projects; this PR only changes repository documentation layout.

Open in Web Open in Cursor 

Drop the root CLAUDE.md and symlink; keep a single root AGENTS.md.
Rename directory-scoped CLAUDE.md files to AGENTS.md, update in-repo
cross-references, and add canary codewords plus docs/scripts to probe
whether agents load nested AGENTS.md when editing files under each path.

Co-authored-by: Sophio Japharidze <sophio-japharidze-sonarsource@users.noreply.github.com>
@netlify

netlify Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for sonarqube-cli ready!

Name Link
🔨 Latest commit 88cb17c
🔍 Latest deploy log https://app.netlify.com/projects/sonarqube-cli/deploys/6af1c40eb7225f353ff20d87
😎 Deploy Preview https://deploy-preview-1236--sonarqube-cli.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@hashicorp-vault-sonar-prod hashicorp-vault-sonar-prod Bot changed the title Experiment: nested AGENTS.md only (remove CLAUDE.md) CLI-1511 Experiment: nested AGENTS.md only (remove CLAUDE.md) Nov 9, 2026
@hashicorp-vault-sonar-prod

hashicorp-vault-sonar-prod Bot commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

CLI-1511

@gitar-bot

gitar-bot Bot commented Nov 9, 2026

Copy link
Copy Markdown

Reviewing your code

Verification Rules 2/2 met

Functional validation No results

Rules 2 passed 2 not applicable

✅ Internal artifact registries
✅ Repository license compliance

Auto-approval Not evaluated

For more verification details, comment gitar display:verbose.

Options

Auto-apply is off → Gitar will not commit updates to this branch.
Display: compact → Showing compact verification results.

Comment with these commands to change the behavior for this request:

Auto-apply Compact
gitar auto-apply:on         
gitar display:verbose         

Was this helpful? React with 👍 / 👎 | Gitar

@sophio-japharidze-sonarsource
sophio-japharidze-sonarsource deleted the cursor/agents-md-only-experiment-1989 branch November 9, 2026 13:05
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