codesyncer 3.1.1 → 3.3.0

package/dist/templates/ko/claude.md

@@ -1,5 +1,5 @@
 <!-- codesyncer-section-start:header -->
-# CLAUDE.md - [PROJECT_NAME] 코딩 가이드 v3.0
+# CLAUDE.md - [PROJECT_NAME] 코딩 가이드 v3.2
 
 > **Powered by CodeSyncer** - AI 협업 시스템
 
@@ -13,6 +13,26 @@ CodeSyncer는 @codesyncer-* 태그를 통해 AI 세션 간 맥락을 유지합
 
 ---
 
+## ⚡ TL;DR (3줄 요약)
+
+```
+1. 태그 필수: 추론→@codesyncer-inference, 결정→@codesyncer-decision
+2. 💰결제/🔐보안/🔌API → 무조건 물어보기
+3. 확실하지 않으면 → 물어보기
+```
+
+---
+
+## ❌ DO NOT (절대 금지)
+
+- 가격/수수료 추론 금지
+- API URL 추측 금지
+- 보안 설정 임의 변경 금지
+- 태그 없는 코드 작성 금지
+- 확인 없이 파일 삭제 금지
+
+---
+
 ## 🧠 왜 이 시스템을 쓰나요?
 
 **문제**: AI는 세션이 끝나면 모든 맥락을 잊습니다.
