Skip to content

Commit c85e283

Browse files
YAYLABS-Snooclaude
andcommitted
Release v2.0.0 - AI-Driven Setup Architecture
BREAKING CHANGES: - Removed Quick/Expert setup modes - CodeSyncer now only creates SETUP_GUIDE.md - AI assistants (Claude Code) handle actual documentation generation Features: ✨ New SETUP_GUIDE.md template for AI assistants ✨ Comprehensive keyword categories (CRITICAL/IMPORTANT/MINOR) ✨ Simplified init command (189 lines vs 513 lines) ✨ AI-driven interactive setup process Updates: 📝 README updated to reflect v2.0 workflow 📝 Both English and Korean documentation 🔧 init.ts completely rewritten for framework-only approach Tech Stack: - Enhanced repository scanner with name-based detection - Template-based SETUP_GUIDE generation - Multi-language support (EN/KO) 🤖 Generated with Claude Code https://claude.com/claude-code Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 4918da9 commit c85e283

6 files changed

Lines changed: 783 additions & 497 deletions

File tree

README.ko.md

Lines changed: 39 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -115,42 +115,53 @@ workspace/
115115
codesyncer init
116116
```
117117

118+
다음을 입력합니다:
119+
- 언어 선택 (한글/English)
120+
- 프로젝트 이름
121+
- GitHub 사용자명
122+
118123
**실행 과정:**
119-
1. CodeSyncer가 문서 프레임워크 생성
120-
2. AI 어시스턴트가 각 레포지토리 분석
121-
3. AI가 CodeSyncer 구조에 따라 문서 생성:
122-
- `.codesyncer/MASTER_CODESYNCER.md` (워크스페이스 루트)
123-
- `<repo>/.claude/CLAUDE.md` (코딩 가이드라인)
124-
- `<repo>/.claude/ARCHITECTURE.md` (프로젝트 구조)
125-
- `<repo>/.claude/DECISIONS.md` (의사결정 기록)
126-
- `<repo>/.claude/COMMENT_GUIDE.md` (주석 태그 가이드)
124+
1. CodeSyncer가 레포지토리 스캔
125+
2. 기술 스택과 프로젝트 타입 자동 감지
126+
3. 발견한 레포 정보와 함께 `.codesyncer/SETUP_GUIDE.md` 생성
127127

128-
### 5단계: 설정 모드 선택
128+
**CodeSyncer는 여기까지만 합니다!** 프레임워크와 규칙만 제공하고, 이제 AI가 직접 설정합니다.
129129

130-
**⚡ 퀵 설치** (권장)
131-
- 모든 레포 자동 감지
132-
- 한 번에 협업 시스템 생성
133-
- 모든 의논 키워드 자동 활성화
130+
### 5단계: AI가 모든 설정 완료
134131

135-
**🔧 전문가 설치**
136-
- 모든 옵션 세부 설정
137-
- 특정 키워드 카테고리 선택
138-
- 커스텀 키워드 추가
132+
Claude Code (또는 선호하는 AI 어시스턴트)를 실행하고 다음과 같이 말하세요:
133+
134+
```
135+
".codesyncer/SETUP_GUIDE.md 파일을 읽고 지시사항대로 설정해줘"
136+
```
139137

140-
### 4. 언어 선택
138+
**AI가 수행하는 작업:**
139+
1. **분석**: 실제 코드를 읽고 각 레포지토리 분석
140+
2. **질문**: 중요한 사항은 절대 추론하지 않고 질문합니다:
141+
- API 엔드포인트
142+
- 비즈니스 로직과 가격 정책
143+
- 인증 방식
144+
- 데이터베이스 스키마
145+
- 외부 서비스 연동
146+
3. **문서 생성**: 사용자 답변을 기반으로 생성:
147+
- `.codesyncer/MASTER_CODESYNCER.md` (멀티 레포 네비게이션)
148+
- `<repo>/.claude/CLAUDE.md` (코딩 규칙)
149+
- `<repo>/.claude/ARCHITECTURE.md` (프로젝트 구조)
150+
- `<repo>/.claude/DECISIONS.md` (의사결정 기록)
151+
- `<repo>/.claude/COMMENT_GUIDE.md` (태그 가이드)
141152

142-
한글 또는 English 선택
153+
### 6단계: 코딩 시작!
143154

144-
### 5. 완료!
155+
설정이 완료되면 AI에게 다음과 같이 말하세요:
156+
```
157+
"CLAUDE.md 읽어줘"
158+
```
145159

146-
CodeSyncer가 자동으로:
147-
- 레포 스캔 및 감지 (Java, Python, Node.js, React 등)
148-
- 워크스페이스 루트에 마스터 문서 생성 (`.codesyncer/MASTER_CODESYNCER.md`)
149-
- 각 레포에 협업 파일 생성 (`.claude/` 폴더)
150-
- `CLAUDE.md` - 코딩 가이드라인
151-
- `COMMENT_GUIDE.md` - 주석 태그 사용 가이드
152-
- `ARCHITECTURE.md` - 프로젝트 구조 (자동 업데이트)
153-
- `DECISIONS.md` - 의사결정 기록
160+
AI 어시스턴트가:
161+
- 프로젝트의 코딩 규칙 준수
162+
- 올바른 기술 스택 패턴 사용
163+
- 중요한 결정 전 질문
164+
- 모든 결정을 `@codesyncer-*` 태그로 기록
154165

155166
---
156167

README.md

Lines changed: 39 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -115,42 +115,53 @@ workspace/
115115
codesyncer init
116116
```
117117

