init-local-rules

현재 에이전트를 자동 식별하고, 해당 에이전트의 개인용 설정 파일을 생성한다. 이 파일은 .gitignore에 추가되어 팀 규칙(AGENTS.md)과 분리된 개인 선호를 담는다.

팀 규칙은 /init-project-rules로, 개인 규칙은 이 스킬로 관리한다.

가드레일

#	검증	실패 시
1	CWD가 Git 저장소임	"Git 저장소에서 실행해주세요"
2	해당 로컬 설정 파일이 이미 존재	"이미 존재합니다. 덮어쓸까요, 병합할까요?"

워크플로우

1단계: 에이전트 식별

현재 실행 중인 에이전트를 자동으로 판별한다. 아래 순서로 확인:

우선순위	판별 방법	에이전트
1	CLAUDE_CODE 환경변수 또는 claude CLI 프로세스	Claude Code
2	CURSOR_* 환경변수 또는 Cursor 에디터 프로세스	Cursor
3	GITHUB_COPILOT_* 환경변수	GitHub Copilot
4	WINDSURF_* 환경변수	Windsurf
5	GEMINI_* 환경변수 또는 gemini CLI 프로세스	Gemini CLI
6	ROO_CODE_* 환경변수	Roo Code
7	JUNIE_* 또는 JetBrains 프로세스	JetBrains Junie

자동 식별이 불가능하면 질문한다:

어떤 에이전트를 사용하고 계신가요?
1. Claude Code
2. Cursor
3. GitHub Copilot
4. Windsurf
5. Gemini CLI
6. Roo Code
7. JetBrains Junie
8. 기타 (직접 입력)

2단계: 사용자 인터뷰

개인 설정에 들어갈 내용을 파악한다. 한 번에 모아서 질문한다.

개인 설정 파일에 어떤 내용을 넣을까요? (해당 항목만 답해주세요)

1. 선호하는 응답 언어? (예: 한국어, 영어)
2. 응답 스타일? (간결한 vs 자세한, 이모지 사용 여부 등)
3. 자주 쓰는 로컬 URL이나 개발 환경? (예: localhost:3000, Docker 포트 등)
4. 개인 작업 습관? (예: TDD 선호, 항상 타입부터 작성 등)
5. 디버깅 선호? (예: console.log vs debugger, 로그 레벨 등)
6. 기타 개인 선호사항?

답변이 없는 항목은 생략한다. 최소한 응답 언어 하나만 있어도 파일을 생성한다.

3단계: 로컬 설정 파일 생성

식별된 에이전트에 맞는 네이티브 파일을 생성한다.

에이전트별 파일 매핑

에이전트	생성 파일	비고
Claude Code	CLAUDE.local.md	자동으로 .gitignore에 추가됨 (Claude Code 내장)
Cursor	.cursor/rules/local.mdc	.cursor/ 자체가 보통 gitignore 대상
GitHub Copilot	.github/copilot-instructions.local.md	수동 gitignore 필요
Windsurf	.windsurfrules.local	수동 gitignore 필요
Gemini CLI	GEMINI.local.md	수동 gitignore 필요
Roo Code	.roo/rules/local.md	.roo/ 자체가 보통 gitignore 대상
JetBrains Junie	.junie/guidelines.local.md	수동 gitignore 필요

파일 내용 구조:

references/local-rules-template.md를 읽고 에이전트에 맞게 변환한다.

Claude Code 전용 참고사항

CLAUDE.local.md는 Claude Code가 자동으로 인식하는 공식 파일이다. @AGENTS.md를 import할 필요 없다 — CLAUDE.md(팀 공유)가 이미 처리하고 있다. 개인 선호만 담는다.

Cursor 전용 참고사항

.cursor/rules/local.mdc는 MDC(Markdown Config) 형식을 따른다:

---
description: 개인 로컬 설정
globs:
alwaysApply: true
---

(내용)

4단계: .gitignore 업데이트

생성한 파일이 Git에 추적되지 않도록 .gitignore를 확인하고 필요 시 추가한다.

• CLAUDE.local.md → Claude Code가 자동 처리하므로 확인만
• 나머지 → .gitignore에 해당 패턴이 없으면 추가

추가 시 섹션 주석을 넣는다:

# Personal agent rules
GEMINI.local.md
.windsurfrules.local
.junie/guidelines.local.md

이미 존재하는 패턴(예: .cursor/)으로 커버되면 중복 추가하지 않는다.

5단계: 결과 요약

✅ 생성 완료:
  - CLAUDE.local.md (Claude Code 개인 설정)
  - .gitignore 업데이트됨

이 파일은 Git에 추적되지 않습니다.
팀 규칙(AGENTS.md)과 분리되어, 개인 선호만 담습니다.

팀 규칙이 아직 없다면 /init-project-rules 를 실행하세요.

개인 설정 vs 팀 설정 가이드

사용자가 팀 규칙에 넣어야 할 내용을 개인 설정에 넣으려 하면 안내한다.

이건 개인 설정	이건 팀 설정 (AGENTS.md)
응답 언어 선호	빌드/테스트 명령어
응답 스타일 (간결/상세)	코드 스타일 컨벤션
로컬 환경 URL	프로젝트 구조 설명
개인 작업 습관	아키텍처 결정
디버깅 선호 방식	Git 워크플로우
개인 MCP 서버 구성	보안 규칙 / Boundaries
자주 쓰는 alias/스크립트	Common Pitfalls