@@ -27,18 +47,6 @@ CodeSyncer는 @codesyncer-* 태그를 통해 AI 세션 간 맥락을 유지합
 ```
 → 다음 세션에서 AI가 코드를 읽으면 **자동으로 맥락 복구**
 
----
-
-## ⚡ TL;DR (절대 잊지 말 것)
-
-```
-1. 추론하면 → // @codesyncer-inference: [이유]
-2. 결정하면 → // @codesyncer-decision: [날짜] [내용]
-3. 💰가격/🔐보안/🔌API → 무조건 물어보기
-4. 모든 코드에 태그 필수 (태그 없는 코드 금지)
-5. 확실하지 않으면 → 물어보기
-```
-
 ---
 <!-- codesyncer-section-end:header -->
 
@@ -237,14 +245,21 @@ async function deleteUser(id: string) {
 ---
 
 <!-- codesyncer-section-start:session-checklist -->
-## 💡 세션 시작 시 체크리스트
+## 🔍 세션 시작 시 체크리스트
 
-AI가 이 파일을 읽으면 자동으로:
+**Git 상태 확인** (현재 작업 맥락 파악):
+```bash
+git branch      # 현재 브랜치 확인
+git status      # 변경사항 확인
+git log -3      # 최근 커밋 3개 확인
+```
 
-1. ✅ **도움말 표시** - 사용 가능한 명령어 안내
-2. ✅ **프로젝트 구조 파악** - ARCHITECTURE.md 확인
-3. ✅ **최근 의논 확인** - DECISIONS.md 확인
-4. ✅ **준비 완료 메시지** - "준비되었습니다!"
+**문서 확인**:
+1. ✅ **CLAUDE.md** - 이 파일의 규칙 확인
+2. ✅ **ARCHITECTURE.md** - 프로젝트 구조 파악
+3. ✅ **DECISIONS.md** - 최근 결정 사항 확인
+
+**준비 완료**: "준비되었습니다!"
 <!-- codesyncer-section-end:session-checklist -->
 
 ---
@@ -260,6 +275,97 @@ AI가 이 파일을 읽으면 자동으로:
 
 ---
 
+<!-- codesyncer-section-start:subfolder-guide -->
+## 📂 서브폴더 CLAUDE.md (코드가 커지면)
+
+프로젝트가 커지면 폴더별로 CLAUDE.md를 추가하세요:
+
+```
+project/
+├── CLAUDE.md              # 전체 규칙
+├── src/
+│   ├── payment/
+│   │   └── CLAUDE.md      # 결제 관련 규칙 + 태그 리마인드
+│   └── auth/
+│       └── CLAUDE.md      # 인증 관련 규칙
+```
+
+AI가 해당 폴더에 진입하면 자동으로 읽습니다.
+
+### 서브폴더 CLAUDE.md 예시
+```markdown
+# CLAUDE.md - payment
+
+## 📌 이 폴더의 역할
+결제 처리 및 정산 관련 코드
+
+## ⚠️ CodeSyncer 리마인드
+- 추론 → @codesyncer-inference
+- 결정 → @codesyncer-decision
+- 💰결제/🔐보안 → 물어보기
+
+## 🚫 Do Not Touch
+- `generated/` - 자동 생성 파일
+```
+<!-- codesyncer-section-end:subfolder-guide -->
+
+---
+
+<!-- codesyncer-section-start:do-not-touch -->
+## 🚫 Do Not Touch (수정 금지 영역)
+
+다음 파일/폴더는 수정하지 마세요:
+
+| 경로 | 이유 |
+|------|------|
+| `src/generated/` | 자동 생성 파일 |
+| `src/legacy/` | 마이그레이션 전까지 수정 금지 |
+| `.env*` | 환경 변수, 직접 수정 금지 |
+
+> 💡 프로젝트에 맞게 이 섹션을 수정하세요
+<!-- codesyncer-section-end:do-not-touch -->
+
+---
+
+<!-- codesyncer-section-start:multi-repo -->
+## 🔗 멀티 레포 작업
+
+### Git 브랜치 = 작업 ID
+브랜치명을 작업 ID로 사용하세요:
+- `feature/AUTH-001-login`
+- `fix/PAY-002-webhook`
+
+### 크로스 레포 태그
+여러 레포에 걸친 작업은 같은 태그 사용:
+```typescript
+// frontend 레포
+// @codesyncer-work:AUTH-001 로그인 폼
+
+// backend 레포
+// @codesyncer-work:AUTH-001 로그인 API
+```
+
+검색: `grep -r "@codesyncer-work:AUTH-001" ../`
+
+### 연관 레포
+
+| 레포 | 역할 | 경로 |
+|------|------|------|
+| - | - | - |
+
+> 💡 프로젝트에 맞게 이 테이블을 수정하세요
+<!-- codesyncer-section-end:multi-repo -->
+
+---
+
+<!-- codesyncer-section-start:hooks -->
+## 🪝 Hooks (자동 리마인드)
+
+[HOOKS_GUIDE]
+<!-- codesyncer-section-end:hooks -->
+
+---
+
 <!-- codesyncer-section-start:footer -->
 ## 🔍 주석 검색
 
@@ -292,4 +398,4 @@ grep -r "@codesyncer-rule" ./
 *이 협업 시스템은 오픈소스입니다. 개선 아이디어는 [CodeSyncer GitHub](https://github.com/bitjaru/codesyncer)에서 제안해주세요!*
 <!-- codesyncer-section-end:footer -->
 
-<!-- codesyncer-version: 3.1.1 -->
+<!-- codesyncer-version: 3.2.0 -->

package/dist/templates/ko/setup_guide_single.md

@@ -285,6 +285,39 @@ CodeSyncer 사용 준비 완료!
 - `[GITHUB_USERNAME]` → 사용자 GitHub 사용자명
 - `[KEYWORDS]` → 사용자 확인 의논 키워드
 - `[TEMPLATES]` → 프로젝트 타입별 템플릿
+- `[HOOKS_GUIDE]` → Hooks 상태에 따른 가이드 (아래 참조)
+
+### [HOOKS_GUIDE] 교체 방법
+
+`.claude/settings.json` 파일이 있으면 (Hooks 설정됨):
+```markdown
+> ✅ 이미 설정됨: `.claude/settings.json`
+
+**Hooks가 하는 일**:
+- AI가 응답 완료 전에 "태그 붙였어?" 자동 확인
+- 세션이 길어져도 규칙을 까먹지 않음
+
+**수정하려면**:
+- `.claude/settings.json` 직접 편집
+- 또는 "Hooks 수정해줘"라고 말하세요
+
+**비활성화하려면**:
+- `.claude/settings.json` 삭제
+```
+
+`.claude/settings.json` 파일이 없으면 (Hooks 설정 안 됨):
+```markdown
+> ⚠️ 아직 설정 안 됨
+
+**Hooks란?**
+세션이 길어지면 AI가 규칙을 까먹을 수 있습니다.
+Hooks를 설정하면 AI가 응답 완료 전에 자동으로 "태그 붙였어?" 확인합니다.
+
+**설정하려면**:
+"CodeSyncer Hooks 설정해줘"라고 말하세요.
+
+AI가 자동으로 `.claude/settings.json`을 생성합니다.
+```
 
 ---
 
@@ -323,4 +356,4 @@ rm .claude/SETUP_GUIDE.md
 
 *이 설정 가이드는 CodeSyncer CLI에 의해 생성됩니다. 문제나 개선사항은 https://github.com/bitjaru/codesyncer 방문*
 
-<!-- codesyncer-version: 3.1.1 -->
+<!-- codesyncer-version: 3.2.0 -->

package/dist/templates/ko/subfolder-claude.md

@@ -0,0 +1,18 @@
+# CLAUDE.md - [FOLDER_NAME]
+
+## 📌 이 폴더의 역할
+[폴더 설명]
+
+## 🔧 주요 파일
+- `index.ts` - 진입점
+- `types.ts` - 타입 정의
+
+## ⚠️ CodeSyncer 리마인드
+- 추론 → @codesyncer-inference
+- 결정 → @codesyncer-decision
+- 💰결제/🔐보안 → 물어보기
+
+## 🚫 Do Not Touch
+- `generated/` - 자동 생성
+
+<!-- codesyncer-version: 3.2.0 -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesyncer",
-  "version": "3.1.1",
+  "version": "3.3.0",
   "description": "Claude forgets everything when the session ends. CodeSyncer makes it remember.",
   "keywords": [
     "ai-collaboration",

package/src/templates/en/claude.md

@@ -1,5 +1,5 @@
 <!-- codesyncer-section-start:header -->
-# CLAUDE.md - [PROJECT_NAME] Coding Guide v3.0
+# CLAUDE.md - [PROJECT_NAME] Coding Guide v3.2
 
 > **Powered by CodeSyncer** - AI Collaboration System
 
@@ -13,6 +13,26 @@ CodeSyncer helps maintain context between AI sessions through @codesyncer-* tags
 
 ---
 
+## ⚡ TL;DR (3-Line Summary)
+
+```
+1. Tags required: inference→@codesyncer-inference, decision→@codesyncer-decision
+2. 💰Payment/🔐Security/🔌API → Always ask first
+3. When uncertain → Ask
+```
+
+---
+
+## ❌ DO NOT (Absolutely Forbidden)
+
+- Do not infer prices/fees
+- Do not guess API URLs
+- Do not change security settings arbitrarily
+- Do not write code without tags
+- Do not delete files without confirmation
+
+---
+
 ## 🧠 Why Use This System?
 
 **Problem**: AI forgets all context when the session ends.
@@ -27,18 +47,6 @@ CodeSyncer helps maintain context between AI sessions through @codesyncer-* tags
 ```
 → Next session, AI reads the code and **automatically recovers context**
 
