2026년 8월 25일, Shopify CEO Tobi Lütke는 "AGENTS.md와 .agents/skills를 읽도록 바꿀 때까지 Shopify에서 Claude Code를 금지하는 것을 고려 중"이라고 올렸다. 이유는 취향이 아니라 운영상의 고장 모드였다. "CLAUDE.md만 읽겠다고 고집하면, 팀원들이 서로 다른 도구를 쓸 때 스플릿 브레인 문제가 생긴다." (출처)
이후 보도로 드러난 메커니즘은 적어둘 가치가 있다. 수천 명이 작업하는 모노레포에서는 어떤 디렉터리든 결국 한쪽 지시 파일만 있고 다른 쪽은 없는 상태가 된다. 빠진 쪽을 읽는 에이전트는 "로보토미 상태"로 돌아간다. Shopify는 자동화로 그 틈을 메우고 있는데, Lütke는 그것을 "멍청한 복잡성 세금"이라고 불렀다. Anthropic은 재귀적 AGENTS.md 지원 요청을 "계획 없음"으로 닫았다가, AGENTS.md를 더 쓰기 쉽게 만들겠다고 밝혔다. (Shopifreaks, explainx)
논평 대부분은 이것을 표준 싸움으로 다뤘다. Linux Foundation 산하 Agentic AI Foundation이 관리하는 AGENTS.md(Shopify는 골드 멤버) 대 벤더 고유의 CLAUDE.md. 그 프레임은 맞지만 불완전하다. Shopify를 문 것은 파일명보다 오래되고 더 일반적인 것이다.
2026년 2월에 나온 연구는 에이전트형 코딩 도구를 쓰는 GitHub 리포지토리 2,926개를 분석해 설정 메커니즘을 분류했다. (arXiv 2602.14690) 여기서 중요한 숫자는 셋이다.
연구는 또 Cursor가 .cursorrules를 폐기하고 AGENTS.md를 권장하게 된 것, copilot-instructions.md로 시작한 리포지토리가 나중에 CLAUDE.md나 AGENTS.md를 추가하는 일이 잦다는 것(Copilot이 전부 읽을 수 있는데도)을 기록한다. 팀은 한 파일로 수렴하지 않는다. 파일을 축적한다.
여기에 연구가 재지 않은 두 번째 축을 더한다. 머신이다. 개발자마다 그 파일들의 사본이 있고, 사용자 레벨 사본(~/.claude, ~/.codex, ~/.cursor)이 있고, Agent Skills 표준이 .agents/skills나 .claude/skills에 두는 것이 있다. 표준 자체는 좋은 일이다. SKILL.md는 Claude Code와 GitHub Copilot이 구현했고 Cursor와 Gemini CLI가 채택해서 같은 스킬 폴더가 도구 사이를 오갈 수 있다. 하지만 "그대로 동작한다"가 설명하는 것은 포맷이지 사본이 아니다. 이식 가능한 파일도 여전히 복사되는 파일이다.
Shopify의 고장을 만드는 순서는 이렇고, 벤더가 둘일 필요가 없다.
문제의 전부는 4다. 1에서 3은 평범한 엔지니어링이다. 내일 업계가 AGENTS.md로 표준화되고 Claude Code가 그것을 네이티브로 읽어도, 2는 디렉터리와 머신을 가로질러 계속 일어나고, 4는 계속 조용히 일어난다. 파일명 하나 안에서 스플릿 브레인이 난다.
표준화 작업은 필요하다. 곱셈 계수를 하나 지운다. 하지만 메커니즘은 지우지 못한다.
정직한 답은 둘이고, 둘 다 오늘 아무것도 사지 않고 쓸 수 있다.
사본을 손으로 고치지 않는다. 규칙마다 정본을 하나 두고 도구별 파일은 전부 거기서 생성한다. 최소 버전은 심볼릭 링크다(AGENTS.md → CLAUDE.md. Lütke의 글이 올라온 주에 많은 팀이 한 일). 다음 단계는 YAML이나 Markdown 하나에서 AGENTS.md, CLAUDE.md, copilot-instructions.md, skills 디렉터리를 써내는 생성 스크립트다. 규칙은 단순하다. 생성된 파일은 사람이 편집하지 않는다. 바꾸고 싶으면 정본을 바꾸고 다시 생성한다.
그래도 손댄 것을 탐지한다. 수정이 급하고 정본이 딴 데 있으면 사람은 생성 파일을 고친다. 그러니 CI와 주기 실행으로 트리 안의 모든 컨텍스트 파일과 SKILL.md를 해시하고, 같아야 하는 것끼리 묶고, 갈라진 것을 diff와 함께 보고하는 검사를 돌린다. 우리는 정확히 이 스캔을 디렉터리 트리 전체에 대해 하는 작은 오픈소스 도구 agent-drift를 공개했다. 서비스가 필요 없고, 파일을 읽어서 같은 문서의 어느 사본이 갈라졌는지 출력한다. 요점은 도구가 아니다. 드리프트가, 잘못된 코드를 내보낸 에이전트를 통해 발견되는 놀라움이 아니라, 보고되는 이벤트가 된다는 것이다.
이 둘을 하면 파일명 문제는 본래 있어야 할 자리, 즉 생성기가 처리하는 호환성 세부사항이 되고, CEO가 도구 금지를 거론할 이유가 아니게 된다.
Agent Skills 표준과 AGENTS.md는 같은 방향을 민다. 지시 파일을 개인 메모가 아니라 버전 관리되고 공유되고 검사 가능한 자산으로 다루는 방향이다. 대부분의 팀에 아직 빠진 것은 다른 모든 공유 자산이 이미 갖고 있는 운영 층이다. 코드에는 리포지토리와 리뷰가 있다. 시크릿에는 볼트와 로테이션이 있다. 에이전트용 지시 파일에는 대개 복사 명령밖에 없다.
untactit이 만드는 것이 이 층이다. 스킬·메모리·지시 파일의 라이브러리를 하나 두고, 변경은 사람이 승인하고, 승인된 것을 연결된 모든 도구와 머신에 아무도 사본을 손으로 고치지 않은 채 밀어내고, 어느 사본이 언제 갈라졌는지 드리프트 탐지가 보고한다. 판단은 사람이, 전파는 무접촉이다. 지금 얼리 액세스이고 untactit.com에서 무료로 시작할 수 있다. 다만 위의 두 실천은 그 자체로 성립한다. 먼저 그것을 도입하라. 그 뒤에 우리가 필요 없더라도, 스플릿 브레인은 이미 사라져 있다.
출처: Tobi Lütke X 게시글, 2026-08-25 · Configuring Agentic AI Coding Tools: An Exploratory Study (arXiv 2602.14690) · Agentic AI Foundation · Agent Skills 표준 · Shopifreaks