codesyncer 1.0.0

package/dist/templates/ko/comment_guide.md

@@ -0,0 +1,324 @@
+# 주석 작성 가이드
+
+> **CodeSyncer 주석 시스템** - 모든 추론과 결정을 영구 기록
+
+---
+
+## 📋 주석 태그 레퍼런스
+
+### 5가지 필수 태그
+
+| 태그 | 용도 | 사용 시점 | 중요도 |
+|------|------|-----------|--------|
+| `@codesyncer-rule` | 특별 규칙 | 일반적이지 않은 구현 방식 | ⭐⭐⭐ |
+| `@codesyncer-inference` | 추론 내용 | AI가 추론한 내용과 근거 | ⭐⭐⭐⭐⭐ |
+| `@codesyncer-decision` | 결정 사항 | 의논 후 결정된 내용 | ⭐⭐⭐⭐⭐ |
+| `@codesyncer-todo` | TODO | 사용자 확인 필요 | ⭐⭐⭐⭐ |
+| `@codesyncer-context` | 비즈니스 맥락 | 도메인 지식, 배경 설명 | ⭐⭐⭐ |
+
+### 레거시 호환
+
+기존 `@claude-*` 태그도 완전히 호환됩니다:
+```typescript
+@claude-rule        = @codesyncer-rule
+@claude-inference   = @codesyncer-inference
+@claude-decision    = @codesyncer-decision
+@claude-todo        = @codesyncer-todo
+@claude-context     = @codesyncer-context
+```
+
+---
+
+## 📝 주석 레벨
+
+### 1. 📄 파일 레벨 (JSDoc)
+
+**언제**: 파일 최상단, 모듈 전체 설명
+
+```typescript
+/**
+ * User authentication service
+ *
+ * @codesyncer-context JWT 기반 인증 시스템
+ * @codesyncer-rule 토큰은 httpOnly 쿠키에 저장 (XSS 방지)
+ * @author CodeSyncer
+ * @date 2024-10-17
+ */
+```
+
+### 2. 🔧 함수/클래스/컴포넌트 레벨
+
+**언제**: 각 함수, 클래스, 컴포넌트 정의 위
+
+```tsx
+/**
+ * 주문 생성 폼
+ *
+ * @codesyncer-context 6단계 주문 프로세스
+ * @codesyncer-inference 각 단계마다 자동 저장 (일반적인 UX 패턴)
+ * @codesyncer-decision [2024-10-15] Zustand로 상태 관리 (복잡한 폼 상태)
+ */
+export default function OrderForm() {
+  // ...
+}
+```
+
+### 3. 📝 인라인 레벨
+
+**언제**: 코드 라인 위 또는 옆
+
+```typescript
+// @codesyncer-inference: 페이지 크기 20 (일반적인 테이블 UX)
+const PAGE_SIZE = 20;
+
+// @codesyncer-todo: mainApi 엔드포인트 URL 확인 필요
+const API_URL = '/api/temp';
+
+// @codesyncer-decision: [2024-10-17] Soft Delete (30일 복구 가능)
+async function deleteUser(id: string) {
+  // @codesyncer-inference: deleted_at 플래그 사용 (복구 기능용)
+  return db.update(id, { deleted_at: new Date() });
+}
+
+const maxRetry = 3; // @codesyncer-inference: 3회 재시도 (안정성)
+```
+
+---
+
+## ✅ 좋은 주석 예시
+
+### 예시 1: 비즈니스 로직
+
+```tsx
+/**
+ * 배송비 계산 함수
+ *
+ * @codesyncer-context 배송비 정책
+ * - 3만원 이상: 무료 배송
+ * - 3만원 미만: 3,000원
+ * - 제주/도서산간: +3,000원
+ *
+ * @codesyncer-decision [2024-10-10] 정책 확정 (마케팅팀 협의)
+ * @codesyncer-rule 정책 변경 시 반드시 마케팅팀 승인 필요
+ */
+function calculateShippingFee(orderAmount: number, region: string): number {
+  // @codesyncer-inference: 3만원 기준 (업계 표준)
+  const FREE_SHIPPING_THRESHOLD = 30000;
+
+  // @codesyncer-decision: [2024-10-10] 기본 배송비 3,000원
+  const BASIC_FEE = 3000;
+
+  // @codesyncer-todo: 제주/도서산간 지역 목록 확인 필요
+  const EXTRA_FEE_REGIONS = ['제주', '울릉도'];
+
+  if (orderAmount >= FREE_SHIPPING_THRESHOLD) {
+    return 0;
+  }
+
+  const baseFee = BASIC_FEE;
+  const extraFee = EXTRA_FEE_REGIONS.includes(region) ? 3000 : 0;
+
+  return baseFee + extraFee;
+}
+```
+
+### 예시 2: 데이터 구조
+
+```tsx
+/**
+ * 사용자 인터페이스
+ *
+ * @codesyncer-context GDPR 준수 필요
+ * @codesyncer-rule 개인정보는 암호화 저장
+ */
+interface User {
+  id: string;
+
+  // @codesyncer-inference: email을 username으로 사용 (일반적 패턴)
+  email: string;
+
+  // @codesyncer-decision: [2024-10-12] bcrypt 해싱 (보안팀 권고)
+  passwordHash: string;
+
+  // @codesyncer-context: Soft Delete용
+  // @codesyncer-decision: [2024-10-15] 30일 후 완전 삭제 (GDPR)
+  deletedAt?: Date;
+
+  createdAt: Date;
+  updatedAt: Date;
+}
+```
+
+### 예시 3: 컴포넌트
+
+```tsx
+/**
+ * 주문 목록 테이블 컴포넌트
+ *
+ * @codesyncer-context 고객용 주문 내역 조회
+ * @codesyncer-inference 페이지네이션 필요 (대량 데이터)
+ * @codesyncer-decision [2024-10-16] TanStack Table 사용 (성능)
+ */
+export function OrderListTable({ orders }: OrderListTableProps) {
+  // @codesyncer-inference: 페이지당 20개 (UX 표준)
+  const [pageSize, setPageSize] = useState(20);
+
+  // @codesyncer-todo: 정렬 옵션 추가 (날짜, 금액, 상태)
+
+  return (
+    <Table>
+      {/* @codesyncer-rule: 모바일에서는 카드 레이아웃으로 변경 */}
+      {/* ... */}
+    </Table>
+  );
+}
+```
+
+---
+
+## ❌ 나쁜 주석 예시
+
+### 피해야 할 주석들
+
+```tsx
+// ❌ 너무 모호함
+// @codesyncer-inference: 이렇게 했음
+const value = 10;
+
+// ❌ 근거 없음
+// @codesyncer-decision: 변경함
+const API_URL = '/api/new';
+
+// ❌ 의미 없음
+// @codesyncer-todo: 나중에
+function doSomething() {}
+
+// ❌ 맥락 부족
+// @codesyncer-context: 중요함
+const IMPORTANT_VALUE = 42;
+```
+
+### 개선된 버전
+
+```tsx
+// ✅ 구체적인 근거
+// @codesyncer-inference: 기본값 10 (일반적인 재시도 대기 시간)
+const RETRY_DELAY = 10;
+
+// ✅ 명확한 이유와 날짜
+// @codesyncer-decision: [2024-10-17] /api/v2로 변경 (API 버전업)
+const API_URL = '/api/v2';
+
+// ✅ 구체적인 TODO
+// @codesyncer-todo: 에러 케이스 핸들링 추가 (네트워크 오류, 타임아웃)
+function fetchData() {}
+
+// ✅ 비즈니스 맥락 설명
+// @codesyncer-context: VAT 세율 (2024년 기준 10%)
+const TAX_RATE = 0.1;
+```
+
+---
+
+## 🔍 주석 검색
+
+### Bash 명령어
+
+```bash
+# 모든 추론 내용 찾기
+grep -r "@codesyncer-inference" ./src
+
+# TODO 목록 확인
+grep -r "@codesyncer-todo" ./src
+
+# 의논 결정 사항
+grep -r "@codesyncer-decision" ./src
+
+# 특별 규칙
+grep -r "@codesyncer-rule" ./src
+
+# 비즈니스 맥락
+grep -r "@codesyncer-context" ./src
+```
+
+### VS Code 검색
+
+1. `Cmd/Ctrl + Shift + F` (전체 검색)
+2. 검색어 입력: `@codesyncer-todo`
+3. 파일 필터: `src/**/*.{ts,tsx,js,jsx}`
+
+---
+
+## 📊 주석 통계
+
+ARCHITECTURE.md에서 자동으로 통계를 제공합니다:
+
+```markdown
+## 주석 태그 통계
+- @codesyncer-inference: 45개
+- @codesyncer-decision: 12개
+- @codesyncer-todo: 8개
+- @codesyncer-rule: 5개
+- @codesyncer-context: 15개
+```
+
+"통계 업데이트" 명령으로 수동 갱신 가능
+
+---
+
+## 💡 주석 작성 팁
+
+### 1. 추론은 항상 근거와 함께
+
+```tsx
+// ❌ @codesyncer-inference: useState 사용
+// ✅ @codesyncer-inference: useState 사용 (간단한 로컬 상태, Zustand 불필요)
+```
+
+### 2. 결정은 날짜와 이유
+
+```tsx
+// ❌ @codesyncer-decision: Stripe 사용
+// ✅ @codesyncer-decision: [2024-10-15] Stripe 사용 (해외 결제 지원 필요)
+```
+
+### 3. TODO는 구체적으로
+
+```tsx
+// ❌ @codesyncer-todo: 수정 필요
+// ✅ @codesyncer-todo: 에러 바운더리 추가 (API 실패 시 폴백 UI)
+```
+
+### 4. 맥락은 "왜"에 집중
+
+```tsx
+// ❌ @codesyncer-context: 인증
+// ✅ @codesyncer-context: OAuth 2.0 인증 (Google, Kakao 로그인 지원)
+```
+
+### 5. 규칙은 예외적인 경우만
+
+```tsx
+// ❌ @codesyncer-rule: TypeScript 사용 (이건 당연함)
+// ✅ @codesyncer-rule: 이 파일만 any 타입 허용 (외부 라이브러리 타입 없음)
+```
+
+---
+
+## 🎯 체크리스트
+
+코드 작성 후 확인:
+
+- [ ] 추론한 내용에 `@codesyncer-inference` 추가했나?
+- [ ] 의논 결정은 `@codesyncer-decision`으로 기록했나?
+- [ ] 확인 필요한 부분은 `@codesyncer-todo`로 표시했나?
+- [ ] 비즈니스 로직에 `@codesyncer-context` 설명했나?
+- [ ] 특별한 규칙은 `@codesyncer-rule`로 명시했나?
+- [ ] 모든 주석에 구체적인 근거를 포함했나?
+
+---
+
+**버전**: 1.0.0
+**마지막 업데이트**: [TODAY]
+
+*이 주석 시스템으로 모든 의사결정이 코드에 영구 기록됩니다.*

