Repository navigation
chore: expose agent rules and skills to agy via AGENTS.md - #12187
Merged
Merged
Conversation
…/skills AGENTS.md is a relative symlink to CLAUDE.md and .agents/skills a relative symlink to ../.claude/skills, mirroring the existing .claude/commands link. The Antigravity CLI (agy 1.3.5) loads AGENTS.md as its workspace rule file and lists all ten project skills from .agents/skills (verified locally); Codex and the Copilot coding agent read AGENTS.md too. One source, no third file to keep in sync. A unit test pins both links (symlink, relative target, resolves to the Claude source). CLAUDE.md and the project guide document the bridge and say that Claude-specific tool wording applies to other agents by analogy. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GdMSqLR5ww4ji74EUSmk9M
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GdMSqLR5ww4ji74EUSmk9M
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
The relative symlinks, regression tests, and documentation are consistent, with no unresolved findings.
0 open findings
What changed in this PR
Exposes existing agent rules and skills to additional coding agents without duplicating their sources.
Changes:
- Adds relative symlink bridges for agent instructions and skills.
- Adds regression tests for link types, targets, and resolution.
- Documents the shared-source setup and records the change.
| File | Description |
|---|---|
| tests/unit/test_agent_instructions.py | Tests both agent bridge symlinks. |
| CLAUDE.md | Explains shared sources and editing guidance. |
| changelog.d/agents-md-bridge.md | Records support for additional agents. |
| agentic/docs/project-guide.md | Documents instruction and skill discovery paths. |
| .github/copilot-instructions.md | Adds the shared instruction-file pointer. |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
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.
Summary
AGENTS.md -> CLAUDE.mdand.agents/skills -> ../.claude/skills(both relative symlinks, mirroring the existing.claude/commands -> ../agentic/commands). The Antigravity CLI (agy), Codex, and the Copilot coding agent readAGENTS.md;agyreads skills from.agents/skills/. One source, no third file to sync.tests/unit/test_agent_instructions.pypins both links: still a symlink, relative target text, resolves to the Claude source.model: opusapplies to other agents by analogy), the agent instruction files inagentic/docs/project-guide.md, a pointer in.github/copilot-instructions.md, and a changelog fragment.The two symlinks were created with
ln -s, the one exception to the Edit/Write-only rule, because neither tool can create a symlink. Everything else was edited with Edit/Write.Side effects checked
.dockerignoreis an allowlist (*plus!api,!core, ...), so neither path enters an image; the only.gcloudignorelives underautomation/gcp/budget-guard/.AGENTS.mdor.agents/(ruff only reads*.py; the docs index drift check coversdocs/only).core.symlinksget a one-line text file, the same as the existing.claude/commandslink.Plan
N/A
Test plan
agy --mode plan -p ...in the worktree reportsAGENTS.mdas the loaded workspace rule file (first heading# CLAUDE.md) and lists all ten project skills from.agents/skills/.uv run pytest tests/unit/test_agent_instructions.py(32 passed)uv run ruff check .anduv run ruff format --check .uv run python -m tools.changelog check --base origin/main