fix: replace CLAUDE.md symlink with an @AGENTS.md import - #49
Merged
Merged
Conversation
CLAUDE.md was a git symlink to AGENTS.md. GitHub Actions downloads a
composite action's repo as an archive (not a git clone) when it's
referenced via `uses: trobz/deploy.py@<tag>`, and archive extraction
on the hosted runner intermittently fails to materialize that
symlink, aborting the job before any step runs
("Could not find file .../CLAUDE.md" — see
odoo-changes-analyzor run 34221192344).
Claude Code's memory files support `@path` imports, so a plain
CLAUDE.md containing `@AGENTS.md` is loaded identically to the
symlinked version, without shipping a symlink in the tagged archive.
This also drops the Windows caveat (symlinks there need admin/dev
mode) that the import syntax doesn't have.
1 task
trisdoan
approved these changes
Sep 9, 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
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.
Summary
CLAUDE.mdwas a git symlink toAGENTS.md. GitHub Actions downloads a composite action's repo as an archive (not a git clone) when referenced viauses: trobz/deploy.py@<tag>, and archive extraction on the hosted runner has an intermittent regression that fails to materialize that symlink — aborting the job before any step runs withCould not find file '.../CLAUDE.md'(seen on odoo-changes-analyzor run 34221192344).odoo-changes-analyzorworked around this by pinning totrobz/deploy.py@v0.6.1(17+ releases behind), because that tag's action package happened to already be cached on runners before the regression started appearing.@pathimports, soCLAUDE.mdis now a plain file containing@AGENTS.mdinstead of a symlink. Claude Code loads it identically, but the tagged archive no longer contains a symlink, so the runner extraction bug can't be triggered. As a bonus this also drops the Windows caveat that real symlinks need admin/dev mode.Test plan
CLAUDE.mdis now mode100644(git ls-files -s CLAUDE.md), not120000odoo-changes-analyzor's deploy workflow off thev0.6.1pin once this is released, and confirm the composite action download succeeds