codesyncer 2.1.1 → 2.1.2

package/dist/templates/en/root_claude.md

@@ -0,0 +1,239 @@
+# CLAUDE.md - [PROJECT_NAME] Multi-Repo Project
+
+> **🎯 This is a Multi-Repository Workspace**
+>
+> Each repository is an independent project, working together collaboratively.
+
+---
+
+## 📋 First Thing to Do
+
+**If you've read this file, immediately read the following file:**
+
+```
+.codesyncer/MASTER_CODESYNCER.md
+```
+
+→ This file contains **all repository information**, **auto-switching rules**, and **keyword mappings**.
+
+---
+
+## 🏗️ Project Overview
+
+- **Project Name**: [PROJECT_NAME]
+- **GitHub**: https://github.com/[GITHUB_USERNAME]/[PROJECT_NAME]
+- **Created**: [TODAY]
+- **Repositories**: [REPO_COUNT]
+
+---
+
+## 🗂️ Repository Structure
+
+```
+[PROJECT_NAME]/
+├── CLAUDE.md (current file)
+├── .codesyncer/
+│   └── MASTER_CODESYNCER.md ⭐ Multi-repo navigation
+│
+├── [repo1]/
+│   └── .claude/
+│       └── CLAUDE.md (individual repo rules)
+│
+├── [repo2]/
+│   └── .claude/
+│       └── CLAUDE.md (individual repo rules)
+│
+└── ...
+```
+
+---
+
+## 🚨 Important Rules
+
+### 1. Check Repository Before Working
+Always verify which repository you're working in:
+```bash
+pwd  # Check current directory
+```
+
+### 2. Read CLAUDE.md When Switching Repos
+Every time you work in a new repo:
+```
+"Read [repo-name]/.claude/CLAUDE.md"
+```
+
+### 3. No Work in Root Directory
+Never code in root directory. Always navigate to specific repo before working.
+
+---
+
+## 🔄 Multi-Repo Workflow
+
+### Scenario 1: User Specifies Specific Repo
+```
+User: "Add login API to backend"
+       ↓
+1. Check MASTER_CODESYNCER.md for "backend" keyword → find api-server repo
+2. Read api-server/.claude/CLAUDE.md
+3. Work in api-server
+```
+
+### Scenario 2: Multiple Repos Need Changes
+```
+User: "Add order feature"
+       ↓
+1. "Order feature requires both backend (API) and frontend (UI). Proceed?"
+2. After user confirmation
+3. Work on API in api-server → report completion
+4. Work on UI in web-client → report completion
+```
+
+### Scenario 3: Unclear Which Repo
+```
+1. Check keyword mapping in MASTER_CODESYNCER.md
+2. If unclear, ask user
+   "Which repo should I work in?"
+   - A) api-server (backend)
+   - B) web-client (frontend)
+   - C) mobile-app (mobile)
+```
+
+---
+
+## 📝 Project-Wide Common Rules
+
+The following rules apply to **all repositories**:
+
+### Coding Standards
+- ✅ Use TypeScript strict mode
+- ✅ Explicit type definitions required
+- ✅ Prefer functional programming
+- ✅ Document all functions/components
+- ✅ Error handling required
+
+### Comment Tag System
+Use the same tags across all repos:
+```typescript
+@codesyncer-rule        // Special rules
+@codesyncer-inference   // Inference with reasoning
+@codesyncer-decision    // Decisions after discussion
+@codesyncer-todo        // User confirmation needed
+@codesyncer-context     // Business context explanation
+```
+
+Details: `.claude/COMMENT_GUIDE.md` in each repo
+
+### No-Inference Zones
+**Never infer, always ask the user:**
+- 💰 Business logic numbers (prices, fees, limits, discounts)
+- 🔌 API endpoint URLs
+- 🔐 Security settings (token expiry, encryption methods)
+- 🗄️ Database schema
+- 🌐 External service integration details
+
+### Discussion-Required Keywords
+When these keywords are detected, **stop work automatically** and discuss with user:
+- 🔴 **CRITICAL**: payment, billing, auth, permission, delete, personal data, GDPR
+- 🟡 **IMPORTANT**: API integration, DB schema, deployment, caching, email
+- 🟢 **MINOR**: optimization, testing, logging, UI/UX
+
+Full keyword list: `.codesyncer/MASTER_CODESYNCER.md`
+
+---
+
+## 🎯 Session Start Checklist
+
+When AI reads this file:
+
+1. ✅ Immediately read `.codesyncer/MASTER_CODESYNCER.md`
+2. ✅ Understand overall repository structure
+3. ✅ Check keyword mappings
+4. ✅ Output ready message:
+
+```
+✅ [PROJECT_NAME] multi-repo project ready!
+
+📁 Repositories: [REPO_COUNT]
+📋 Read MASTER_CODESYNCER.md
+🎯 Ready to work
+
+Which repo should we work in?
+```
+
+---
+
+## 💡 Useful Commands
+
+### Navigation
+```
+"Show repo list"            → List repos from MASTER_CODESYNCER.md
+"Go to backend"             → Read api-server/.claude/CLAUDE.md
+"Switch to frontend"        → Read web-client/.claude/CLAUDE.md
+```
+
+### Document Updates
+```
+"Update all structures"     → Refresh all ARCHITECTURE.md files
+"Check decision log"        → Review DECISIONS.md in each repo
+```
+
+### Multi-Repo Tasks
+```
+"Add ESLint to all repos"   → Work sequentially on each repo
+"Need common type defs"     → Discuss where to place them
+```
+
+---
+
+## 📚 Related Documents
+
+### Root Documents
+- **Multi-repo Navigation**: `.codesyncer/MASTER_CODESYNCER.md` ⭐ **Required**
+- **Setup Guide**: `.codesyncer/SETUP_GUIDE.md` (Reference after AI setup)
+
+### Individual Repo Documents
+In each repo's `.claude/` folder:
+- **CLAUDE.md** - Repo-specific coding rules
+- **ARCHITECTURE.md** - Project structure
+- **COMMENT_GUIDE.md** - Comment writing guide
+- **DECISIONS.md** - Discussion decision log
+
+---
+
+## 🔍 Search Comments (Entire Project)
+
+```bash
+# Find all TODOs across repos
+grep -r "@codesyncer-todo" ./*/.claude/
+
+# Find all decision records
+grep -r "@codesyncer-decision" ./*/
+
+# Search for specific keyword
+grep -r "payment" ./*/
+```
+
+---
+
+## ⚠️ Important Notes
+
+1. **Context Switch When Changing Repos**
+   - Each repo may have independent rules
+   - Always check that repo's CLAUDE.md
+
+2. **Cross-Repo Dependencies**
+   - Discuss changes affecting multiple repos with user
+   - Explain clearly when order matters
+
+3. **Common Code Management**
+   - Discuss location for shared types, utilities
+   - Establish duplication prevention strategy
+
+---
+
+**Version**: 1.0.0 (Powered by CodeSyncer)
+**AI Tools**: Optimized for Claude Code | Compatible: Cursor, GitHub Copilot, Continue.dev
+
+---
+
+*CodeSyncer is open source: https://github.com/bitjaru/codesyncer*

