One AGENTS.md, every tool: the Claude Code symlink pattern

Claude Code의 symlink 패턴 활용법을 설명하는 글입니다.

이 글은 AGENTS.md 파일을 여러 도구에서 공유하는 방법과 Claude Code에 특화된 symlink 설정을 설명합니다. 대부분의 에이전트가 AGENTS.md를 원본으로 읽지만 Claude Code는 CLAUDE.md를 사용합니다. 이를 해결하기 위해 하나의 파일을 두 개의 이름으로 연결하는 symlink를 사용하여 버전 불일치를 방지하는 방법을 제시합니다. 추가적으로 Windows와 모노레포 환경에서의 주의사항도 다룹니다.

The article explains how to utilize symlink patterns for Claude Code with AGENTS.md.

This article describes how to share the AGENTS.md file across multiple tools while addressing the specific needs of Claude Code regarding symlinks. Most agents read AGENTS.md natively, but Claude Code reads CLAUDE.md. The solution is to create a symlink so that both names point to the same file, preventing version drift. Additionally, it discusses considerations for Windows and monorepo setups.