루트 폴더 설정 파일 정리 노트


date: 2026-02-18
tags:
– workspace
– AI설정
– 폴더정리
type: research

루트 폴더 정리 작업 중 확인한 각 설정 파일의 역할, 위치 제약, AI 도구별 차이점을 정리한다.

## 1. 루트 고정 파일 (이동 불가)

| 파일 | 용도 | 이동 불가 사유 |
|——|——|—————-|
| `CLAUDE.md` | Claude Code 프로젝트 설정 | 루트에서만 자동 인식 |
| `GEMINI.md` | Antigravity(Gemini) 프로젝트 설정 | 루트에서만 자동 인식 |
| `.claudeignore` | Claude 컨텍스트 제외 목록 | `.gitignore`와 동일 — 루트 필수 |
| `.mcp.json` | Claude MCP 서버 연결 설정 | Claude Code 전용, 루트에서 참조 |
| `desktop.ini` | Windows 폴더 표시 설정 | OS 시스템 파일 |

## 2. AI 도구별 설정 비교

### ignore 파일

| 항목 | Claude Code | Antigravity (Gemini) |
|——|————|———————|
| ignore 파일 | `.claudeignore` ✅ | `.geminiignore` ❌ 미지원 |
| 방식 | 파일/폴더 제외 (negative) | `GEMINI.md` + `.context/`로 참조 가이드 (positive) |

### MCP 설정

| 항목 | Claude Code | Antigravity (Gemini) |
|——|————|———————|
| 설정 파일 | `.mcp.json` (프로젝트 루트) | ❌ 별도 파일 불필요 |
| 설정 위치 | 프로젝트별 JSON | VS Code 확장 설정(`settings.json`)에서 관리 |

## 3. 결론: 루트 최종 구성

“`
루트/
├── CLAUDE.md ← AI 설정 (고정)
├── GEMINI.md ← AI 설정 (고정)
├── .claudeignore ← Claude 전용 (고정)
├── .mcp.json ← Claude MCP (고정)
├── desktop.ini ← Windows (고정)
├── .agent/ ← AI 스킬 + 프롬프트 템플릿
├── .context/ ← AI Knowledge Base + 가이드
├── .claude/ ← Claude 설정
├── .obsidian/ ← Obsidian 설정
├── _문서보관/ ← 비AI 문서 보관
├── _프로젝트별정리/ ← 프로젝트/업무 문서
└── 0_Inbox ~ 9 폴더 ← Obsidian 폴더 구조
“`

Posted in mm