Clarify CodeSyncer's role: Framework provider for AI-assisted setup

- Updated README to clearly explain the workflow:
  1. Install CodeSyncer
  2. Launch AI assistant (Claude Code, etc.)
  3. Run codesyncer init
  4. AI analyzes and generates docs following CodeSyncer's structure

- Added 'Prerequisites' section emphasizing AI requirement
- Clarified that CodeSyncer provides WHERE/HOW, AI provides WHAT
- Updated Quick Start to show step-by-step process
- Both English and Korean READMEs updated

CodeSyncer is a framework/structure provider, not a standalone analyzer.
AI assistants do the actual code analysis and content generation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: YAYLABS-Snoo

README.ko.md

@@ -13,7 +13,15 @@
 
 ## 🎯 CodeSyncer란?
 
-CodeSyncer는 여러 레포지토리에서 AI 코딩 어시스턴트와 효율적으로 협업할 수 있도록 도와주는 CLI 도구입니다. 프로젝트 구조, 코딩 규칙, 비즈니스 결정 사항을 체계적으로 문서화하여 AI가 이해할 수 있게 만듭니다.
+CodeSyncer는 AI 코딩 어시스턴트(Claude Code 등)가 멀티 레포지토리 워크스페이스에 지능형 협업 시스템을 구축할 수 있도록 **프레임워크와 규칙**을 제공합니다.
+
+**작동 방식:**
+1. **사용자가** CodeSyncer CLI 설치
+2. **사용자가** AI 어시스턴트 실행 (Claude Code, Cursor 등)
+3. **사용자가** `codesyncer init` 실행
+4. **AI가** 프로젝트를 분석하고 CodeSyncer 구조에 따라 문서 생성
+
+CodeSyncer는 문서가 **어디에, 어떻게** 만들어져야 하는지 정의합니다. AI 어시스턴트는 실제 코드를 분석하여 **무엇을** 작성할지 결정합니다.
 
 ### 주요 기능
 
@@ -26,6 +34,20 @@ CodeSyncer는 여러 레포지토리에서 AI 코딩 어시스턴트와 효율
 
 ---
 
+## ⚠️ 사전 요구사항
+
+**CodeSyncer는 AI 코딩 어시스턴트가 활성화되어 있어야 합니다.**
+
+현재 지원:
+- ✅ **Claude Code** (권장)
+- 🚧 Cursor (곧 지원 예정)
+- 🚧 GitHub Copilot (곧 지원 예정)
+- 🚧 Continue.dev (곧 지원 예정)
+
+**중요**: CodeSyncer를 사용하기 전에 AI 코딩 어시스턴트를 **실행하고 활성화**해주세요. AI가 프로젝트를 분석하고 정확한 문서를 생성하는 데 도움을 줍니다.
+
+---
+
 ## 📦 설치
 
 ```bash
@@ -57,7 +79,23 @@ npm install -g codesyncer@latest
 
 ## 🚀 빠른 시작
 
-### 1. 워크스페이스 루트로 이동
+### 1단계: CodeSyncer 설치
+
+```bash
+npm install -g codesyncer
+```
+
+### 2단계: AI 어시스턴트 실행
+
+AI 코딩 어시스턴트를 실행하세요:
+- **Claude Code** (권장)
+- Cursor
+- GitHub Copilot
+- 또는 다른 AI 코딩 도구
+
+반드시 **활성화되어 실행 중**이어야 합니다.
+
+### 3단계: 워크스페이스로 이동
 
 ```bash
 cd /path/to/your/workspace
