feat: v3.2.0 - Hooks auto-reminder & context optimization

## New Features
- **Hooks Setup**: Auto-reminder system during `codesyncer init`
  - AI gets reminded to add tags before completing responses
  - Language-specific prompts (Korean/English)
  - Optional setup with clear explanation

- **Template Improvements**
  - TL;DR compressed to 3 lines
  - DO NOT section added (absolutely forbidden actions)
  - Session start checklist with git commands
  - Subfolder CLAUDE.md guide for large projects
  - Do Not Touch zones section
  - Multi-repo cross-repo tagging guide
  - Hooks guide section with setup status

## Files Added
- `src/templates/hooks/settings.json` - English hooks config
- `src/templates/hooks/settings.ko.json` - Korean hooks config
- `src/templates/*/subfolder-claude.md` - Subfolder template

## Files Modified
- `src/commands/init.ts` - Hooks setup flow
- `src/templates/*/claude.md` - v3.2 template updates
- `src/templates/*/setup_guide_single.md` - HOOKS_GUIDE instructions

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

Author: snoo

package.json

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

src/commands/init.ts

@@ -12,6 +12,124 @@ import { displayProgress } from '../utils/progress';
 import { saveSetupState, loadSetupState, clearSetupState, SetupState } from '../utils/setup-state';
 import { VERSION } from '../utils/version';
 
+/**
+ * Display Hooks explanation and ask for setup
+ */
+async function askHooksSetup(lang: Language): Promise<boolean> {
+  const isKo = lang === 'ko';
+
+  console.log();
+  console.log(chalk.bold.cyan('─'.repeat(60)));
+  console.log();
+  console.log(chalk.bold(isKo ? '🪝 Hooks 설정 (권장)' : '🪝 Hooks Setup (Recommended)'));
+  console.log();
+
+  console.log(chalk.white(isKo ? 'Hooks란?' : 'What are Hooks?'));
+  console.log(chalk.gray(
+    isKo
+      ? '  세션이 길어지면 AI가 규칙을 까먹을 수 있습니다.'
+      : '  AI might forget rules during long sessions.'
+  ));
+  console.log(chalk.gray(
+    isKo
+      ? '  Hooks를 설정하면 AI가 응답 완료 전에'
+      : '  With Hooks, AI automatically checks'
+  ));
+  console.log(chalk.gray(
+    isKo
+      ? '  자동으로 "태그 붙였어?" 확인합니다.'
+      : '  "Did you add tags?" before completing.'
+  ));
+  console.log();
+  console.log(chalk.bold.cyan('─'.repeat(60)));
+  console.log();
+
+  const { setupHooks } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'setupHooks',
+      message: isKo ? 'Hooks를 설정할까요?' : 'Set up Hooks?',
+      default: true,
+    },
+  ]);
+
+  return setupHooks;
+}
+
+/**
+ * Generate Hooks settings.json file
+ */
+async function generateHooksSettings(targetDir: string, lang: Language): Promise<void> {
+  const hooksTemplateFile = lang === 'ko' ? 'settings.ko.json' : 'settings.json';
+  const hooksTemplate = await fs.readFile(
+    path.join(__dirname, '..', 'templates', 'hooks', hooksTemplateFile),
+    'utf-8'
+  );
+
+  await fs.writeFile(
+    path.join(targetDir, 'settings.json'),
+    hooksTemplate,
+    'utf-8'
+  );
+}
+
+/**
+ * Get Hooks guide text for CLAUDE.md based on setup status
+ */
+function getHooksGuide(lang: Language, hooksEnabled: boolean): string {
+  const isKo = lang === 'ko';
+
+  if (hooksEnabled) {
+    return isKo
+      ? `> ✅ 이미 설정됨: \`.claude/settings.json\`
+
+**Hooks가 하는 일**:
+- AI가 응답 완료 전에 "태그 붙였어?" 자동 확인
+- 세션이 길어져도 규칙을 까먹지 않음
+
+**수정하려면**:
+- \`.claude/settings.json\` 직접 편집
+- 또는 "Hooks 수정해줘"라고 말하세요
+
+**비활성화하려면**:
+- \`.claude/settings.json\` 삭제`
+      : `> ✅ 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\``;
+  } else {
+    return isKo
+      ? `> ⚠️ 아직 설정 안 됨
+
+**Hooks란?**
+세션이 길어지면 AI가 규칙을 까먹을 수 있습니다.
+Hooks를 설정하면 AI가 응답 완료 전에 자동으로 "태그 붙였어?" 확인합니다.
+
+**설정하려면**:
+"CodeSyncer Hooks 설정해줘"라고 말하세요.
+
+AI가 자동으로 \`.claude/settings.json\`을 생성합니다.`
+      : `> ⚠️ 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\`.`;
+  }
+}
+
 /**
  * Display onboarding explanation for first-time users
  */
@@ -429,6 +547,9 @@ export async function initCommand(options: InitOptions) {
       }
     }
 
+    // Ask for Hooks setup
+    const setupHooks = await askHooksSetup(lang);
+
     // Single-repo: skip select step, go directly to generate
     displayProgress(4, lang);
 
@@ -459,6 +580,12 @@ export async function initCommand(options: InitOptions) {
 
     console.log(chalk.green('✓') + ' .claude/SETUP_GUIDE.md');
 
+    // Generate Hooks settings.json if enabled
+    if (setupHooks) {
+      await generateHooksSettings(claudeDir, lang);
+      console.log(chalk.green('✓') + ' .claude/settings.json ' + chalk.gray('(Hooks)'));
+    }
+
     // Complete! Clear recovery state
     await clearSetupState(currentDir);
     displayProgress(5, lang);
@@ -467,7 +594,11 @@ export async function initCommand(options: InitOptions) {
     console.log(chalk.bold.green(`✅ ${lang === 'ko' ? 'CodeSyncer 초기화 완료! (단일 레포 모드)' : 'CodeSyncer initialized! (Single Repo Mode)'}\n`));
 
     console.log(chalk.bold(lang === 'ko' ? '📋 생성된 파일:' : '📋 Created files:'));
-    console.log(`  ${chalk.cyan('.claude/SETUP_GUIDE.md')} ${chalk.gray('- AI setup instructions')}\n`);
+    console.log(`  ${chalk.cyan('.claude/SETUP_GUIDE.md')} ${chalk.gray('- AI setup instructions')}`);
+    if (setupHooks) {
+      console.log(`  ${chalk.cyan('.claude/settings.json')} ${chalk.gray('- Hooks (auto-reminder)')}`);
+    }
+    console.log();
 
     console.log(chalk.bold(lang === 'ko' ? '🚀 다음 단계:' : '🚀 Next steps:'));
     console.log();

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 -->

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 -->