chore: add CLAUDE.md as symlink to AGENTS.md - #65
Conversation
Claude Code auto-reads CLAUDE.md at session start. Symlinking to AGENTS.md means Claude Code reads the shared conventions directly, no @import indirection needed. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
umm-actually re-reviewed at 1 new finding(s) posted (1 tracked finding(s) across all runs). umm-actually · deepseek/deepseek-v4-flash-0731 |
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
![umm-actually[bot]](https://avatars.githubusercontent.com/in/4233716?s=60&v=4){kind=small}
| `git config core.symlinks true` before cloning, or re-clone after setting | ||
| it — otherwise Git checks out symlinks as plain text files containing the | ||
| target path. |
There was a problem hiding this comment.
Enable core.symlinks with --global before cloning
Low severity · correctness · high confidence
The instruction git config core.symlinks true before cloning cannot do what it promises: before a clone exists there is no repository to write the config into, so the command errors with 'fatal: not in a git directory' when run in the intended clone directory, and if run inside an existing repo it only configures that repo, not the new clone. A following clone therefore keeps the default false, and CLAUDE.md still checks out as a plain text file — contradicting the note's stated fix.
Failure scenario: A Windows user runs the documented command in their clone target directory: git fails with 'fatal: not in a git directory', the clone proceeds with core.symlinks=false, and CLAUDE.md checks out as a text file containing 'AGENTS.md', defeating the note's purpose.
Suggested fix
Use the global scope so the setting applies to the new clone: `git config --global core.symlinks true` (and note that Windows also needs Developer Mode or an elevated shell for symlink creation to succeed).umm-actually · deepseek/deepseek-v4-flash-0731
1 participant
Summary
CLAUDE.mdas a symlink toAGENTS.md— Claude Code auto-readsCLAUDE.mdat session start, so this eliminates the@AGENTS.mdimport indirectionCLAUDE.mdpreviously; other repos are switching from a redirect file to a symlinkTest plan
ls -la CLAUDE.mdshowsCLAUDE.md -> AGENTS.md🤖 Generated with Claude Code