@@ -71,13 +109,23 @@ workspace/
 └── mobile/
 ```
 
-### 2. 초기화 실행
+### 4단계: CodeSyncer 초기화
 
 ```bash
 codesyncer init
 ```
 
-### 3. 설치 모드 선택
+**실행 과정:**
+1. CodeSyncer가 문서 프레임워크 생성
+2. AI 어시스턴트가 각 레포지토리 분석
+3. AI가 CodeSyncer 구조에 따라 문서 생성:
+   - `.codesyncer/MASTER_CODESYNCER.md` (워크스페이스 루트)
+   - `<repo>/.claude/CLAUDE.md` (코딩 가이드라인)
+   - `<repo>/.claude/ARCHITECTURE.md` (프로젝트 구조)
+   - `<repo>/.claude/DECISIONS.md` (의사결정 기록)
+   - `<repo>/.claude/COMMENT_GUIDE.md` (주석 태그 가이드)
+
+### 5단계: 설정 모드 선택
 
 **⚡ 퀵 설치** (권장)
 - 모든 레포 자동 감지

README.md

@@ -13,7 +13,15 @@
 
 ## 🎯 What is CodeSyncer?
 
-CodeSyncer is a CLI tool that sets up an intelligent collaboration system between you and AI coding assistants across multiple repositories. It helps AI understand your project structure, coding standards, and business decisions through a structured documentation system.
+CodeSyncer provides the **framework and rules** for AI coding assistants (like Claude Code) to set up an intelligent collaboration system across your multi-repository workspace.
+
+**How it works:**
+1. **You install** CodeSyncer CLI
+2. **You launch** your AI assistant (Claude Code, Cursor, etc.)
+3. **You run** `codesyncer init`
+4. **AI analyzes** your projects and generates documentation following CodeSyncer's structure
+
+CodeSyncer defines **WHERE** and **HOW** documentation should be created. Your AI assistant fills in the **WHAT** by analyzing your actual code.
 
 ### Key Features
 
@@ -26,6 +34,20 @@ CodeSyncer is a CLI tool that sets up an intelligent collaboration system betwee
 
 ---
 
+## ⚠️ Prerequisites
+
+**CodeSyncer requires an AI coding assistant to be active.**
+
+Currently supported:
+- ✅ **Claude Code** (Recommended)
+- 🚧 Cursor (Coming soon)
+- 🚧 GitHub Copilot (Coming soon)
+- 🚧 Continue.dev (Coming soon)
+
+**Important**: Make sure your AI coding assistant is **running and active** before using CodeSyncer. The AI will analyze your projects and help generate accurate documentation.
+
+---
+
 ## 📦 Installation
 
 ```bash
@@ -57,7 +79,23 @@ npm install -g codesyncer@latest
 
 ## 🚀 Quick Start
 
-### 1. Navigate to your workspace root
+### Step 1: Install CodeSyncer
+
+```bash
+npm install -g codesyncer
+```
+
+### Step 2: Launch your AI assistant
+
+Open your AI coding assistant:
+- **Claude Code** (Recommended)
+- Cursor
+- GitHub Copilot
+- Or any other AI coding tool
+
+Make sure it's **active and running**.
+
+### Step 3: Navigate to your workspace
 
 ```bash
 cd /path/to/your/workspace
@@ -71,13 +109,23 @@ workspace/
 └── mobile/
 ```
 
-### 2. Run initialization
+### Step 4: Initialize CodeSyncer
 
 ```bash
 codesyncer init
 ```
 
-### 3. Choose setup mode
+**What happens:**
+1. CodeSyncer creates the documentation framework
+2. Your AI assistant analyzes each repository
+3. AI generates documentation following CodeSyncer's structure:
+   - `.codesyncer/MASTER_CODESYNCER.md` (workspace root)
+   - `<repo>/.claude/CLAUDE.md` (coding guidelines)
+   - `<repo>/.claude/ARCHITECTURE.md` (project structure)
+   - `<repo>/.claude/DECISIONS.md` (decision log)
+   - `<repo>/.claude/COMMENT_GUIDE.md` (comment tag guide)
+
+### Step 5: Choose setup mode
 
 **⚡ Quick Setup** (Recommended)
 - Auto-detects all repositories