118+
You'll be asked:
119+
- Language preference (Korean/English)
120+
- Project name
121+
- GitHub username
122+
118123
**What happens:**
119-
1. CodeSyncer creates the documentation framework
120-
2. Your AI assistant analyzes each repository
121-
3. AI generates documentation following CodeSyncer's structure:
122-
- `.codesyncer/MASTER_CODESYNCER.md` (workspace root)
123-
- `<repo>/.claude/CLAUDE.md` (coding guidelines)
124-
- `<repo>/.claude/ARCHITECTURE.md` (project structure)
125-
- `<repo>/.claude/DECISIONS.md` (decision log)
126-
- `<repo>/.claude/COMMENT_GUIDE.md` (comment tag guide)
124+
1. CodeSyncer scans your repositories
125+
2. Detects tech stacks and project types
126+
3. Creates `.codesyncer/SETUP_GUIDE.md` with discovered repository information
127127

128-
### Step 5: Choose setup mode
128+
**That's all CodeSyncer does!** It provides the framework and rules. Now your AI takes over.
129129

130-
**⚡ Quick Setup** (Recommended)
131-
- Auto-detects all repositories
132-
- Creates collaboration system in one step
133-
- Enables all discussion keywords automatically
130+
### Step 5: Let AI Set Everything Up
134131

135-
**🔧 Expert Setup**
136-
- Full customization options
137-
- Select specific keyword categories
138-
- Add custom keywords
132+
Launch Claude Code (or your preferred AI assistant) and say:
133+
134+
```
135+
"Read .codesyncer/SETUP_GUIDE.md and follow the instructions to set up"
136+
```
139137

140-
### 4. Select language
138+
**What the AI will do:**
139+
1. **Analyze** each repository by reading actual code
140+
2. **Ask you** critical questions (never assumes):
141+
- API endpoints
142+
- Business logic and pricing
143+
- Authentication methods
144+
- Database schemas
145+
- External service integrations
146+
3. **Generate documentation** based on your answers:
147+
- `.codesyncer/MASTER_CODESYNCER.md` (multi-repo navigation)
148+
- `<repo>/.claude/CLAUDE.md` (coding rules)
149+
- `<repo>/.claude/ARCHITECTURE.md` (project structure)
150+
- `<repo>/.claude/DECISIONS.md` (decision log)
151+
- `<repo>/.claude/COMMENT_GUIDE.md` (tag guide)
141152

142-
Choose between Korean (한글) or English
153+
### Step 6: Start Coding!
143154

144-
### 5. That's it!
155+
Once setup is complete, just tell your AI:
156+
```
157+
"Read CLAUDE.md"
158+
```
145159

146-
CodeSyncer will:
147-
- Scan and detect your repositories (Java, Python, Node.js, React, etc.)
148-
- Create master document at workspace root (`.codesyncer/MASTER_CODESYNCER.md`)
149-
- Generate collaboration files in each repo (`.claude/` folder)
150-
- `CLAUDE.md` - Coding guidelines
151-
- `COMMENT_GUIDE.md` - Comment tag usage guide
152-
- `ARCHITECTURE.md` - Project structure (auto-updated)
153-
- `DECISIONS.md` - Decision log
160+
Your AI assistant will then:
161+
- Follow your project's coding rules
162+
- Use the correct tech stack patterns
163+
- Ask before making critical decisions
164+
- Record all decisions with `@codesyncer-*` tags
154165

155166
---
156167

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "codesyncer",
3-
"version": "1.2.0",
3+
"version": "2.0.0",
44
"description": "AI-powered multi-repository collaboration system - Works with Claude Code, Cursor, GitHub Copilot, and more",
55
"keywords": [
66
"ai-collaboration",

0 commit comments

Comments
 (0)