package/dist/templates/en/setup_guide.md

@@ -158,20 +158,35 @@ Use template: `./templates/[lang]/decisions.md`
 
 ---
 
-## 🌐 Step 4: Generate Master Document
+## 🌐 Step 4: Generate Root Documents
 
-At the workspace root, create `.codesyncer/MASTER_CODESYNCER.md`:
+Create the following files at the workspace root:
 
-### Content:
-- List all repositories with their roles
-- Automatic repository switching rules
-- Keyword-based navigation mapping
-- Multi-repo workflow examples
+### 4.1 CLAUDE.md ⭐ **Claude Reads This First**
+
+Create `CLAUDE.md` at root (automatically discovered by Claude):
+
+Use template: `./templates/[lang]/root_claude.md`
+- Replace [PROJECT_NAME], [GITHUB_USERNAME], [TODAY]
+- Replace [REPO_COUNT] with actual repository count
+- Indicate this is a multi-repo project
+- Instruct to read MASTER_CODESYNCER.md first
+- Specify project-wide common rules
+
+**Important**: This file must exist for Claude to automatically load context at session start!
+
+### 4.2 .codesyncer/MASTER_CODESYNCER.md
+
+Create `.codesyncer/MASTER_CODESYNCER.md` at workspace root:
 
 Use template: `./templates/[lang]/master.md`
 - Replace [REPO_TABLE] with actual detected repos
 - Replace [KEYWORD_MAPPING] with repo-specific keywords
 - Replace [PROJECT_NAME], [GITHUB_USERNAME]
+- List all repositories with their roles
+- Automatic repository switching rules
+- Keyword-based navigation mapping
+- Multi-repo workflow examples
 
 ---
 
@@ -183,8 +198,10 @@ After generating all files, present a summary:
 ✅ CodeSyncer Setup Complete!
 
 Created files:
-📁 .codesyncer/
-   └── MASTER_CODESYNCER.md
+📁 Root/
+   ├── CLAUDE.md ⭐ Claude reads this first
+   └── .codesyncer/
+       └── MASTER_CODESYNCER.md
 
 📁 [repo1]/.claude/
    ├── CLAUDE.md
@@ -197,8 +214,10 @@ Created files:
 
 Next Steps:
 1. Review the generated files
