Skip to content

chore: add CLAUDE.md symlinks for nested AGENTS.md - #550

Merged
ItamarZand88 merged 1 commit into
mainfrom
itamar/alien-633-load-nested-agentsmd-guidance-into-claude-code
Aug 31, 2026
Merged

ItamarZand88 merged 1 commit into
mainfrom
itamar/alien-633-load-nested-agentsmd-guidance-into-claude-code

Conversation

@ItamarZand88

Copy link
Copy Markdown
Contributor

Summary

Claude Code reads CLAUDE.md, not AGENTS.md. Only the repo root had one, so
the 28 nested AGENTS.md files below it never entered its context.

This change:

  • adds a relative CLAUDE.md -> AGENTS.md symlink beside each nested AGENTS.md
  • matches the symlink form already used at the repo root
  • changes no file content

Validation

  • readlink on all 28 returns the relative target AGENTS.md
  • cat crates/alien-core/CLAUDE.md returns the AGENTS.md text
  • git ls-files -s reports mode 120000 for all 28

Linear: ALIEN-633

Claude Code reads CLAUDE.md, not AGENTS.md, so the per-directory guidance in
this repo has never entered its context. Only the repo root had a CLAUDE.md
symlink; the 28 nested AGENTS.md files below it were unreachable.

Each new CLAUDE.md is a relative symlink to its sibling AGENTS.md, matching the
root. Claude Code loads them on demand when it reads files in that directory, so
crate-local rules apply where they belong.
@greptile-apps

greptile-apps Bot commented Aug 31, 2026

Copy link
Copy Markdown

Greptile Summary

Adds 28 nested CLAUDE.md symlinks so Claude Code can load the existing directory-specific AGENTS.md instructions.

  • Places each symlink beside its corresponding AGENTS.md.
  • Uses the relative target AGENTS.md consistently.
  • Changes no instruction content or runtime code.

Confidence Score: 5/5

The PR appears safe to merge because all added aliases resolve to their intended sibling instruction files and no runtime code is affected.

The changes consist exclusively of consistently targeted documentation symlinks, with no accepted correctness, security, build, or quality issues.

Important Files Changed

Filename Overview
client-sdks/CLAUDE.md Adds a valid same-directory symlink to the existing client SDK instructions.
crates/alien-core/CLAUDE.md Adds a valid same-directory symlink to the existing alien-core instructions.
examples/basic-worker-ts/CLAUDE.md Adds a valid same-directory symlink to the example's existing instructions.
packages/sdk/CLAUDE.md Adds a valid same-directory symlink to the existing SDK package instructions.

Reviews (1): Last reviewed commit: "chore: add CLAUDE.md symlinks beside eve..." | Re-trigger Greptile

@ItamarZand88
ItamarZand88 merged commit e583edf into main Aug 31, 2026
25 checks passed
@ItamarZand88
ItamarZand88 deleted the itamar/alien-633-load-nested-agentsmd-guidance-into-claude-code branch August 31, 2026 13:54
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