시스메이커코딩 못해도 AI로 자동화 시스템 만드는 법
전체 모델 출시 AI 도구 에이전트 AI 비즈니스 기술·논문 빌더의 작업실
AI 비즈니스

쇼피파이 CEO, 규칙 파일 하나로 클로드 코드 금지 검토

AGENTS.md를 안 읽는다는 이유 — 에이전트 시대의 진짜 쟁점은 규칙의 정본이다

쇼피파이(Shopify)의 토비 뤼케(Tobi Lütke) 최고경영자가 8월 25일 자신의 엑스(X) 계정에 클로드 코드(Claude Code)의 사내 사용 금지를 검토 중이라고 적었다. 성능도 가격도 이유가 아니었다. 문제는 규칙 파일 이름 하나였다. 이 글은 조회 200만 회를 넘기며 개발자 커뮤니티의 논쟁으로 번졌다.

무슨 일인가 / 배경

뤼케의 주장은 이렇다. 클로드 코드가 CLAUDE.md만 읽겠다고 고집하는 탓에, 팀원마다 다른 코딩 에이전트를 쓰는 조직에서는 지시가 둘로 갈리는 이른바 '분열된 두뇌' 문제가 생긴다는 것이다. 여러 도구가 공통으로 참조하는 AGENTS.md.agents/skills 폴더를 함께 읽어주면 끝날 일을 굳이 어렵게 만든다는 지적이다.

"심볼릭 링크로 해결하면 되지 않느냐"는 반응이 쏟아지자 그는 방법을 몰라서가 아니라고 답했다. 규칙 파일은 디렉터리 트리를 따라 재귀적으로 적용되는데, 개발자 수천 명이 하나의 모노레포를 공유하는 환경에서는 어느 한 디렉터리에서 두 파일 중 하나가 빠지는 사고가 반드시 일어난다는 것이다. 규모가 커질수록 '잘 챙기면 된다'는 식의 수작업 규약은 무너진다는 이야기다.

앤트로픽(Anthropic) 쪽 반응도 빠르게 나왔다. 클로드 코드 팀의 타리크는 답글에서 클로드 코드를 더 자유롭게 뜯어고칠 수 있도록 만드는 작업을 진행 중이며, AGENTS.md를 쓰거나 시스템 프롬프트를 손보는 일이 쉬워질 것이라고 밝혔다. 그는 앞서 7월에도 최신 모델용 시스템 프롬프트를 약 80% 덜어냈다는 글을 공개한 바 있다.

핵심 짚어보기

표면은 파일 이름 싸움이지만 실제 쟁점은 '규칙의 정본을 누가 소유하는가'다. 도구가 자기 이름이 붙은 파일만 읽으면 규칙은 도구 수만큼 복제되고, 복제된 문서는 시간이 지나면 반드시 어긋난다. 반대로 중립적인 이름 하나로 모아두면 도구를 갈아타도 조직이 쌓은 작업 지식은 그대로 남는다.

한 가지 더 짚을 대목은 이 불만이 나온 위치다. 도구를 못 다루는 사람이 아니라, 수천 명 규모의 개발 조직을 굴리는 쪽에서 나왔다. 에이전트를 여러 개 쓰는 단계에 접어들면 '어느 모델이 더 똑똑한가'보다 '규칙을 한 곳에 둘 수 있는가'가 운영 비용을 가른다.

1인기업 실전 적용 포인트

  • 규칙 정본을 하나로 정하라. AGENTS.md를 원본으로 쓰고 CLAUDE.md는 링크나 자동 생성물로 두면, 쓰는 도구를 바꿔도 규칙을 다시 쓸 일이 없다.
  • 지금 규칙 파일이 두 개 이상이라면 오늘 안에 어느 쪽이 최신인지 확인하라. 실무 사고는 파일이 없을 때가 아니라 '둘 다 있는데 내용이 다를 때' 난다.
  • 규칙은 프로젝트 루트에 모으고 하위 폴더에는 흩지 마라. 재귀 적용 구조에서 하위 폴더 규칙은 빠뜨리기 쉽고, 빠졌다는 사실조차 알아채기 어렵다.
  • 규칙을 '이 도구의 문법'이 아니라 '우리 작업 절차'로 써라. 실행 명령 목록·금지 사항·검수 기준은 어떤 에이전트에 붙여도 그대로 쓰인다.

전망 / 주의점

실제 금지로 이어질지는 미지수다. 뤼케의 글은 결정 통보라기보다 공개 압박에 가깝고, 앤트로픽도 곧바로 대응을 예고했다. 다만 이 논쟁의 승패와 무관하게, 규칙을 한 파일로 모아두는 쪽이 언제나 이득이라는 사실은 변하지 않는다. 혼자 일하는 환경이라도 6개월 뒤의 나는 남이다. 규칙이 도구별로 흩어져 있다면 표준이 정해지기를 기다릴 게 아니라, 먼저 정본을 만들고 나머지를 복사본으로 격하시키는 편이 빠르다.

출처: 해커뉴스 (https://twitter.com/tobi/status/2092259436538495186)
#쇼피파이#클로드코드#AGENTS.md#개발문화#1인기업

이 시스템이 실제로 돌아가는 모습은 유튜브에서 공개 중입니다.

채널 보기 ↗
STORE

🤖 이 기사, 사람이 쓰지 않았습니다

수집부터 발행까지 파이프라인이 해냈고, 지금 읽으신 기사가 그 증거입니다. 이 시스템을 키트로 판매합니다.

← 뉴스 전체 보기