-2. Customize any project-specific rules in CLAUDE.md
-3. Start developing with: "Read CLAUDE.md" in each repo
+2. Customize each repo's CLAUDE.md
+3. Read root CLAUDE.md or individual repo CLAUDE.md to start development
+
+💡 Claude automatically finds and reads root CLAUDE.md!
 
 Ready to start using CodeSyncer!
 ```

package/dist/templates/ko/root_claude.md

@@ -0,0 +1,239 @@
+# CLAUDE.md - [PROJECT_NAME] 멀티레포 프로젝트
+
+> **🎯 이것은 멀티레포 워크스페이스입니다**
+>
+> 각 레포지토리는 독립적인 프로젝트이며, 함께 협업합니다.
+
+---
+
+## 📋 첫 번째 할 일
+
+**이 파일을 읽었다면, 다음 파일을 즉시 읽어주세요:**
+
+```
+.codesyncer/MASTER_CODESYNCER.md
+```
+
+→ 이 파일에 **모든 레포지토리 정보**, **자동 전환 규칙**, **키워드 매핑**이 있습니다.
+
+---
+
+## 🏗️ 프로젝트 개요
+
+- **프로젝트명**: [PROJECT_NAME]
+- **GitHub**: https://github.com/[GITHUB_USERNAME]/[PROJECT_NAME]
+- **생성일**: [TODAY]
+- **레포지토리 수**: [REPO_COUNT]개
+
+---
+
+## 🗂️ 레포지토리 구조
+
+```
+[PROJECT_NAME]/
+├── CLAUDE.md (지금 읽는 파일)
+├── .codesyncer/
+│   └── MASTER_CODESYNCER.md ⭐ 멀티레포 네비게이션
+│
+├── [repo1]/
+│   └── .claude/
+│       └── CLAUDE.md (개별 레포 규칙)
+│
+├── [repo2]/
+│   └── .claude/
+│       └── CLAUDE.md (개별 레포 규칙)
+│
+└── ...
+```
+
+---
+
+## 🚨 중요 규칙
+
+### 1. 작업 전 레포지토리 확인
+항상 현재 어느 레포에서 작업하는지 확인하세요:
+```bash
+pwd  # 현재 디렉토리 확인
+```
+
+### 2. 레포 전환 시 CLAUDE.md 읽기
+새로운 레포에서 작업할 때마다:
+```
+"[repo-name]/.claude/CLAUDE.md 읽어줘"
+```
+
+### 3. 루트에서는 작업 금지
+루트 디렉토리에서 코드 작업 금지. 항상 특정 레포로 이동 후 작업.
+
+---
+
+## 🔄 멀티레포 작업 흐름
+
+### 시나리오 1: 사용자가 특정 레포 명시
+```
+사용자: "백엔드에 로그인 API 추가해줘"
+       ↓
+1. MASTER_CODESYNCER.md에서 "백엔드" 키워드 → api-server 레포 확인
+2. api-server/.claude/CLAUDE.md 읽기
+3. api-server에서 작업
+```
+
+### 시나리오 2: 여러 레포 수정 필요
+```
+사용자: "주문 기능 추가해줘"
+       ↓
+1. "주문 기능은 백엔드(API)와 프론트엔드(UI) 둘 다 필요합니다. 진행할까요?"
+2. 사용자 확인 후
+3. api-server에서 API 작업 → 완료 보고
+4. web-client에서 UI 작업 → 완료 보고
+```
+
+### 시나리오 3: 어느 레포인지 모를 때
+```
+1. MASTER_CODESYNCER.md의 키워드 매핑 확인
+2. 불명확하면 사용자에게 질문
+   "어느 레포에서 작업할까요?"
+   - A) api-server (백엔드)
+   - B) web-client (프론트엔드)
+   - C) mobile-app (모바일)
+```
+
+---
+
+## 📝 전체 프로젝트 공통 규칙
+
+다음 규칙은 **모든 레포지토리에 공통 적용**:
+
+### 코딩 표준
+- ✅ TypeScript strict mode 사용
+- ✅ 명시적 타입 정의 필수
+- ✅ 함수형 프로그래밍 우선
+- ✅ 모든 함수/컴포넌트에 주석 작성
+- ✅ 에러 핸들링 필수
+
+### 주석 태그 시스템
+모든 레포에서 동일한 태그 사용:
+```typescript
+@codesyncer-rule        // 특별 규칙
+@codesyncer-inference   // 추론 내용과 근거
+@codesyncer-decision    // 의논 후 결정 사항
+@codesyncer-todo        // 사용자 확인 필요
+@codesyncer-context     // 비즈니스 맥락 설명
+```
+
+자세한 내용: 각 레포의 `.claude/COMMENT_GUIDE.md`
+
+### 추론 금지 영역
+**절대 추론하지 말고 사용자에게 물어보세요:**
+- 💰 비즈니스 로직 수치 (가격, 수수료, 한도, 할인율)
+- 🔌 API 엔드포인트 URL
+- 🔐 보안 설정 (토큰 만료 시간, 암호화 방식)
+- 🗄️ 데이터베이스 스키마
+- 🌐 외부 서비스 연동 정보
+
+### 의논 필수 키워드
+다음 키워드 감지 시 **자동으로 작업 중단** 후 사용자와 의논:
+- 🔴 **CRITICAL**: 결제, 과금, 인증, 권한, 삭제, 개인정보, GDPR
+- 🟡 **IMPORTANT**: API 연동, DB 스키마, 배포, 캐싱, 이메일
+- 🟢 **MINOR**: 최적화, 테스트, 로깅, UI/UX
+
+자세한 키워드 목록: `.codesyncer/MASTER_CODESYNCER.md`
+
+---
+
+## 🎯 세션 시작 체크리스트
+
+AI가 이 파일을 읽으면:
+
+1. ✅ `.codesyncer/MASTER_CODESYNCER.md` 즉시 읽기
+2. ✅ 전체 레포지토리 구조 파악
+3. ✅ 키워드 매핑 확인
+4. ✅ 준비 완료 메시지 출력:
+
+```
+✅ [PROJECT_NAME] 멀티레포 프로젝트 준비 완료!
+
+📁 레포지토리: [REPO_COUNT]개
+📋 MASTER_CODESYNCER.md 읽음
+🎯 작업 가능 상태
+
+어느 레포에서 작업할까요?
+```
+
+---
+
+## 💡 유용한 명령어
+
+### 네비게이션
+```
+"레포 목록 보여줘"          → MASTER_CODESYNCER.md 기반 레포 나열
+"백엔드로 이동"             → api-server/.claude/CLAUDE.md 읽기
+"프론트엔드로 전환"         → web-client/.claude/CLAUDE.md 읽기
+```
+
+### 문서 업데이트
+```
+"전체 구조 업데이트"        → 모든 레포 ARCHITECTURE.md 갱신
+"의논 기록 확인"            → 각 레포의 DECISIONS.md 확인
+```
+
+### 멀티레포 작업
+```
+"모든 레포에 ESLint 설정"   → 순차적으로 각 레포 작업
+"공통 타입 정의 필요"       → 어느 레포에 둘지 의논
+```
+
+---
+
+## 📚 관련 문서
+
+### 루트 문서
+- **멀티레포 네비게이션**: `.codesyncer/MASTER_CODESYNCER.md` ⭐ **필수**
+- **설정 가이드**: `.codesyncer/SETUP_GUIDE.md` (AI 설정 완료 후 참고용)
+
+### 개별 레포 문서
+각 레포의 `.claude/` 폴더:
+- **CLAUDE.md** - 레포별 코딩 규칙
+- **ARCHITECTURE.md** - 프로젝트 구조
+- **COMMENT_GUIDE.md** - 주석 작성 가이드
+- **DECISIONS.md** - 의논 결정 기록
+
+---
+
+## 🔍 주석 검색 (전체 프로젝트)
+
+```bash
+# 모든 레포에서 TODO 찾기
+grep -r "@codesyncer-todo" ./*/.claude/
+
+# 모든 의논 결정 찾기
+grep -r "@codesyncer-decision" ./*/
+
+# 특정 키워드 찾기
+grep -r "결제" ./*/
+```
+
+---
+
+## ⚠️ 주의사항
+
+1. **레포 전환 시 컨텍스트 전환**
+   - 각 레포는 독립적인 규칙을 가질 수 있음
+   - 반드시 해당 레포의 CLAUDE.md 확인
+
+2. **크로스 레포 의존성**
+   - 여러 레포에 영향 주는 변경은 사용자와 의논
+   - 순서가 중요한 경우 명확히 설명
+
+3. **공통 코드 관리**
+   - 타입 정의, 유틸 함수 등 공통 코드 위치 의논
+   - 중복 방지 전략 수립
+
+---
+
+**버전**: 1.0.0 (Powered by CodeSyncer)
+**AI 도구**: Claude Code 최적화 | 호환: Cursor, GitHub Copilot, Continue.dev
+
+---
+
+*CodeSyncer는 오픈소스입니다: https://github.com/bitjaru/codesyncer*

package/dist/templates/ko/setup_guide.md

@@ -158,20 +158,35 @@
 
 ---
 
-## 🌐 4단계: 마스터 문서 생성
+## 🌐 4단계: 루트 문서 생성
 
-워크스페이스 루트에 `.codesyncer/MASTER_CODESYNCER.md` 생성:
+워크스페이스 루트에 다음 파일들을 생성:
 
-### 내용:
-- 모든 레포지토리와 역할 나열
-- 자동 레포지토리 전환 규칙
-- 키워드 기반 네비게이션 매핑
-- 멀티 레포 워크플로우 예시
+### 4.1 CLAUDE.md ⭐ **클로드가 먼저 읽는 파일**
+
+루트에 `CLAUDE.md` 생성 (클로드가 자동으로 찾는 파일):
+
+템플릿 사용: `./templates/[lang]/root_claude.md`
+- [PROJECT_NAME], [GITHUB_USERNAME], [TODAY] 교체
+- [REPO_COUNT]를 실제 레포지토리 개수로 교체
+- 멀티레포 프로젝트임을 명시
+- MASTER_CODESYNCER.md를 먼저 읽으라고 지시
+- 전체 프로젝트 공통 규칙 명시
+
+**중요**: 이 파일이 있어야 클로드가 세션 시작 시 자동으로 컨텍스트를 로드합니다!
+
+### 4.2 .codesyncer/MASTER_CODESYNCER.md
+
+워크스페이스 루트에 `.codesyncer/MASTER_CODESYNCER.md` 생성:
 
 템플릿 사용: `./templates/[lang]/master.md`
 - [REPO_TABLE]을 실제 감지된 레포로 교체
 - [KEYWORD_MAPPING]을 레포별 키워드로 교체
 - [PROJECT_NAME], [GITHUB_USERNAME] 교체
+- 모든 레포지토리와 역할 나열
+- 자동 레포지토리 전환 규칙
+- 키워드 기반 네비게이션 매핑
+- 멀티 레포 워크플로우 예시
 
 ---
 
@@ -183,8 +198,10 @@
 ✅ CodeSyncer 설정 완료!
 
 생성된 파일:
-📁 .codesyncer/
-   └── MASTER_CODESYNCER.md
+📁 루트/
+   ├── CLAUDE.md ⭐ 클로드가 먼저 읽는 파일
+   └── .codesyncer/
+       └── MASTER_CODESYNCER.md
 
 📁 [repo1]/.claude/
    ├── CLAUDE.md
@@ -197,8 +214,10 @@
 
 다음 단계:
 1. 생성된 파일 검토
-2. CLAUDE.md의 프로젝트별 규칙 커스터마이즈
-3. 각 레포에서 "CLAUDE.md 읽어줘"로 개발 시작
+2. 각 레포의 CLAUDE.md 커스터마이즈
+3. 루트 CLAUDE.md 또는 개별 레포 CLAUDE.md 읽고 개발 시작
+
+💡 클로드는 자동으로 루트 CLAUDE.md를 찾아서 읽습니다!
 
 CodeSyncer 사용 준비 완료!
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesyncer",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "AI-powered multi-repository collaboration system - Works with Claude Code, Cursor, GitHub Copilot, and more",
   "keywords": [
     "ai-collaboration",

package/src/templates/en/root_claude.md

@@ -0,0 +1,239 @@
+# CLAUDE.md - [PROJECT_NAME] Multi-Repo Project
+
+> **🎯 This is a Multi-Repository Workspace**
+>
+> Each repository is an independent project, working together collaboratively.
+
+---
+
+## 📋 First Thing to Do
+
+**If you've read this file, immediately read the following file:**
+
+```
+.codesyncer/MASTER_CODESYNCER.md
+```
+
+→ This file contains **all repository information**, **auto-switching rules**, and **keyword mappings**.
+
+---
+
+## 🏗️ Project Overview
+
+- **Project Name**: [PROJECT_NAME]
+- **GitHub**: https://github.com/[GITHUB_USERNAME]/[PROJECT_NAME]
+- **Created**: [TODAY]
+- **Repositories**: [REPO_COUNT]
+
+---
+
+## 🗂️ Repository Structure
+
+```
+[PROJECT_NAME]/
+├── CLAUDE.md (current file)
+├── .codesyncer/
+│   └── MASTER_CODESYNCER.md ⭐ Multi-repo navigation
+│
+├── [repo1]/
+│   └── .claude/
+│       └── CLAUDE.md (individual repo rules)
+│
+├── [repo2]/
+│   └── .claude/
+│       └── CLAUDE.md (individual repo rules)
+│
+└── ...
+```
+
+---
+
+## 🚨 Important Rules
+
+### 1. Check Repository Before Working
+Always verify which repository you're working in:
+```bash
+pwd  # Check current directory
+```
+
+### 2. Read CLAUDE.md When Switching Repos
+Every time you work in a new repo:
+```
+"Read [repo-name]/.claude/CLAUDE.md"
+```
+
+### 3. No Work in Root Directory
+Never code in root directory. Always navigate to specific repo before working.
+
+---
+
+## 🔄 Multi-Repo Workflow
+
+### Scenario 1: User Specifies Specific Repo
+```
+User: "Add login API to backend"
+       ↓
+1. Check MASTER_CODESYNCER.md for "backend" keyword → find api-server repo
+2. Read api-server/.claude/CLAUDE.md
+3. Work in api-server
+```
+
+### Scenario 2: Multiple Repos Need Changes
+```
+User: "Add order feature"
+       ↓
+1. "Order feature requires both backend (API) and frontend (UI). Proceed?"
+2. After user confirmation
+3. Work on API in api-server → report completion
+4. Work on UI in web-client → report completion
+```
+
+### Scenario 3: Unclear Which Repo
+```
+1. Check keyword mapping in MASTER_CODESYNCER.md
+2. If unclear, ask user
+   "Which repo should I work in?"
+   - A) api-server (backend)
+   - B) web-client (frontend)
+   - C) mobile-app (mobile)
+```
+
+---
+
+## 📝 Project-Wide Common Rules
+
+The following rules apply to **all repositories**:
+
+### Coding Standards
+- ✅ Use TypeScript strict mode
+- ✅ Explicit type definitions required
+- ✅ Prefer functional programming
+- ✅ Document all functions/components
+- ✅ Error handling required
+
+### Comment Tag System
+Use the same tags across all repos:
+```typescript
+@codesyncer-rule        // Special rules
+@codesyncer-inference   // Inference with reasoning
+@codesyncer-decision    // Decisions after discussion
+@codesyncer-todo        // User confirmation needed
+@codesyncer-context     // Business context explanation
+```
+
+Details: `.claude/COMMENT_GUIDE.md` in each repo
+
+### No-Inference Zones
+**Never infer, always ask the user:**
+- 💰 Business logic numbers (prices, fees, limits, discounts)
+- 🔌 API endpoint URLs
+- 🔐 Security settings (token expiry, encryption methods)
+- 🗄️ Database schema
+- 🌐 External service integration details
+
+### Discussion-Required Keywords
+When these keywords are detected, **stop work automatically** and discuss with user:
+- 🔴 **CRITICAL**: payment, billing, auth, permission, delete, personal data, GDPR
+- 🟡 **IMPORTANT**: API integration, DB schema, deployment, caching, email
+- 🟢 **MINOR**: optimization, testing, logging, UI/UX
+
+Full keyword list: `.codesyncer/MASTER_CODESYNCER.md`
+
+---
+
+## 🎯 Session Start Checklist
+
+When AI reads this file:
+
+1. ✅ Immediately read `.codesyncer/MASTER_CODESYNCER.md`
+2. ✅ Understand overall repository structure
+3. ✅ Check keyword mappings
+4. ✅ Output ready message:
+
+```
+✅ [PROJECT_NAME] multi-repo project ready!
+
+📁 Repositories: [REPO_COUNT]
+📋 Read MASTER_CODESYNCER.md
+🎯 Ready to work
+
+Which repo should we work in?
+```
+
+---
+
+## 💡 Useful Commands
+
+### Navigation
+```
+"Show repo list"            → List repos from MASTER_CODESYNCER.md
+"Go to backend"             → Read api-server/.claude/CLAUDE.md
+"Switch to frontend"        → Read web-client/.claude/CLAUDE.md
+```
+
+### Document Updates
+```
+"Update all structures"     → Refresh all ARCHITECTURE.md files
+"Check decision log"        → Review DECISIONS.md in each repo
+```
+
+### Multi-Repo Tasks
+```
+"Add ESLint to all repos"   → Work sequentially on each repo
+"Need common type defs"     → Discuss where to place them
+```
+
+---
+
+## 📚 Related Documents
+
+### Root Documents
+- **Multi-repo Navigation**: `.codesyncer/MASTER_CODESYNCER.md` ⭐ **Required**
+- **Setup Guide**: `.codesyncer/SETUP_GUIDE.md` (Reference after AI setup)
+
+### Individual Repo Documents
+In each repo's `.claude/` folder:
+- **CLAUDE.md** - Repo-specific coding rules
+- **ARCHITECTURE.md** - Project structure
+- **COMMENT_GUIDE.md** - Comment writing guide
+- **DECISIONS.md** - Discussion decision log
+
+---
+
+## 🔍 Search Comments (Entire Project)
+
+```bash
+# Find all TODOs across repos
+grep -r "@codesyncer-todo" ./*/.claude/
+
+# Find all decision records
+grep -r "@codesyncer-decision" ./*/
+
+# Search for specific keyword
+grep -r "payment" ./*/
+```
+
+---
+
+## ⚠️ Important Notes
+
+1. **Context Switch When Changing Repos**
+   - Each repo may have independent rules
+   - Always check that repo's CLAUDE.md
+
+2. **Cross-Repo Dependencies**
+   - Discuss changes affecting multiple repos with user
+   - Explain clearly when order matters
+
+3. **Common Code Management**
+   - Discuss location for shared types, utilities
+   - Establish duplication prevention strategy
+
+---
+
+**Version**: 1.0.0 (Powered by CodeSyncer)
+**AI Tools**: Optimized for Claude Code | Compatible: Cursor, GitHub Copilot, Continue.dev
+
+---
+
+*CodeSyncer is open source: https://github.com/bitjaru/codesyncer*

package/src/templates/en/setup_guide.md

@@ -158,20 +158,35 @@ Use template: `./templates/[lang]/decisions.md`
 
 ---
 
-## 🌐 Step 4: Generate Master Document
+## 🌐 Step 4: Generate Root Documents
 
-At the workspace root, create `.codesyncer/MASTER_CODESYNCER.md`:
+Create the following files at the workspace root:
 
-### Content:
-- List all repositories with their roles
-- Automatic repository switching rules
-- Keyword-based navigation mapping
-- Multi-repo workflow examples
+### 4.1 CLAUDE.md ⭐ **Claude Reads This First**
+
+Create `CLAUDE.md` at root (automatically discovered by Claude):
+
+Use template: `./templates/[lang]/root_claude.md`
+- Replace [PROJECT_NAME], [GITHUB_USERNAME], [TODAY]
+- Replace [REPO_COUNT] with actual repository count
+- Indicate this is a multi-repo project
+- Instruct to read MASTER_CODESYNCER.md first
+- Specify project-wide common rules
+
+**Important**: This file must exist for Claude to automatically load context at session start!
+
+### 4.2 .codesyncer/MASTER_CODESYNCER.md
+
+Create `.codesyncer/MASTER_CODESYNCER.md` at workspace root:
 
 Use template: `./templates/[lang]/master.md`
 - Replace [REPO_TABLE] with actual detected repos
 - Replace [KEYWORD_MAPPING] with repo-specific keywords
 - Replace [PROJECT_NAME], [GITHUB_USERNAME]
+- List all repositories with their roles
+- Automatic repository switching rules
+- Keyword-based navigation mapping
+- Multi-repo workflow examples
 
 ---
 
@@ -183,8 +198,10 @@ After generating all files, present a summary:
 ✅ CodeSyncer Setup Complete!
 
 Created files:
-📁 .codesyncer/
-   └── MASTER_CODESYNCER.md
+📁 Root/
+   ├── CLAUDE.md ⭐ Claude reads this first
+   └── .codesyncer/
+       └── MASTER_CODESYNCER.md
 
 📁 [repo1]/.claude/
    ├── CLAUDE.md
@@ -197,8 +214,10 @@ Created files:
 
 Next Steps:
 1. Review the generated files
-2. Customize any project-specific rules in CLAUDE.md
-3. Start developing with: "Read CLAUDE.md" in each repo
+2. Customize each repo's CLAUDE.md
+3. Read root CLAUDE.md or individual repo CLAUDE.md to start development
+
+💡 Claude automatically finds and reads root CLAUDE.md!
 
 Ready to start using CodeSyncer!
 ```

