메타 설명: AGENTS.md 표준 가이드 — Cursor, GitHub Copilot, Claude Code 등 28개+ AI 도구가 공통으로 인식하는 설정 파일 작성법, 실제 사용 템플릿, 런타임 28% 단축 성능 수치, 안티패턴까지 한 번에 정리했습니다.AGENTS.md와 AI 코딩 도구 연결 다이어그램팀에 AI 코딩 도구가 두 개 이상 섞이면 진짜 문제가 생깁니다. Cursor 쓰는 개발자는 .cursorrules 관리하고, Claude Code 쓰는 개발자는 CLAUDE.md 업데이트하고, GitHub Copilot 쓰는 개발자는 또 copilot-instructions.md 따로 관리해요. 같은 프로젝트를 설명하는 파일이 세 개인 거죠. 어느 게 최신인지도 모르고.AGENTS.md는 이 문제를..

Cursor를 쓰면 .cursor/rules/에 규칙을 넣고, Claude Code를 쓰면 CLAUDE.md에 지침을 쓴다. 둘 다 "AI한테 이렇게 코딩해줘"를 전달하는 파일인데, 구조도 다르고 동작 방식도 꽤 다릅니다. 저도 처음엔 두 파일이 어떻게 다른지 정확히 몰라서 대충 비슷한 내용을 두 군데 복붙해뒀었는데, 그게 최선이 아니더라고요. 이 글에서는 Cursor Rules와 CLAUDE.md를 실제 파일 구조부터 동작 원리, 각각의 한계까지 비교해서 어떤 상황에 뭘 쓸지 정리해봤습니다.Cursor Rules와 CLAUDE.md 핵심 차이점 한눈에 보기 비교 인포그래픽 Cursor Rules란? .cursorrules vs .mdc 파일 차이부터Cursor IDE에서 AI 동작 방식을 커스터마이즈하..

.cursorrules 열심히 작성해서 쓰고 있다면, 지금 당장 확인할 게 있어요.2026년 기준 Cursor Agent 모드에서 구형 .cursorrules 파일은 규칙을 아예 무시합니다. 동일한 규칙 9개를 두 형식으로 테스트했을 때 구형 .cursorrules는 0/9 준수, 신형 .mdc 방식은 9/9 준수라는 결과가 나왔어요. 열심히 써둔 규칙이 Agent 모드에선 작동 안 하고 있을 수 있습니다.구형 .cursorrules vs 신형 .mdc — Agent 모드 준수율 비교 .cursorrules가 뭔지 먼저 짚고 가면Cursor AI가 코드를 생성하기 전에 참조하는 "프로젝트 지침서"예요. 프로젝트 루트에 파일 하나 두면 새 채팅 세션마다 "우리 프로젝트는 React 18, TypeScrip..