Skip to content

chore: add AGENTS.md symlink#9094

Merged
jdx merged 1 commit intomainfrom
codex/add-agents-symlink
Apr 15, 2026
Merged

chore: add AGENTS.md symlink#9094
jdx merged 1 commit intomainfrom
codex/add-agents-symlink

Conversation

@jdx
Copy link
Copy Markdown
Owner

@jdx jdx commented Apr 15, 2026

Summary

  • Add AGENTS.md as a symlink to CLAUDE.md so agent-oriented tooling can discover the existing repository instructions without duplicating them.

Validation

  • Commit hook passed: prettier, cargo-fmt, cargo-check, shellcheck, shfmt, pkl, taplo, lua-check, stylua, actionlint, markdownlint, schema.

Note

Low Risk
Low risk: adds a single documentation/discovery file and does not change runtime code or behavior.

Overview
Adds AGENTS.md containing a reference to CLAUDE.md to make existing repository instructions discoverable to agent-oriented tooling without duplicating content.

Reviewed by Cursor Bugbot for commit 0790b0f. Bugbot is set up for automated code reviews on this repo. Configure here.

@jdx jdx marked this pull request as ready for review April 15, 2026 00:30
@jdx jdx merged commit 63340b4 into main Apr 15, 2026
21 of 22 checks passed
@jdx jdx deleted the codex/add-agents-symlink branch April 15, 2026 00:30
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 15, 2026

Greptile Summary

Adds AGENTS.md as a relative symlink (git mode 120000) pointing to CLAUDE.md at the repository root, allowing agent-oriented tooling (e.g. Codex, Gemini, etc.) to discover the existing instructions without duplicating content. The symlink target is verified to exist and the relative path resolves correctly since both files live in the same directory.

Confidence Score: 5/5

This PR is safe to merge — it is a single-file symlink addition with no logic changes.

The change is minimal (one symlink), the target file exists and resolves correctly, no code paths are affected, and the PR title follows the required conventional commit format.

No files require special attention.

Important Files Changed

Filename Overview
AGENTS.md New symlink (mode 120000) pointing to CLAUDE.md in the same directory; target file verified to exist as a regular file.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["AGENTS.md (symlink, mode 120000)"] -->|resolves to| B["CLAUDE.md (regular file, mode 100644)"]
    B --> C["Repository instructions for AI agents & tooling"]
Loading

Reviews (1): Last reviewed commit: "chore: add AGENTS.md symlink" | Re-trigger Greptile

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request adds an AGENTS.md file that references CLAUDE.md. The review feedback suggests generalizing the content within CLAUDE.md to be agent-agnostic or restructuring the files to better support a broader range of agent-oriented tools, as the current instructions are specific to Claude Code.

Comment thread AGENTS.md
@@ -0,0 +1 @@
CLAUDE.md No newline at end of file
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

While adding AGENTS.md for broader agent discovery is a good improvement, the content it points to (CLAUDE.md) contains several instructions and branding specific to Claude Code (e.g., the header and the specific attribution requirement in the 'GitHub Interactions' section). To better support general 'agent-oriented tooling' as intended, consider generalizing the instructions in CLAUDE.md to be agent-agnostic, or alternatively, make AGENTS.md the primary generic file and have CLAUDE.md symlink to it.

@github-actions
Copy link
Copy Markdown

Hyperfine Performance

mise x -- echo

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.11 x -- echo 24.3 ± 0.5 23.3 26.6 1.00
mise x -- echo 25.3 ± 0.6 23.9 28.5 1.04 ± 0.03

mise env

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.11 env 23.8 ± 0.7 22.6 28.0 1.00
mise env 24.9 ± 0.6 23.6 27.4 1.05 ± 0.04

mise hook-env

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.11 hook-env 24.5 ± 0.5 23.5 27.0 1.00
mise hook-env 25.5 ± 0.6 24.0 28.0 1.04 ± 0.03

mise ls

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.11 ls 21.6 ± 0.5 20.5 25.8 1.00
mise ls 22.7 ± 0.5 21.1 25.3 1.05 ± 0.04

xtasks/test/perf

Command mise-2026.4.11 mise Variance
install (cached) 155ms 155ms +0%
ls (cached) 81ms 81ms +0%
bin-paths (cached) 86ms 86ms +0%
task-ls (cached) 782ms 783ms +0%

mise-en-dev added a commit that referenced this pull request Apr 15, 2026
### 🚀 Features

- **(npm)** use --min-release-age for npm 11.10.0+ supply chain
protection by @webkaz in [#9072](#9072)
- **(registry)** add openfga by @mnm364 in
[#9084](#9084)
- **(task)** allow to set confirmation default by @roele in
[#9089](#9089)
- support os/arch compound syntax in tool os filtering by @RobertDeRose
in [#9088](#9088)

### 🐛 Bug Fixes

- **(activate)** export __MISE_EXE and resolve bare ARGV0 to absolute
path by @fru1tworld in [#9081](#9081)
- **(install)** support aliased installs sharing a backend by @jdx in
[#9093](#9093)
- **(shim)** use which_no_shims when resolving mise binary in reshim and
doctor by @kevinswiber in [#9071](#9071)
- filter empty segments in colon-separated env var parsing by @baby-joel
in [#9076](#9076)

### 📚 Documentation

- fix wrong file reference to forgejo backend implemenation by @roele in
[#9090](#9090)
- fix cli token command for token resolution by @roele in
[#9077](#9077)

### 📦 Registry

- add trzsz-go
([aqua:trzsz/trzsz-go](https://github.com/trzsz/trzsz-go)) by
@ZeroAurora in [#9083](#9083)
- add copilot
([aqua:github/copilot-cli](https://github.com/github/copilot-cli)) by
@risu729 in [#9082](#9082)

### Chore

- add AGENTS.md symlink by @jdx in
[#9094](#9094)

### New Contributors

- @kevinswiber made their first contribution in
[#9071](#9071)
- @webkaz made their first contribution in
[#9072](#9072)
- @RobertDeRose made their first contribution in
[#9088](#9088)

## 📦 Aqua Registry Updates

#### New Packages (7)

-
[`IBM-Cloud/ibm-cloud-cli-release`](https://github.com/IBM-Cloud/ibm-cloud-cli-release)
- [`max-sixty/worktrunk`](https://github.com/max-sixty/worktrunk)
- [`micelio.dev/hif`](https://github.com/micelio.dev/hif)
- [`pgplex/pgschema`](https://github.com/pgplex/pgschema)
-
[`rose-pine/rose-pine-bloom`](https://github.com/rose-pine/rose-pine-bloom)
- [`santosr2/TerraTidy`](https://github.com/santosr2/TerraTidy)
- [`trzsz/trzsz-go`](https://github.com/trzsz/trzsz-go)

#### Updated Packages (3)

- [`mvdan/sh`](https://github.com/mvdan/sh)
- [`rvben/rumdl`](https://github.com/rvben/rumdl)
- [`temporalio/temporal`](https://github.com/temporalio/temporal)
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.

1 participant