package/src/templates/ko/root_claude.md

@@ -0,0 +1,239 @@
+# CLAUDE.md - [PROJECT_NAME] 멀티레포 프로젝트
+
+> **🎯 이것은 멀티레포 워크스페이스입니다**
+>
+> 각 레포지토리는 독립적인 프로젝트이며, 함께 협업합니다.
+
+---
+
+## 📋 첫 번째 할 일
+
+**이 파일을 읽었다면, 다음 파일을 즉시 읽어주세요:**
+
+```
+.codesyncer/MASTER_CODESYNCER.md
+```
+
+→ 이 파일에 **모든 레포지토리 정보**, **자동 전환 규칙**, **키워드 매핑**이 있습니다.
+
+---
+
+## 🏗️ 프로젝트 개요
+
+- **프로젝트명**: [PROJECT_NAME]
+- **GitHub**: https://github.com/[GITHUB_USERNAME]/[PROJECT_NAME]
+- **생성일**: [TODAY]
+- **레포지토리 수**: [REPO_COUNT]개
+
+---
+
+## 🗂️ 레포지토리 구조
+
+```
+[PROJECT_NAME]/
+├── CLAUDE.md (지금 읽는 파일)
+├── .codesyncer/
+│   └── MASTER_CODESYNCER.md ⭐ 멀티레포 네비게이션
+│
+├── [repo1]/
+│   └── .claude/
+│       └── CLAUDE.md (개별 레포 규칙)
+│
+├── [repo2]/
+│   └── .claude/
+│       └── CLAUDE.md (개별 레포 규칙)
+│
+└── ...
+```
+
+---
+
+## 🚨 중요 규칙
+
+### 1. 작업 전 레포지토리 확인
+항상 현재 어느 레포에서 작업하는지 확인하세요:
+```bash
+pwd  # 현재 디렉토리 확인
+```
+
+### 2. 레포 전환 시 CLAUDE.md 읽기
+새로운 레포에서 작업할 때마다:
+```
+"[repo-name]/.claude/CLAUDE.md 읽어줘"
+```
+
+### 3. 루트에서는 작업 금지
+루트 디렉토리에서 코드 작업 금지. 항상 특정 레포로 이동 후 작업.
+
+---
+
+## 🔄 멀티레포 작업 흐름
+
+### 시나리오 1: 사용자가 특정 레포 명시
+```
+사용자: "백엔드에 로그인 API 추가해줘"
+       ↓
+1. MASTER_CODESYNCER.md에서 "백엔드" 키워드 → api-server 레포 확인
+2. api-server/.claude/CLAUDE.md 읽기
+3. api-server에서 작업
+```
+
+### 시나리오 2: 여러 레포 수정 필요
+```
+사용자: "주문 기능 추가해줘"
+       ↓
+1. "주문 기능은 백엔드(API)와 프론트엔드(UI) 둘 다 필요합니다. 진행할까요?"
+2. 사용자 확인 후
+3. api-server에서 API 작업 → 완료 보고
+4. web-client에서 UI 작업 → 완료 보고
+```
+
+### 시나리오 3: 어느 레포인지 모를 때
+```
+1. MASTER_CODESYNCER.md의 키워드 매핑 확인
+2. 불명확하면 사용자에게 질문
+   "어느 레포에서 작업할까요?"
+   - A) api-server (백엔드)
+   - B) web-client (프론트엔드)
+   - C) mobile-app (모바일)
+```
+
+---
+
+## 📝 전체 프로젝트 공통 규칙
+
+다음 규칙은 **모든 레포지토리에 공통 적용**:
+
+### 코딩 표준
+- ✅ TypeScript strict mode 사용
+- ✅ 명시적 타입 정의 필수
+- ✅ 함수형 프로그래밍 우선
+- ✅ 모든 함수/컴포넌트에 주석 작성
+- ✅ 에러 핸들링 필수
+
+### 주석 태그 시스템
+모든 레포에서 동일한 태그 사용:
+```typescript
+@codesyncer-rule        // 특별 규칙
+@codesyncer-inference   // 추론 내용과 근거
+@codesyncer-decision    // 의논 후 결정 사항
+@codesyncer-todo        // 사용자 확인 필요
+@codesyncer-context     // 비즈니스 맥락 설명
+```
+
+자세한 내용: 각 레포의 `.claude/COMMENT_GUIDE.md`
+
+### 추론 금지 영역
+**절대 추론하지 말고 사용자에게 물어보세요:**
+- 💰 비즈니스 로직 수치 (가격, 수수료, 한도, 할인율)
+- 🔌 API 엔드포인트 URL
+- 🔐 보안 설정 (토큰 만료 시간, 암호화 방식)
+- 🗄️ 데이터베이스 스키마
+- 🌐 외부 서비스 연동 정보
+
+### 의논 필수 키워드
+다음 키워드 감지 시 **자동으로 작업 중단** 후 사용자와 의논:
+- 🔴 **CRITICAL**: 결제, 과금, 인증, 권한, 삭제, 개인정보, GDPR
+- 🟡 **IMPORTANT**: API 연동, DB 스키마, 배포, 캐싱, 이메일
+- 🟢 **MINOR**: 최적화, 테스트, 로깅, UI/UX
+
+자세한 키워드 목록: `.codesyncer/MASTER_CODESYNCER.md`
+
+---
+
+## 🎯 세션 시작 체크리스트
+
+AI가 이 파일을 읽으면:
+
+1. ✅ `.codesyncer/MASTER_CODESYNCER.md` 즉시 읽기
+2. ✅ 전체 레포지토리 구조 파악
+3. ✅ 키워드 매핑 확인
+4. ✅ 준비 완료 메시지 출력:
+
+```
+✅ [PROJECT_NAME] 멀티레포 프로젝트 준비 완료!
+
+📁 레포지토리: [REPO_COUNT]개
+📋 MASTER_CODESYNCER.md 읽음
+🎯 작업 가능 상태
+
+어느 레포에서 작업할까요?
+```
+
+---
+
+## 💡 유용한 명령어
+
+### 네비게이션
+```
+"레포 목록 보여줘"          → MASTER_CODESYNCER.md 기반 레포 나열
+"백엔드로 이동"             → api-server/.claude/CLAUDE.md 읽기
+"프론트엔드로 전환"         → web-client/.claude/CLAUDE.md 읽기
+```
+
+### 문서 업데이트
+```
+"전체 구조 업데이트"        → 모든 레포 ARCHITECTURE.md 갱신
+"의논 기록 확인"            → 각 레포의 DECISIONS.md 확인
+```
+
+### 멀티레포 작업
+```
+"모든 레포에 ESLint 설정"   → 순차적으로 각 레포 작업
+"공통 타입 정의 필요"       → 어느 레포에 둘지 의논
+```
+
+---
+
+## 📚 관련 문서
+
+### 루트 문서
+- **멀티레포 네비게이션**: `.codesyncer/MASTER_CODESYNCER.md` ⭐ **필수**
+- **설정 가이드**: `.codesyncer/SETUP_GUIDE.md` (AI 설정 완료 후 참고용)
+
+### 개별 레포 문서
+각 레포의 `.claude/` 폴더:
+- **CLAUDE.md** - 레포별 코딩 규칙
+- **ARCHITECTURE.md** - 프로젝트 구조
+- **COMMENT_GUIDE.md** - 주석 작성 가이드
+- **DECISIONS.md** - 의논 결정 기록
+
+---
+
+## 🔍 주석 검색 (전체 프로젝트)
+
+```bash
+# 모든 레포에서 TODO 찾기
+grep -r "@codesyncer-todo" ./*/.claude/
+
+# 모든 의논 결정 찾기
+grep -r "@codesyncer-decision" ./*/
+
+# 특정 키워드 찾기
+grep -r "결제" ./*/
+```
+
+---
+
+## ⚠️ 주의사항
+
+1. **레포 전환 시 컨텍스트 전환**
+   - 각 레포는 독립적인 규칙을 가질 수 있음
+   - 반드시 해당 레포의 CLAUDE.md 확인
+
+2. **크로스 레포 의존성**
+   - 여러 레포에 영향 주는 변경은 사용자와 의논
+   - 순서가 중요한 경우 명확히 설명
+
+3. **공통 코드 관리**
+   - 타입 정의, 유틸 함수 등 공통 코드 위치 의논
+   - 중복 방지 전략 수립
+
+---
+
+**버전**: 1.0.0 (Powered by CodeSyncer)
+**AI 도구**: Claude Code 최적화 | 호환: Cursor, GitHub Copilot, Continue.dev
+
+---
+
+*CodeSyncer는 오픈소스입니다: https://github.com/bitjaru/codesyncer*

