Skip to content

Remove CLAUDE.md symlink - #58

Merged
jmarek41 merged 1 commit into
mainfrom
housekeep/remove-claude-md-symlink
Oct 23, 2026
Merged

jmarek41 merged 1 commit into
mainfrom
housekeep/remove-claude-md-symlink

Conversation

@jmarek41

@jmarek41 jmarek41 commented Oct 23, 2026 •

Copy link
Copy Markdown
Member

Claude Code now reads AGENTS.md as project instructions on its own (v2.1.277+, docs), so the CLAUDE.md → AGENTS.md symlink is no longer needed. The docs list deleting it as an option; the content loads once either way.

  • Delete the CLAUDE.md symlink.
  • AGENTS.md intro: drop the symlink note and warn that a CLAUDE.md or CLAUDE.local.md next to it makes Claude Code skip AGENTS.md (default claude-md-or-agents-md behavior). CLAUDE.local.md stays in .gitignore, but being ignored doesn't stop it from loading.
  • README.md: the coding-agents line no longer mentions the symlink.

Applied the same change in irozhlas-ios. Touches different lines than #57 (only the AGENTS.md intro line), so the two shouldn't conflict.

Claude Code reads AGENTS.md natively since v2.1.277, so the symlink
is redundant. Document that a CLAUDE.md or CLAUDE.local.md next to
AGENTS.md makes Claude Code skip it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@jmarek41
jmarek41 requested a review from a team as a code owner October 23, 2026 11:53
@jmarek41
jmarek41 merged commit 81153b9 into main Oct 23, 2026
@jmarek41
jmarek41 deleted the housekeep/remove-claude-md-symlink branch October 23, 2026 11:55
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