모든 AI 코딩 도구는 프로젝트 규칙이 담긴 Markdown 파일을 원합니다. 하지만 각각이 다른 Markdown 파일을 원합니다.

여러 AI 도구를 사용한다면 (대부분의 개발자가 그렇습니다), 이것은 빠르게 혼란스러워집니다. 필요한 파일과 각각에 무엇을 넣어야 하는지에 대한 결정적인 가이드입니다.

한눈에 보는 파일들

파일	도구	위치	범위
`AGENTS.md`	범용 (모든 도구)	프로젝트 루트	모든 AI 에이전트를 위한 공유 규칙
`CLAUDE.md`	Claude Code	프로젝트 루트	Claude 전용 지침
`.cursor/rules/*.md`	Cursor	`.cursor/rules/` 디렉토리	Cursor 전용 규칙
`.github/copilot-instructions.md`	GitHub Copilot	`.github/` 디렉토리	Copilot 전용 지침
`.windsurf/rules`	Windsurf	`.windsurf/` 디렉토리	Windsurf 전용 규칙
`JULES.md`	Google Jules	프로젝트 루트	Jules 전용 지침

AGENTS.md: 범용 표준

최적: 여러 AI 도구를 사용하는 팀, 오픈 소스 프로젝트

AGENTS.md는 우리가 가진 범용 표준에 가장 가깝습니다. 이제 60,000개 이상의 저장소에서 사용되며 Linux Foundation의 Agentic AI Foundation(MCP 및 goose와 함께)이 관리합니다.

모든 AI 도구가 알아야 할 공유 지침을 여기에 넣으세요:

프로젝트 구조 및 아키텍처
빌드 및 테스트 명령
코드 스타일 규약
일반적인 패턴과 안티 패턴
의존성 및 설정 단계

모든 주요 AI 코딩 도구가 AGENTS.md를 읽어서 프로젝트 AI 지침의 단일 진실 소스가 됩니다.

CLAUDE.md: Claude Code의 메모리

최적: Claude Code 사용자, Anthropic에 표준화하는 팀

CLAUDE.md는 모든 Claude Code 세션 시작 시 자동으로 읽힙니다. 메모리 지속성과 세션 컨텍스트 같은 Claude 전용 기능을 지원합니다.

CLAUDE.md 사용 목적:

Claude 전용 동작 조정
Claude Code만 지원하는 기능
Claude를 위한 AGENTS.md 재정의 또는 확장

권장 패턴: AGENTS.md의 공유 규칙, CLAUDE.md의 Claude 전용 추가 사항.

.cursorrules / .cursor/rules/: Cursor의 접근 방식

최적: Cursor 사용자, Cursor를 기본 IDE로 사용하는 팀

Cursor는 원래 단일 .cursorrules 파일을 사용했다가 더 세밀한 제어를 위해 .cursor/rules/ 디렉토리로 발전했습니다. 디렉토리의 각 파일은 Cursor가 적용하는 별도의 규칙입니다.

Cursor 규칙 사용 목적:

Cursor 전용 에이전트 동작
Cursor의 Composer 및 Agent 모드 규칙
파일 유형별 지침 (예: .tsx vs .py에 다른 규칙)

copilot-instructions.md: GitHub의 규약

최적: GitHub Copilot 사용자, GitHub 중심 워크플로우

GitHub Copilot은 프로젝트 수준 지침을 위해 .github/copilot-instructions.md를 읽습니다. GitHub의 .github/ 디렉토리에 구성을 넣는 규약을 따릅니다.

권장 설정

대부분의 프로젝트에서 최대 두 개의 파일이 필요합니다:

AI 도구 하나를 사용한다면:

해당 도구의 네이티브 파일만 사용하세요 (Claude Code는 CLAUDE.md, Cursor는 .cursor/rules/ 등).

여러 AI 도구를 사용한다면:

AGENTS.md --- 모든 공유 규칙 (아키텍처, 빌드 명령, 규약)
도구 전용 파일 --- 해당 도구에만 있는 기능만

구조 예시:

your-project/
  AGENTS.md              # 공유: 빌드 명령, 아키텍처, 규약
  CLAUDE.md              # Claude 전용: 메모리 설정, 도구 사용
  .cursor/rules/style.md # Cursor 전용: composer 동작
  .github/copilot-instructions.md  # Copilot 전용

규칙에 포함할 것

수천 개의 저장소 분석을 바탕으로, 가장 효과적인 지침 파일에는:

항상 포함:

프로젝트 빌드 및 실행 방법
테스트 실행 방법
주요 아키텍처 결정
코딩 스타일 설정

자주 유용한 것:

하지 말아야 할 것 (부정적 지침이 놀랍도록 잘 작동합니다)
파일 구조 설명
일반적인 디버깅 단계
의존성 관리 명령

건너뛸 것:

명백한 언어 기능
AI가 이미 아는 것
과도하게 상세한 규칙 (최소한으로 시작하고 필요에 따라 추가)

웹 컨텍스트로 AI 규칙 구축

좋은 AI 지침 파일을 작성하려면 종종 외부 문서, 스타일 가이드 또는 아키텍처 패턴을 참조해야 합니다. 바로 여기서 Markdown 형식의 웹 콘텐츠가 도움이 됩니다.

예를 들어, 프로젝트가 문서 페이지의 특정 API 패턴을 따른다면:

Save를 사용하여 해당 문서 페이지를 Markdown으로 변환
AGENTS.md에서 관련 섹션을 참조하거나 발췌
AI 코딩 도우미가 이제 전체 컨텍스트를 보유

프레임워크 문서, 스타일 가이드, 모범 사례 기사, Stack Overflow 솔루션에도 동일하게 적용됩니다. 깨끗한 Markdown은 당신과 AI 도구 모두가 가장 효과적으로 작업할 수 있는 형식입니다.

핵심 요점

AI 코딩 규칙 생태계는 아직 발전 중이지만 패턴은 명확합니다: 모두 Markdown입니다. 도구를 하나 사용하든 다섯 개를 사용하든, 프로젝트의 AI 지침은 버전 관리되고, 인간이 읽을 수 있고, 기계가 파싱할 수 있는 Markdown 파일에 있습니다.

범용 규칙을 위해 AGENTS.md로 시작하고, 필요에 따라 도구 전용 파일을 추가하고, 해결할 가치가 있는 반복 문제를 볼 때까지 모든 것을 최소한으로 유지하세요.

Save는 어떤 웹페이지든 깨끗한 Markdown으로 변환합니다 --- AI 코딩 도우미에 필요한 참조 자료와 문서 컨텍스트 구축에 완벽합니다. Save 무료로 사용해보기.