CLAUDE.md와 AGENTS.md 같이 쓰기

내용

❌ 흔한 실패
두 파일에 비슷한 내용을 각각 적어두다가, 한쪽만 고쳐서 서로 다른 말을 하게 됨

⚠️ 먼저 알아둘 것
Claude Code 는 AGENTS.md 를 직접 읽지 않습니다.
"공통 규칙은 AGENTS.md 참고" 라고 적어두는 것만으로는 아무 일도 일어나지 않습니다.

✅ 권장 방식
① AGENTS.md 를 원본으로 삼는다 (도구 중립이라 여러 도구가 함께 읽음)
② CLAUDE.md 첫 줄에 불러오기를 적는다

   @AGENTS.md

   ## Claude Code 전용
   슬래시 명령어 · Hooks · 스킬 배치처럼 이 도구에서만 의미 있는 내용

③ 같은 내용을 두 파일에 중복해서 적지 않는다

💡 심볼릭 링크(ln -s AGENTS.md CLAUDE.md)로도 되지만,
   윈도우는 관리자 권한이나 개발자 모드가 필요하니 @AGENTS.md 쪽이 편합니다.

💡 판단 기준 — 다른 AI로 옮겨도 그대로 유효한 내용이면 AGENTS.md,
그 도구에서만 의미 있는 내용이면 전용 파일입니다.

{{INPUT}}