Adopt AGENTS.md for agent guidance#620
Merged
Merged
Conversation
Agent instructions need a vendor-neutral entrypoint so Codex, Claude, and other tooling can share the same repository guidance without treating Claude-specific paths as canonical. The previous setup kept the primary instructions and repo-local skill under CLAUDE.md and .claude/skills, which made compatibility paths look like the source of truth. This moves the preserved instruction content to AGENTS.md, leaves CLAUDE.md as a symlink, moves the devtools skill to .agents/skills, and keeps .claude/skills as a symlink for Claude compatibility. The obsolete Claude launch configuration is removed, and the lint configuration now recognizes the new agent-skill location plus the compatibility symlink.
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request renames CLAUDE.md to AGENTS.md, updates markdown linting and file type checking rules to accommodate the new .agents and .claude directories, and removes the devtools SKILL.md file. The review feedback suggests adding a note in AGENTS.md to clarify that the macOS-specific sysctl command for clang-tidy should be replaced with nproc on Linux environments.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
MasterJH5574
approved these changes
Jun 13, 2026
haok1402
pushed a commit
to mlc-ai/pith-train
that referenced
this pull request
Jun 13, 2026
Agent guidance now lives in vendor-neutral locations so Claude Code and other assistants can share one set of repo instructions, rather than treating Claude-specific paths as canonical. AGENTS.md holds the content (moved from CLAUDE.md) and the skills move to .agents/skills. Backwards compatibility is preserved with no behavior change: CLAUDE.md is now a thin `@AGENTS.md` import and .claude/skills is a symlink to ../.agents/skills, so existing Claude Code paths and tooling keep resolving. Mirrors the layout adopted in apache/tvm-ffi#620.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Agent instructions should live in vendor-neutral locations so different coding assistants can share the same repo guidance without making Claude-specific paths canonical. The existing content already describes the right workflows, but it was rooted under CLAUDE.md and .claude/skills.
This moves the preserved instruction content to AGENTS.md, keeps CLAUDE.md as a compatibility symlink, and makes .agents/skills the canonical repo-local skill directory. The Claude skills path now points back to .agents/skills, the obsolete Claude launch config is removed, and lint configuration is updated for the new agent-skill location and compatibility symlink.