package/dist/templates/ko/decisions.md

@@ -0,0 +1,227 @@
+# DECISIONS.md - 의논 결정 기록
+
+> **의사결정 로그** - 모든 중요 결정을 영구 기록
+>
+> 생성일: [TODAY]
+
+---
+
+## 📋 기록 형식
+
+모든 의논 결정은 다음 형식으로 자동 기록됩니다:
+
+```markdown
+---
+### [날짜] - [주제]
+**카테고리**: [CRITICAL/IMPORTANT/MINOR]
+**결정**: [결정 내용]
+**이유**: [결정 이유]
+**대안**: [고려했던 다른 옵션들]
+**결정자**: [사용자명 또는 팀명]
+**코드 위치**: [파일 경로:라인]
+**관련 이슈**: [이슈 번호 또는 링크]
+---
+```
+
+---
+
+## 📝 결정 기록
+
+<!-- 의논 시 자동으로 여기에 추가됩니다 -->
+
+### 예시 기록
+
+---
+### 2024-10-17 - 데이터 삭제 방식 선택
+**카테고리**: CRITICAL
+**결정**: Soft Delete 방식 사용
+**이유**:
+- 30일 복구 기간 필요 (고객 요청 대응)
+- 통계 데이터 유지
+- GDPR 준수 (30일 후 완전 삭제)
+**대안**:
+- Hard Delete: 즉시 삭제 (복구 불가)
+- Archive: 별도 테이블로 이동 (복잡도 증가)
+**결정자**: 개발팀 + 기획팀 협의
+**코드 위치**: `src/services/UserService.ts:45`
+**관련 이슈**: #123
+---
+
+---
+
+## 📊 카테고리별 통계
+
+- **CRITICAL**: 0건 (결제, 보안, 데이터 삭제 등)
+- **IMPORTANT**: 0건 (비즈니스 로직, 가격, 외부 연동 등)
+- **MINOR**: 0건 (UI/UX, 성능 최적화 등)
+
+**총 결정**: 0건
+
+---
+
+## 🔍 카테고리 설명
+
+### CRITICAL (필수 의논)
+- 💰 결제/과금 관련
+- 🔐 인증/권한/보안
+- 🗑️ 데이터 삭제/마이그레이션
+- 📜 개인정보/법적 규정
+
+### IMPORTANT (권장 의논)
+- 💵 가격/비즈니스 로직
+- 🔌 외부 API 연동
+- 🚀 배포/인프라 변경
+
+### MINOR (선택적 의논)
+- 🎨 UI/UX 개선
+- ⚡ 성능 최적화
+- 📦 라이브러리 변경
+
+---
+
+## 🔗 연관 문서
+
+의논 결정은 코드에도 주석으로 기록됩니다:
+
+```tsx
+/**
+ * @codesyncer-decision: [2024-10-17] Soft Delete 방식
+ * 이유: 30일 복구 가능, GDPR 준수
+ */
+async function deleteUser(id: string) {
+  return db.update(id, { deleted_at: new Date() });
+}
+```
+
+**검색**: `grep -r "@codesyncer-decision" ./src`
+
+---
+
+## 📅 월별 통계
+
+### 2024년 10월
+- 총 결정: 0건
+- CRITICAL: 0건
+- IMPORTANT: 0건
+- MINOR: 0건
+
+---
+
+## 💡 의논 프로세스
+
+### 1. 키워드 자동 감지
+AI가 다음 키워드 감지 시 자동 중단:
+- 결제, 인증, 삭제, 가격 등
+
+### 2. 옵션 제시
+```
+⚠️ '결제' 키워드 감지. 의논이 필요합니다.
+
+💡 추천안:
+Stripe 사용
+
+🔄 대안:
+A. Iamport (아임포트)
+B. Toss Payments
+C. 직접 구현
+
+어떻게 진행할까요?
+```
+
+### 3. 사용자 응답
+- "진행" → 추천안 채택
+- "대안 A" → 대안 선택
+- "보류" → 나중에 결정
+
+### 4. 자동 기록
+- DECISIONS.md에 추가
+- 코드에 `@codesyncer-decision` 주석
+- ARCHITECTURE.md 통계 업데이트
+
+---
+
+## 🎯 베스트 프랙티스
+
+### ✅ 좋은 결정 기록
+
+```markdown
+### 2024-10-15 - 결제 시스템 선택
+**카테고리**: CRITICAL
+**결정**: Stripe 사용
+**이유**:
+- 해외 결제 지원 필요
+- 구독 결제 기능 내장
+- 안정적인 서비스
+**대안**:
+- Iamport: 국내 전용 (해외 결제 불가)
+- Toss: 아직 구독 기능 미흡
+**결정자**: CTO + 개발팀
+**코드 위치**: `src/services/PaymentService.ts`
+```
+
+### ❌ 나쁜 결정 기록
+
+```markdown
+### 어제 - 뭔가 결정
+**카테고리**: 중요함
+**결정**: 이걸로 함
+**이유**: 그냥
+```
+
+---
+
+## 🔄 자동 업데이트
+
+이 문서는 다음 상황에서 자동 업데이트됩니다:
+
+1. **의논 필수 키워드** 감지 후 결정
+2. 사용자가 명시적으로 의논 요청
+3. `@codesyncer-decision` 태그 추가 시
+
+**수동 추가**: 직접 위 형식으로 작성 가능
+
+---
+
+## 📚 검색
+
+### 최근 결정 찾기
+```bash
+# 최근 10개 결정
+tail -n 50 .claude/DECISIONS.md
+
+# 특정 카테고리
+grep "CRITICAL" .claude/DECISIONS.md
+
+# 특정 날짜
+grep "2024-10-" .claude/DECISIONS.md
+```
+
+### 코드에서 결정 찾기
+```bash
+# 모든 결정 주석
+grep -r "@codesyncer-decision" ./src
+
+# 특정 파일의 결정
+grep "@codesyncer-decision" src/services/PaymentService.ts
+```
+
+---
+
+## 🤝 팀 협업
+
+### 새 팀원 온보딩
+1. 이 파일을 처음부터 읽기
+2. 주요 결정 사항 파악
+3. "왜 이렇게 구현했는지" 이해
+
+### 결정 리뷰
+- 월 1회 팀 회의에서 리뷰
+- 재검토 필요한 결정 표시
+- 변경된 결정은 새 항목으로 추가
+
+---
+
+**버전**: 1.0.0
+**마지막 업데이트**: [TODAY]
+
+*모든 중요한 의사결정이 영구 기록됩니다. 팀의 지식 자산입니다.*