----
-
-## ⚡ TL;DR (Never Forget)
-
-```
-1. Making inference → // @codesyncer-inference: [reason]
-2. Making decision → // @codesyncer-decision: [date] [content]
-3. 💰Price/🔐Security/🔌API → Always ask first
-4. All code must have tags (no untagged code)
-5. When uncertain → Ask
-```
-
 ---
 <!-- codesyncer-section-end:header -->
 
@@ -237,14 +245,21 @@ async function deleteUser(id: string) {
 ---
 
 <!-- codesyncer-section-start:session-checklist -->
-## 💡 Session Start Checklist
+## 🔍 Session Start Checklist
 
-When AI reads this file, it automatically:
+**Check Git status** (understand current work context):
+```bash
+git branch      # Check current branch
+git status      # Check changes
+git log -3      # Check last 3 commits
+```
 
-1. ✅ **Show help** - Display available commands
-2. ✅ **Understand project structure** - Check ARCHITECTURE.md
-3. ✅ **Check recent discussions** - Review DECISIONS.md
-4. ✅ **Ready message** - "Ready to work!"
+**Check documents**:
+1. ✅ **CLAUDE.md** - Review rules in this file
+2. ✅ **ARCHITECTURE.md** - Understand project structure
+3. ✅ **DECISIONS.md** - Review recent decisions
+
+**Ready**: "Ready to work!"
 <!-- codesyncer-section-end:session-checklist -->
 
 ---
@@ -260,6 +275,97 @@ When AI reads this file, it automatically:
 
 ---
 
+<!-- codesyncer-section-start:subfolder-guide -->
+## 📂 Subfolder CLAUDE.md (When Code Grows)
+
+When the project grows, add CLAUDE.md to each folder:
+
+```
+project/
+├── CLAUDE.md              # Global rules
+├── src/
+│   ├── payment/
+│   │   └── CLAUDE.md      # Payment rules + tag reminders
+│   └── auth/
+│       └── CLAUDE.md      # Auth rules
+```
+
+AI will automatically read it when entering that folder.
+
+### Subfolder CLAUDE.md Example
+```markdown
+# CLAUDE.md - payment
+
+## 📌 This Folder's Purpose
+Payment processing and settlement code
+
+## ⚠️ CodeSyncer Reminder
+- Inference → @codesyncer-inference
+- Decision → @codesyncer-decision
+- 💰Payment/🔐Security → Ask first
+
+## 🚫 Do Not Touch
+- `generated/` - Auto-generated files
+```
+<!-- codesyncer-section-end:subfolder-guide -->
+
+---
+
+<!-- codesyncer-section-start:do-not-touch -->
+## 🚫 Do Not Touch (Protected Zones)
+
+Do not modify the following files/folders:
+
+| Path | Reason |
+|------|--------|
+| `src/generated/` | Auto-generated files |
+| `src/legacy/` | Do not modify until migration |
+| `.env*` | Environment variables, do not edit directly |
+
+> 💡 Customize this section for your project
+<!-- codesyncer-section-end:do-not-touch -->
+
+---
+
+<!-- codesyncer-section-start:multi-repo -->
+## 🔗 Multi-Repo Work
+
+### Git Branch = Work ID
+Use branch names as work IDs:
+- `feature/AUTH-001-login`
+- `fix/PAY-002-webhook`
+
+### Cross-Repo Tags
+Use the same tag for work spanning multiple repos:
+```typescript
+// frontend repo
+// @codesyncer-work:AUTH-001 Login form
+
+// backend repo
+// @codesyncer-work:AUTH-001 Login API
+```
+
+Search: `grep -r "@codesyncer-work:AUTH-001" ../`
+
+### Related Repos
+
+| Repo | Role | Path |
+|------|------|------|
+| - | - | - |
+
+> 💡 Customize this table for your project
+<!-- codesyncer-section-end:multi-repo -->
+
+---
+
+<!-- codesyncer-section-start:hooks -->
+## 🪝 Hooks (Auto Reminders)
+
+[HOOKS_GUIDE]
+<!-- codesyncer-section-end:hooks -->
+
+---
+
 <!-- codesyncer-section-start:footer -->
 ## 🔍 Comment Search
 
@@ -292,4 +398,4 @@ grep -r "@codesyncer-rule" ./
 *This collaboration system is open source. Suggest improvements at [CodeSyncer GitHub](https://github.com/bitjaru/codesyncer)!*
 <!-- codesyncer-section-end:footer -->
 
-<!-- codesyncer-version: 3.1.1 -->
+<!-- codesyncer-version: 3.2.0 -->

package/src/templates/en/setup_guide_single.md

@@ -285,6 +285,39 @@ When generating files, replace these:
 - `[GITHUB_USERNAME]` → User's GitHub username
 - `[KEYWORDS]` → User-confirmed discussion keywords
 - `[TEMPLATES]` → Project type-specific templates
+- `[HOOKS_GUIDE]` → Hooks status guide (see below)
+
+### [HOOKS_GUIDE] Replacement
+
+If `.claude/settings.json` exists (Hooks enabled):
+```markdown
+> ✅ Already configured: `.claude/settings.json`
+
+**What Hooks do**:
+- AI auto-checks "Did you add tags?" before completing
+- Rules are remembered even in long sessions
+
+**To modify**:
+- Edit `.claude/settings.json` directly
+- Or say "Modify Hooks"
+
+**To disable**:
+- Delete `.claude/settings.json`
+```
+
+If `.claude/settings.json` doesn't exist (Hooks not configured):
+```markdown
+> ⚠️ Not configured yet
+
+**What are Hooks?**
+AI might forget rules during long sessions.
+With Hooks, AI automatically checks "Did you add tags?" before completing.
+
+**To set up**:
+Say "Set up CodeSyncer Hooks".
+
+AI will automatically create `.claude/settings.json`.
+```
 
 ---
 
@@ -323,4 +356,4 @@ rm .claude/SETUP_GUIDE.md
 
 *This setup guide is generated by CodeSyncer CLI. For issues or improvements, visit: https://github.com/bitjaru/codesyncer*
 
-<!-- codesyncer-version: 3.1.1 -->
+<!-- codesyncer-version: 3.2.0 -->

package/src/templates/en/subfolder-claude.md

@@ -0,0 +1,18 @@
+# CLAUDE.md - [FOLDER_NAME]
+
+## 📌 This Folder's Purpose
+[Folder description]
+
+## 🔧 Key Files
+- `index.ts` - Entry point
+- `types.ts` - Type definitions
+
+## ⚠️ CodeSyncer Reminder
+- Inference → @codesyncer-inference
+- Decision → @codesyncer-decision
+- 💰Payment/🔐Security → Ask first
+
+## 🚫 Do Not Touch
+- `generated/` - Auto-generated
+
+<!-- codesyncer-version: 3.2.0 -->

package/src/templates/hooks/settings.json

@@ -0,0 +1,24 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[CodeSyncer] Rules: 1) @codesyncer-inference for inferences 2) @codesyncer-decision for decisions 3) Always ask user about payment/security/API'"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[CodeSyncer] Remember after compaction: @codesyncer-* tags required, ask user for payment/security/API matters'"
+          }
+        ]
+      }
+    ]
+  }
+}

package/src/templates/hooks/settings.ko.json

@@ -0,0 +1,24 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "작업 완료 전 CodeSyncer 체크: 1) 추론→@codesyncer-inference 태그? 2) 결정→@codesyncer-decision 태그? 3) 결제/보안/API→사용자에게 물었나? 빠진 태그가 있으면 지금 추가하세요."
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "컴팩트 후에도 기억: @codesyncer-* 태그 필수, 결제/보안/API→물어보기"
+          }
+        ]
+      }
+    ]
+  }
+}