Repository navigation
Add AGENTS.md (CLAUDE.md symlink) and build / plugin-e2e skills (.agents/skills symlink) - #261
Merged
Merged
Conversation
wu-sheng
force-pushed
the
docs/agents-md-and-skills
branch
from
October 18, 2026 09:03
837c975 to
b1d672e
Compare
wu-sheng
changed the title
…kills AGENTS.md is the guide for coding agents: the repository layout, the Go version policy, how to build, test, and lint, the rules that follow from how the agent copies and rewrites plugin code (instrument selection, the direct-import rule for copied files, native mirrors, receiver-only matching, version-split plugins), the plugin test harness semantics, and the changelog, docs, and CI conventions. CLAUDE.md is a symlink to it. The build skill builds the agent, runs tests and lint, checks the Go 1.26 floor, and compiles an instrumented application to verify copied plugin code at both ends of a version range. The plugin-e2e skill runs plugin scenarios and the e2e suite locally and maps common failures to causes. Claude worktrees and local settings are ignored. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ej1HubxqebgChKygA5TTHP
wu-sheng
force-pushed
the
docs/agents-md-and-skills
branch
from
October 18, 2026 09:50
b1d672e to
ee72dde
Compare
mrproliu
approved these changes
Oct 18, 2026
mrproliu
approved these changes
Oct 18, 2026
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
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.
Adds guidance for coding agents, based on what PR #260 (the Go 1.26 floor and plugin range refresh) needed to get right.
What's added
AGENTS.mdcovers:GOWORK=off, exactframework:module paths,excepted-file,toolkit);VERSIONfile, and build-cache pollution from-toolexecbuilds.CLAUDE.mdis a symlink toAGENTS.md, so both stay identical..claude/skills/buildbuilds the agent, runs tests and lint (golangci-lint v2.15.0), checks the Go 1.26 floor, and compiles an instrumented application to verify copied plugin code at both ends of a version range..claude/skills/plugin-e2eruns plugin scenarios and the e2e suite locally the way CI does, narrows a run to some versions, and maps common build, dependency, runtime, and validation failures to their causes..agents/skillsis a symlink to.claude/skills, so other agents also discover the same skills. Verified with the Codex CLI: it listsbuildandplugin-e2ewith the symlink and none without it..gitignoreignores.claude/worktrees/and.claude/settings.local.json.Markdown is excluded from the license header check, so none of the new files need a header. The license-eye version pinned in CI (
apache/skywalking-eyes@9bd5feb) recurses forever on directory symlinks, so.licenserc.yamlignores.agents/skills. Without that, the check fails withfatal error: stack overflow. This was reproduced with that exact license-eye build, and the check passes with the ignore entry.Review
Four rounds of read-only review by an external model checked the links, every factual statement in
AGENTS.mdagainst the source, and every skill command. Each finding was fixed, and the final round confirmed it with no remaining findings.🤖 Generated with Claude Code
https://claude.ai/code/session_01Ej1HubxqebgChKygA5TTHP