package/dist/templates/ko/master.md

@@ -0,0 +1,179 @@
+# 🤖 [PROJECT_NAME] 멀티 레포 자동 전환 시스템
+
+> 기능 요청만 하면 AI 코딩 어시스턴트가 알아서 필요한 레포를 찾아가서 작업합니다.
+>
+> **Powered by CodeSyncer** - AI-agnostic multi-repository collaboration system
+
+---
+
+## 🎯 핵심 동작 원리
+
+### 자동 레포 감지 및 전환
+사용자가 기능을 요청하면 AI 어시스턴트가 자동으로:
+1. 요청 분석 → 필요한 레포 파악
+2. 해당 레포로 자동 이동
+3. 각 레포의 CLAUDE.md 규칙 적용
+4. 작업 수행
+
+## 📁 프로젝트 레포 구성
+
+| 레포 | 폴더명 | 역할 | 규칙 파일 위치 |
+|------|--------|------|---------------|
+[REPO_TABLE]
+
+## 🧠 자동 레포 선택 규칙
+
+### 키워드 기반 자동 판단
+| 키워드 | 이동할 레포 | 자동 실행 명령 |
+|--------|------------|---------------|
+[KEYWORD_MAPPING]
+
+### 작업 유형별 자동 판단
+```javascript
+function 레포_자동_선택(사용자_요청) {
+  // API 수정 필요한가?
+  if (요청.match(/API|데이터|서버|인증|DB/)) {
+    작업_레포.push("백엔드 레포");
+  }
+
+  // UI 수정 필요한가?
+  if (요청.match(/페이지|화면|버튼|폼|UI/)) {
+    작업_레포.push("프론트 레포");
+  }
+
+  // 여러 레포 작업 필요한가?
+  if (요청.includes("기능") && !특정_레포_명시) {
+    // 백엔드 → 프론트 → 모바일 순서로
+    return ["백엔드", "프론트", "모바일"];
+  }
+
+  return 작업_레포;
+}
+```
+
+## 🔄 자동 전환 프로토콜
+
+### 단일 레포 작업
+
+```bash
+User: "로그인 API 만들어줘"
+
+AI 자동 동작:
+1. 키워드 "API" 감지
+2. cd [백엔드 폴더]
+3. cat CLAUDE.md  # 백엔드 규칙 로드
+4. [백엔드 규칙에 따라 API 생성]
+5. "✅ [백엔드 레포]에 로그인 API 생성 완료"
+```
+
+### 멀티 레포 작업
+
+```bash
+User: "결제 기능 추가해줘"
+
+AI 자동 동작:
+1. "기능" 키워드 → 여러 레포 필요 판단
+2. 작업 순서 결정:
+   - 1단계: [백엔드] - API
+   - 2단계: [프론트] - UI
+   - 3단계: [모바일] - 앱화면
+
+3. 순차 작업:
+   cd [백엔드 폴더] && cat CLAUDE.md
+   → 결제 API 생성
+
+   cd ../[프론트 폴더] && cat CLAUDE.md
+   → 결제 페이지 생성
+
+   cd ../[모바일 폴더] && cat CLAUDE.md
+   → 결제 화면 생성
+
+4. "✅ 결제 기능 전체 구현 완료"
+```
+
+## ⚠️ 중요 규칙
+
+### 레포 이동 시 반드시
+
+1. 현재 위치 확인: `pwd`
+2. 대상 레포로 이동: `cd ../[레포명]`
+3. 규칙 파일 로드: `cat CLAUDE.md || cat .claude/CLAUDE.md`
+4. 해당 규칙 적용 알림: "📁 [레포명] 규칙 적용됨"
+5. 해당 레포 규칙으로 작업 수행
+
+### 우선순위
+
+1. 사용자가 명시한 레포 > 자동 판단
+2. 각 레포의 CLAUDE.md > 이 마스터 문서
+3. 백엔드 작업 > 프론트/모바일 작업 (순서)
+
+## 🚀 사용법
+
+### 세션 시작
+
+```
+"[PROJECT_NAME] 멀티 레포 모드 시작"
+→ 이 문서 로드
+→ 자동 전환 시스템 활성화
+```
+
+### 작업 요청 (사용자는 레포 몰라도 됨)
+
+```
+"사용자 관리 추가" → 자동으로 필요한 모든 레포 작업
+"버그 수정" → 관련 레포 자동 탐색
+"로그인 페이지만" → 프론트 레포만 작업
+```
+
+## 📊 작업 로그 형식
+
+```yaml
+요청: "[사용자 요청 내용]"
+분석:
+  필요_레포: [[레포1], [레포2]]
+  작업_순서: [백엔드 → 프론트]
+수행:
+  [레포1]:
+    이동: cd [폴더]
+    규칙: CLAUDE.md 적용
+    작업: [수행 내용]
+    결과: ✅
+  [레포2]:
+    이동: cd [폴더]
+    규칙: CLAUDE.md 적용
+    작업: [수행 내용]
+    결과: ✅
+완료: "[요약]"
+```
+
+---
+
+## 🏷️ 주석 태그 시스템
+
+CodeSyncer는 두 가지 태그 형식을 모두 지원합니다:
+
+- **`@codesyncer-*`** (권장): 새로운 표준, 모든 AI 도구 호환
+- **`@claude-*`** (레거시): 기존 Claude Code 프로젝트 호환
+
+### 사용 가능한 태그
+
+```typescript
+@codesyncer-rule        // 특별 규칙 (@claude-rule 호환)
+@codesyncer-inference   // 추론 내용과 근거 (@claude-inference 호환)
+@codesyncer-decision    // 의논 결정 사항 (@claude-decision 호환)
+@codesyncer-todo        // 확인 필요 (@claude-todo 호환)
+@codesyncer-context     // 비즈니스 맥락 (@claude-context 호환)
+```
+
+두 형식 모두 동일하게 작동하므로 편한 것을 사용하세요!
+
+---
+
+**GitHub**: https://github.com/[GITHUB_USERNAME]/[PROJECT_NAME]
+**버전**: 1.0.0 (Powered by CodeSyncer)
+**생성일**: [TODAY]
+
+---
+
+*CodeSyncer - AI-powered multi-repository collaboration system*
+*현재 지원: Claude Code | 향후 지원 예정: Cursor, GitHub Copilot, Continue.dev*