chore: symlink agents.md -> claude.md

[NathanFlurry]

No description provided.

[railway-app]

🚅 Deployed to the rivet-pr-3931 environment in rivet-frontend

Service	Status	Web	Updated (UTC)
frontend-inspector	✅ Success (View Logs)	Web	Jan 16, 2026 at 3:37 am
frontend-cloud	✅ Success (View Logs)	Web	Jan 16, 2026 at 3:37 am
website	🕒 Building (View Logs)	Web	Jan 16, 2026 at 3:36 am

[NathanFlurry]

• chore: symlink agents.md -> claude.md #3931 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add the label merge-queue to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[graphite-app]

Merge activity

• Jan 16, 3:36 AM UTC: NathanFlurry added this pull request to the Graphite merge queue.
• Jan 16, 3:37 AM UTC: CI is running for this pull request on a draft pull request (#3932) due to your merge queue CI optimization settings.
• Jan 16, 3:37 AM UTC: Merged by the Graphite merge queue via draft PR: #3932.

[claude]

Pull Request Review

Summary

This PR creates symlinks from AGENTS.md to CLAUDE.md to provide alternative naming for the same documentation file. However, there is a critical bug in the implementation.

---

🚨 Critical Issue

Incorrect symlink target in examples/AGENTS.md

The symlink at examples/AGENTS.md points to CLAUDE.md (relative path in the same directory), but:

• examples/CLAUDE.md is a different file with example-specific guidelines
• examples/AGENTS.md should point to the root CLAUDE.md file instead

Current behavior:

examples/AGENTS.md -> CLAUDE.md  # Points to examples/CLAUDE.md (wrong!)

Expected behavior:

examples/AGENTS.md -> ../CLAUDE.md  # Points to root CLAUDE.md (correct)

Evidence:

• /home/runner/work/rivet/rivet/CLAUDE.md starts with "# CLAUDE.md" and contains project-wide conventions
• /home/runner/work/rivet/rivet/examples/CLAUDE.md starts with "# examples/CLAUDE.md" and contains example-specific guidelines
• Reading examples/AGENTS.md currently returns the examples-specific content, not the root CLAUDE.md content

---

✅ What Works

Root-level symlink (AGENTS.md): Correctly points to CLAUDE.md in the same directory.

---

🔧 Required Fix

Change the symlink target in examples/AGENTS.md:

cd examples
rm AGENTS.md
ln -s ../CLAUDE.md AGENTS.md

Or if you want to point to the examples-specific CLAUDE.md (which seems unlikely based on the PR title), please clarify the intent.

---

Additional Observations

1. Symlink compatibility: Symlinks work fine in Git and on Unix-like systems, but consider whether Windows users might encounter issues if they don't have symlink support enabled.

2. Purpose clarity: The PR description is empty. Consider documenting why AGENTS.md is being added as an alias. Is this for compatibility with AI coding tools that look for AGENTS.md specifically?

3. Consistency: Only two locations have the symlink. If the goal is to provide AGENTS.md as an alternative name project-wide, verify there aren't other locations where CLAUDE.md exists that also need the symlink.

---

Recommendation

Do not merge until the examples/AGENTS.md symlink is corrected to point to ../CLAUDE.md.