AGENTS.md 와 CLAUDE.md 를 심볼릭 링크로 묶는 방법은 오늘도 통하지만, 이를 보증하는 문서는 어디에도 없다
두 프로그램에 규칙 문서 한 벌을 나눠 먹이는 심볼릭 링크 방법이 흔한 관행이 됐다. 그러나 링크가 동작하는 것은 어느 도구의 약속이 아니라 파일이 그 자리에 있어서이며, 폴더를 옮기면 절대 경로 링크는 끊긴다.
jangwook.net
Kim Jangwook
Personal technical notes on AI agents, automation, developer tools, and the process of building software.
Latest Notes
Recent writing by language
The root page stays intentionally small. Choose a language, then read the full archive and related posts there.
한국어
AI 에이전트, 자동화, 개발 도구, 소프트웨어 제작 과정을 한국어로 기록합니다.
클로드에서 CLAUDE.md 규칙이 닿는지는 파일 위치가 아니라 세션을 띄운 폴더가 결정한다
같은 규칙 문서를 쓰더라도 작업 세션을 어느 폴더에서 열어 주느냐에 따라 닿는 범위가 달라진다. 대화 한가운데에야 도착한 규칙은 처음부터 준 규칙의 절반만 받아들여졌다.
AGENTS.md를 CLAUDE.md에 연결하는 세 가지 방법과 감싼 한 줄의 함정
AGENTS.md를 CLAUDE.md로 끌어오는 공식 방법 세 가지를 실제로 돌려 비교한 결과, 세 방법은 같은 결과를 냈다. 대신 예시로 감싼 한 줄이 문서 전체를 아무 알림 없이 지워 버리는 함정이 확인됐다.
English
Personal notes on AI agents, automation, developer tools, and building software.
The symlink trick that shares AGENTS.md with CLAUDE.md works today, and no document promises it will work tomorrow
A popular way to share one rules file between two AI coding tools is a shortcut link, but no official document backs the trick, and file-system measurement shows absolute links break when a folder moves. This piece explains the evidence, its limits, and what to do about it.
CLAUDE.md in Claude Code: Whether a Rule Reaches the Model Depends on Where You Start the Session, Not Where the File Sits
A test with 60 runs shows that the same rules file can reach the AI helper from one folder but not from another, and a rules file handed over mid-conversation was followed only half the time. The launch folder decides the first part; the arrival time decides the second.
AGENTS.md reaches CLAUDE.md three ways, and one wrapped example line turns all of it off
Three official ways to connect AGENTS.md to CLAUDE.md all loaded the document in testing, with at most 122 tokens of difference. The actual risk is not the wiring but a single example line wrapped in a code block that quietly erases the whole document.
日本語
AIエージェント、自動化、開発ツール、ソフトウェア開発の記録です。
AGENTS.md をリンクで CLAUDE.md と共有する方法と、それを裏書きしない文書たち
二つのAIツールに一つのルール文書を読ませるリンク共有が、今日なぜ動くのかを実測でたどる。同時に、この置き方を保証する文書がどこにもないことも確かめる。
Claude CodeでCLAUDE.mdのルールが届くかはファイルの場所ではなくセッションの起動場所が決める
AIコーディング助手が規則文書を読み込むかどうかは、文書の置き場所ではなく作業を始めたフォルダで決まることを、60回の試行で確かめた記録である。作業の途中で届いたルールは、初めから手渡されたルールの半分しか守られなかった。
AGENTS.md を CLAUDE.md につなぐ三つの方法と、例示の一行が文書の読み込みを止める問題
三つの接続方法を実測したら結果は同じで、選ぶ基準は速さではなく環境の制約だった。本当の落とし穴は、例示の一行が文書の読み込みを静かに止めることにある。
简体中文
记录 AI 代理、自动化、开发工具和软件构建过程。
用符号链接让 AGENTS.md 和 CLAUDE.md 共用一份文档今天仍然有效，但没有任何文档为此提供保证
两种 AI 编程工具共用一份规则说明书的常用做法，目前只靠文件本身的运气在运转。本文讲清它在什么情况下会失灵，以及哪些部分这次没能核实。
规则文件能否被 Claude Code 读到,取决于会话从哪个文件夹启动,而不是规则放在哪里
CLAUDE.md 规则文件放的位置一样,会话启动的文件夹不一样,被读到的结果就完全不同。对话中途才被读到的规则文件,遵守率只有一半。
AGENTS.md 与 CLAUDE.md 的三种连接方法实测效果相同，真正的陷阱是被代码块包住的一行
让 AGENTS.md 进入 Claude Code 的三种官方做法，实测结果都一样，所以选择的标准不是快慢，而是你环境里的限制。真正要小心的，是一行被当作示例包进代码块的写法，它会让整份规则文档悄无声息地消失。