package/src/templates/ko/setup_guide.md

@@ -158,20 +158,35 @@
 
 ---
 
-## 🌐 4단계: 마스터 문서 생성
+## 🌐 4단계: 루트 문서 생성
 
-워크스페이스 루트에 `.codesyncer/MASTER_CODESYNCER.md` 생성:
+워크스페이스 루트에 다음 파일들을 생성:
 
-### 내용:
-- 모든 레포지토리와 역할 나열
-- 자동 레포지토리 전환 규칙
-- 키워드 기반 네비게이션 매핑
-- 멀티 레포 워크플로우 예시
+### 4.1 CLAUDE.md ⭐ **클로드가 먼저 읽는 파일**
+
+루트에 `CLAUDE.md` 생성 (클로드가 자동으로 찾는 파일):
+
+템플릿 사용: `./templates/[lang]/root_claude.md`
+- [PROJECT_NAME], [GITHUB_USERNAME], [TODAY] 교체
+- [REPO_COUNT]를 실제 레포지토리 개수로 교체
+- 멀티레포 프로젝트임을 명시
+- MASTER_CODESYNCER.md를 먼저 읽으라고 지시
+- 전체 프로젝트 공통 규칙 명시
+
+**중요**: 이 파일이 있어야 클로드가 세션 시작 시 자동으로 컨텍스트를 로드합니다!
+
+### 4.2 .codesyncer/MASTER_CODESYNCER.md
+
+워크스페이스 루트에 `.codesyncer/MASTER_CODESYNCER.md` 생성:
 
 템플릿 사용: `./templates/[lang]/master.md`
 - [REPO_TABLE]을 실제 감지된 레포로 교체
 - [KEYWORD_MAPPING]을 레포별 키워드로 교체
 - [PROJECT_NAME], [GITHUB_USERNAME] 교체
+- 모든 레포지토리와 역할 나열
+- 자동 레포지토리 전환 규칙
+- 키워드 기반 네비게이션 매핑
+- 멀티 레포 워크플로우 예시
 
 ---
 
@@ -183,8 +198,10 @@
 ✅ CodeSyncer 설정 완료!
 
 생성된 파일:
-📁 .codesyncer/
-   └── MASTER_CODESYNCER.md
+📁 루트/
+   ├── CLAUDE.md ⭐ 클로드가 먼저 읽는 파일
+   └── .codesyncer/
+       └── MASTER_CODESYNCER.md
 
 📁 [repo1]/.claude/
    ├── CLAUDE.md
@@ -197,8 +214,10 @@
 
 다음 단계:
 1. 생성된 파일 검토
-2. CLAUDE.md의 프로젝트별 규칙 커스터마이즈
-3. 각 레포에서 "CLAUDE.md 읽어줘"로 개발 시작
+2. 각 레포의 CLAUDE.md 커스터마이즈
+3. 루트 CLAUDE.md 또는 개별 레포 CLAUDE.md 읽고 개발 시작
+
+💡 클로드는 자동으로 루트 CLAUDE.md를 찾아서 읽습니다!
 
 CodeSyncer 사용 준비 완료!
 ```