Tools mentioned in this article
Open the browser-based tool while you read and try the workflow immediately.
Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini CLI ― AI 코딩 도구가 늘어날수록 골치 아파지는 것이 “프로젝트 규칙을 어느 파일에 쓸 것인가” 문제입니다. AI Rules 생성기는 폼 한 번의 입력으로 주요 도구 6종의 규칙 파일을 한꺼번에 생성하는, 브라우저에서 완결되는 도구입니다.
도구마다 규칙 파일이 제각각인 문제
AI 코딩 도구는 각자 다른 파일에서 프로젝트 규칙을 읽어옵니다.
| 도구 | 읽어오는 파일 |
|---|---|
| OpenAI Codex / Google Jules 등 | AGENTS.md |
| Claude Code | CLAUDE.md |
| Cursor | .cursor/rules/*.mdc |
| GitHub Copilot | .github/copilot-instructions.md |
| Windsurf | .windsurfrules |
| Gemini CLI | GEMINI.md |
팀원마다 쓰는 도구가 다르면 같은 내용의 규칙을 여러 파일에 복사-붙여넣기 하며 돌아다니게 됩니다. 그리고 몇 주 뒤에는 “CLAUDE.md만 업데이트되고 Cursor 규칙은 예전 그대로”라는 흔한 사고가 발생합니다.
AGENTS.md를 “기준”으로 삼는 설계
이 문제에 대한 현실적인 해답은 하나의 기준(Single Source of Truth)에서 각 도구용 파일을 파생시키는 것입니다.
기준으로 삼기에 적합한 것이 AGENTS.md입니다. AI 코딩 에이전트에게 프로젝트를 설명하기 위한 오픈 표준 파일로, “AI 에이전트판 README”로서 OpenAI Codex나 Google Jules를 비롯해 많은 도구가 지원을 넓혀가고 있습니다.
이 도구도 이 설계를 따릅니다. 폼 입력으로부터 먼저 AGENTS.md를 조립하고, 나머지 5개 파일은 거기서 파생시킵니다. CLAUDE.md·copilot-instructions.md·.windsurfrules·GEMINI.md는 본문을 그대로 공유하며, Cursor용 .mdc만 맨 앞에 MDC 형식의 프런트매터(description과 alwaysApply: true)를 붙입니다. 내용이 항상 모든 파일에서 일치하므로, 복사-붙여넣기로 인한 불일치가 구조적으로 발생하지 않습니다.
사용법
- AI Rules 생성기를 열고 폼에 입력합니다.
- 프로젝트명·개요 ― AI가 가장 먼저 읽는 전제 정보
- 기술 스택 ― 쉼표 또는 줄바꿈으로 구분(예:
TypeScript, React, Vite) - 명령어 ― 개발 서버·빌드·테스트·린트 실행 명령
- 코딩 규칙 / 금지 사항 ― 한 줄에 한 항목씩 목록으로
- 디렉토리 구성·보충 설명 ― 필요에 따라(빈 섹션은 출력에서 자동으로 제외됩니다)
- 출력 언어(영어/일본어)를 선택하고 “규칙 파일 생성”을 누릅니다.
- 6개 파일이 탭으로 표시되므로 개별 복사하거나 “ZIP으로 일괄 다운로드”로 저장합니다. ZIP에는
.cursor/rules/나.github/의 디렉토리 구조도 포함되어 있어, 저장소 루트에 압축을 풀기만 하면 배치가 끝납니다.
생성은 모두 브라우저 안의 JavaScript로 완결되며, 입력한 프로젝트 정보가 서버로 전송되지 않습니다.
규칙 파일에 무엇을 써야 하는가
AI 에이전트의 제안 정확도를 높이는 데 효과가 큰 것은 다음과 같은 “코드에서 읽어내기 어려운 지식”입니다.
- 검증 명령 ― 테스트·린트·빌드 실행 방법. AI가 스스로 변경 사항을 검증할 수 있게 됩니다
- 프로젝트 고유 규칙 ― “함수형 컴포넌트만 사용”, “날짜 처리는 dayjs로 통일” 같은 기존 코드의 관례
- 금지 사항 ― “any를 쓰지 않는다”, “자동 생성 파일을 수정하지 않는다”, “
.env를 커밋하지 않는다” 등 하지 말아야 할 것의 명문화
반대로 코드를 읽으면 알 수 있는 정보(파일 목록이나 함수 설명 등)를 길게 쓸 필요는 없습니다. 규칙이 너무 길면 중요한 지시가 묻히므로, 우선 위 3종류를 간결하게 정리하는 것을 추천합니다.
운영 팁
- 생성 결과는 초안으로 취급 ― 팀에서 리뷰하고 실제 상황에 맞게 가감하세요
- 기존 파일이 있다면 diff 병합 ― 이미 CLAUDE.md 등을 운영 중이라면 덮어쓰지 말고 차이를 확인한 뒤 통합합니다
- 기밀 정보는 쓰지 않는다 ― 규칙 파일은 저장소에 커밋됩니다. API 키나 내부 URL은 쓰지 마세요
- 업데이트도 이 도구로 ― 규칙 변경 시 폼에 다시 입력해 재생성하면 6개 파일의 동기화가 유지됩니다
정리
- AI 코딩 도구는 각자 다른 규칙 파일을 읽으므로, 수동 관리로는 복사-붙여넣기 불일치가 발생하기 쉽다
- AGENTS.md를 기준으로 파생 생성하면 도구 간에 규칙이 항상 일치한다
- 써야 할 것은 “검증 명령·프로젝트 고유 규칙·금지 사항”이라는, 코드에서 읽어내기 어려운 지식이다
여러 AI 도구를 병행하고 있다면, AI Rules 생성기로 규칙 파일 세트를 갖추는 것부터 시작해보세요.