Track CLAUDE.md as a symlink to AGENTS.md - #292
Merged
Merged
Conversation
Commit 262a575 untracked CLAUDE.md on the premise that Ion manages it, but only 'ion init' creates the link and nothing in the harness runs it. So every clone since 2026-04-30 loads no project instructions in Claude Code sessions (Codex reads AGENTS.md natively and was unaffected). Track the symlink itself: every clone and worktree gets it by construction, with no install step. Drop the stale gitignore line and update the AGENTS.md convention note. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
1 participant
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.
Why
Commit 262a575 (Apr 30) untracked
CLAUDE.mdon the premise that Ion manages it. The premise does not hold: onlyion initcreates the link, and nothing in the harness —make skills,/onboard, CI — ever runs it. Since then every fresh clone has noCLAUDE.md, so Claude Code sessions load zero project instructions (verified: the memory walk readsCLAUDE.md/CLAUDE.local.mdonly). Codex readsAGENTS.mdnatively and was unaffected — challenge teams on Claude Code were not.What
CLAUDE.mdas a symlink (mode 120000) toAGENTS.md— every clone and worktree gets it by construction, no install step.CLAUDE.mdgitignore line.Ion stays compatible:
ion initrecognizes a symlinkedCLAUDE.mdas already managed.Note for Windows checkouts
Without symlink support (
core.symlinks=false), git materializesCLAUDE.mdas a plain file containingAGENTS.md— harmless but inert. Native-Windows users already set up Git for Windows formake; enabling Developer Mode orgit config core.symlinks truerestores the real link.🤖 Generated with Claude Code