@team-semicolon/semo-cli 3.0.28 → 3.0.30

package/dist/index.js

@@ -450,6 +450,9 @@ const EXTENSION_PACKAGES = {
     "ops/improve": { name: "Improve", desc: "개선 제안", layer: "ops", detect: [] },
     // Meta
     meta: { name: "Meta", desc: "SEMO 프레임워크 자체 개발/관리", layer: "meta", detect: ["semo-core", "semo-skills"] },
+    // System (semo-system 하위 패키지)
+    "semo-hooks": { name: "Hooks", desc: "Claude Code Hooks 기반 로깅 시스템", layer: "system", detect: [] },
+    "semo-remote": { name: "Remote", desc: "Claude Code 원격 제어 (모바일 PWA)", layer: "system", detect: [] },
 };
 // 단축명 → 전체 패키지 경로 매핑
 const SHORTNAME_MAPPING = {
@@ -469,9 +472,12 @@ const SHORTNAME_MAPPING = {
     next: "eng/nextjs",
     backend: "eng/spring",
     mvp: "biz/poc",
+    // System 패키지 단축명
+    hooks: "semo-hooks",
+    remote: "semo-remote",
 };
-// 그룹 이름 목록 (biz, eng, ops)
-const PACKAGE_GROUPS = ["biz", "eng", "ops", "meta"];
+// 그룹 이름 목록 (biz, eng, ops, meta, system)
+const PACKAGE_GROUPS = ["biz", "eng", "ops", "meta", "system"];
 // 그룹명 → 해당 그룹의 모든 패키지 반환
 function getPackagesByGroup(group) {
     return Object.entries(EXTENSION_PACKAGES)
@@ -766,7 +772,7 @@ async function confirmOverwrite(itemName, itemPath) {
             type: "confirm",
             name: "shouldOverwrite",
             message: chalk_1.default.yellow(`${itemName} 이미 존재합니다. SEMO 기준으로 덮어쓰시겠습니까?`),
-            default: false,
+            default: true,
         },
     ]);
     return shouldOverwrite;
@@ -975,13 +981,15 @@ program
     if (options.gitignore !== false) {
         updateGitignore(cwd);
     }
-    // 9. CLAUDE.md 생성
+    // 9. Hooks 설치 (대화 로깅)
+    await setupHooks(cwd, false);
+    // 10. CLAUDE.md 생성
     await setupClaudeMd(cwd, extensionsToInstall, options.force);
-    // 10. Extensions 심볼릭 링크 (agents/skills 병합)
+    // 11. Extensions 심볼릭 링크 (agents/skills 병합)
     if (extensionsToInstall.length > 0) {
         await setupExtensionSymlinks(cwd, extensionsToInstall);
     }
-    // 11. 설치 검증
+    // 12. 설치 검증
     const verificationResult = verifyInstallation(cwd, extensionsToInstall);
     printVerificationResult(verificationResult);
     // 완료 메시지
@@ -1445,89 +1453,89 @@ function createMergedOrchestrator(claudeAgentsDir, orchestratorSources) {
         }
     }
     // 병합된 orchestrator.md 생성
-    const mergedContent = `---
-name: orchestrator
-description: |
-  SEMO Merged Orchestrator - Routes all user requests to appropriate agents/skills.
-  This orchestrator combines routing tables from ${orchestratorSources.length} packages.
-  PROACTIVELY delegate on ALL requests. Never process directly.
-tools:
-  - read_file
-  - list_dir
-  - run_command
-  - glob
-  - grep
-  - task
-  - skill
-model: inherit
----
-
-# SEMO Merged Orchestrator
-
-> 이 파일은 **자동 생성**되었습니다. 직접 수정하지 마세요.
-> 원본 파일: \`_packages/\` 디렉토리 참조
-
-모든 사용자 요청을 분석하고 적절한 Agent 또는 Skill로 라우팅하는 **Primary Router**입니다.
-
-## 🔴 설치된 패키지
-
-${orchestratorSources.map(s => `- **${EXTENSION_PACKAGES[s.pkg]?.name || s.pkg}**: \`semo-system/${s.pkg}\``).join("\n")}
-
-## �� Quick Routing Table (Merged)
-
-> 키워드 매칭 시 **첫 번째 매칭된 패키지**로 라우팅됩니다.
-
-${routingTables.join("\n\n---\n\n")}
-
-## SEMO 메시지 포맷
-
-### Agent 위임
-
-\`\`\`markdown
-[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
-
-[SEMO] Agent 위임: {agent_name} (사유: {reason})
-\`\`\`
-
-### Skill 호출
-
-\`\`\`markdown
-[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
-
-[SEMO] Skill 호출: {skill_name}
-\`\`\`
-
-### 라우팅 실패
-
-\`\`\`markdown
-[SEMO] Orchestrator: 라우팅 실패 → 적절한 Agent/Skill 없음
-
-⚠️ 직접 처리 필요
-\`\`\`
-
-## Critical Rules
-
-1. **Routing-Only**: 직접 작업 수행 금지
-2. **SEMO 메시지 필수**: 모든 위임에 SEMO 메시지 포함
-3. **Package Priority**: 라우팅 충돌 시 설치 순서대로 우선순위 적용
-4. **Cross-Package**: 다른 패키지 전문 영역 요청 시 인계 권유
-
-${crossPackageRouting.length > 0 ? `## 🔄 Cross-Package Routing
-
-${crossPackageRouting[0]}` : ""}
-
-${availableAgents.length > 0 ? `## Available Agents (All Packages)
-
-${availableAgents.join("\n\n")}` : ""}
-
-${availableSkills.length > 0 ? `## Available Skills (All Packages)
-
-${availableSkills.join("\n\n")}` : ""}
-
-## References
-
-- 원본 Orchestrator: \`_packages/\` 디렉토리
-- 병합된 References: \`references/\` 디렉토리
+    const mergedContent = `---
+name: orchestrator
+description: |
+  SEMO Merged Orchestrator - Routes all user requests to appropriate agents/skills.
+  This orchestrator combines routing tables from ${orchestratorSources.length} packages.
+  PROACTIVELY delegate on ALL requests. Never process directly.
+tools:
+  - read_file
+  - list_dir
+  - run_command
+  - glob
+  - grep
+  - task
+  - skill
+model: inherit
+---
+
+# SEMO Merged Orchestrator
+
+> 이 파일은 **자동 생성**되었습니다. 직접 수정하지 마세요.
+> 원본 파일: \`_packages/\` 디렉토리 참조
+
+모든 사용자 요청을 분석하고 적절한 Agent 또는 Skill로 라우팅하는 **Primary Router**입니다.
+
+## 🔴 설치된 패키지
+
+${orchestratorSources.map(s => `- **${EXTENSION_PACKAGES[s.pkg]?.name || s.pkg}**: \`semo-system/${s.pkg}\``).join("\n")}
+
+## �� Quick Routing Table (Merged)
+
+> 키워드 매칭 시 **첫 번째 매칭된 패키지**로 라우팅됩니다.
+
+${routingTables.join("\n\n---\n\n")}
+
+## SEMO 메시지 포맷
+
+### Agent 위임
+
+\`\`\`markdown
+[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
+
+[SEMO] Agent 위임: {agent_name} (사유: {reason})
+\`\`\`
+
+### Skill 호출
+
+\`\`\`markdown
+[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
+
+[SEMO] Skill 호출: {skill_name}
+\`\`\`
+
+### 라우팅 실패
+
+\`\`\`markdown
+[SEMO] Orchestrator: 라우팅 실패 → 적절한 Agent/Skill 없음
+
+⚠️ 직접 처리 필요
+\`\`\`
+
+## Critical Rules
+
+1. **Routing-Only**: 직접 작업 수행 금지
+2. **SEMO 메시지 필수**: 모든 위임에 SEMO 메시지 포함
+3. **Package Priority**: 라우팅 충돌 시 설치 순서대로 우선순위 적용
+4. **Cross-Package**: 다른 패키지 전문 영역 요청 시 인계 권유
+
+${crossPackageRouting.length > 0 ? `## 🔄 Cross-Package Routing
+
+${crossPackageRouting[0]}` : ""}
+
+${availableAgents.length > 0 ? `## Available Agents (All Packages)
+
+${availableAgents.join("\n\n")}` : ""}
+
+${availableSkills.length > 0 ? `## Available Skills (All Packages)
+
+${availableSkills.join("\n\n")}` : ""}
+
+## References
+
+- 원본 Orchestrator: \`_packages/\` 디렉토리
+- 병합된 References: \`references/\` 디렉토리
 `;
     fs.writeFileSync(path.join(orchestratorDir, "orchestrator.md"), mergedContent);
 }
@@ -1882,12 +1890,12 @@ async function mergeExtensionSettings(cwd, packages) {
 function updateGitignore(cwd) {
     console.log(chalk_1.default.cyan("\n📝 .gitignore 업데이트"));
     const gitignorePath = path.join(cwd, ".gitignore");
-    const semoIgnoreBlock = `
-# === SEMO ===
-.claude/*
-!.claude/memory/
-!.claude/memory/**
-semo-system/
+    const semoIgnoreBlock = `
+# === SEMO ===
+.claude/*
+!.claude/memory/
+!.claude/memory/**
+semo-system/
 `;
     if (fs.existsSync(gitignorePath)) {
         const content = fs.readFileSync(gitignorePath, "utf-8");
@@ -1906,6 +1914,117 @@ semo-system/
         console.log(chalk_1.default.green("✓ .gitignore 생성됨 (SEMO 규칙 포함)"));
     }
 }
+// === Hooks 설치/업데이트 ===
+async function setupHooks(cwd, isUpdate = false) {
+    const action = isUpdate ? "업데이트" : "설치";
+    console.log(chalk_1.default.cyan(`\n🪝 Claude Code Hooks ${action}`));
+    console.log(chalk_1.default.gray("   전체 대화 로깅 시스템\n"));
+    const hooksDir = path.join(cwd, "semo-system", "semo-hooks");
+    // semo-hooks 디렉토리 확인
+    if (!fs.existsSync(hooksDir)) {
+        console.log(chalk_1.default.yellow("  ⚠ semo-hooks 디렉토리 없음 (건너뜀)"));
+        return;
+    }
+    // 1. npm install
+    console.log(chalk_1.default.gray("  → 의존성 설치 중..."));
+    try {
+        (0, child_process_1.execSync)("npm install", {
+            cwd: hooksDir,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+    }
+    catch {
+        console.log(chalk_1.default.yellow("  ⚠ npm install 실패 (건너뜀)"));
+        return;
+    }
+    // 2. 빌드
+    console.log(chalk_1.default.gray("  → 빌드 중..."));
+    try {
+        (0, child_process_1.execSync)("npm run build", {
+            cwd: hooksDir,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+    }
+    catch {
+        console.log(chalk_1.default.yellow("  ⚠ 빌드 실패 (건너뜀)"));
+        return;
+    }
+    // 3. settings.local.json 설정
+    const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+    const settingsPath = path.join(homeDir, ".claude", "settings.local.json");
+    const hooksCmd = `node ${path.join(hooksDir, "dist", "index.js")}`;
+    // hooks 설정 객체
+    const hooksConfig = {
+        SessionStart: [
+            {
+                matcher: "",
+                hooks: [
+                    {
+                        type: "command",
+                        command: `${hooksCmd} session-start`,
+                        timeout: 10,
+                    },
+                ],
+            },
+        ],
+        UserPromptSubmit: [
+            {
+                matcher: "",
+                hooks: [
+                    {
+                        type: "command",
+                        command: `${hooksCmd} user-prompt`,
+                        timeout: 5,
+                    },
+                ],
+            },
+        ],
+        Stop: [
+            {
+                matcher: "",
+                hooks: [
+                    {
+                        type: "command",
+                        command: `${hooksCmd} stop`,
+                        timeout: 10,
+                    },
+                ],
+            },
+        ],
+        SessionEnd: [
+            {
+                matcher: "",
+                hooks: [
+                    {
+                        type: "command",
+                        command: `${hooksCmd} session-end`,
+                        timeout: 10,
+                    },
+                ],
+            },
+        ],
+    };
+    // 기존 설정 로드 또는 새로 생성
+    let existingSettings = {};
+    const claudeConfigDir = path.join(homeDir, ".claude");
+    if (!fs.existsSync(claudeConfigDir)) {
+        fs.mkdirSync(claudeConfigDir, { recursive: true });
+    }
+    if (fs.existsSync(settingsPath)) {
+        try {
+            existingSettings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+        }
+        catch {
+            existingSettings = {};
+        }
+    }
+    // hooks 설정 병합
+    existingSettings.hooks = hooksConfig;
+    // 설정 저장
+    fs.writeFileSync(settingsPath, JSON.stringify(existingSettings, null, 2));
+    console.log(chalk_1.default.green(`  ✓ Hooks ${action} 완료`));
+    console.log(chalk_1.default.gray(`    설정: ${settingsPath}`));
+}
 // === Context Mesh 초기화 ===
 async function setupContextMesh(cwd) {
     console.log(chalk_1.default.cyan("\n🧠 Context Mesh 초기화"));
@@ -1915,36 +2034,36 @@ async function setupContextMesh(cwd) {
     // context.md
     const contextPath = path.join(memoryDir, "context.md");
     if (!fs.existsSync(contextPath)) {
-        const contextContent = `# Project Context
-
-> 세션 간 영속화되는 프로젝트 컨텍스트
-> SEMO의 memory 스킬이 이 파일을 자동으로 업데이트합니다.
-
----
-
-## 프로젝트 정보
-
-| 항목 | 값 |
-|------|-----|
-| **이름** | ${path.basename(cwd)} |
-| **SEMO 버전** | ${VERSION} |
-| **설치일** | ${new Date().toISOString().split("T")[0]} |
-
----
-
-## 현재 작업 상태
-
-_아직 작업 기록이 없습니다._
-
----
-
-## 기술 스택
-
-_프로젝트 분석 후 자동으로 채워집니다._
-
----
-
-*마지막 업데이트: ${new Date().toISOString().split("T")[0]}*
+        const contextContent = `# Project Context
+
+> 세션 간 영속화되는 프로젝트 컨텍스트
+> SEMO의 memory 스킬이 이 파일을 자동으로 업데이트합니다.
+
+---
+
+## 프로젝트 정보
+
+| 항목 | 값 |
+|------|-----|
+| **이름** | ${path.basename(cwd)} |
+| **SEMO 버전** | ${VERSION} |
+| **설치일** | ${new Date().toISOString().split("T")[0]} |
+
+---
+
+## 현재 작업 상태
+
+_아직 작업 기록이 없습니다._
+
+---
+
+## 기술 스택
+
+_프로젝트 분석 후 자동으로 채워집니다._
+
+---
+
+*마지막 업데이트: ${new Date().toISOString().split("T")[0]}*
 `;
         fs.writeFileSync(contextPath, contextContent);
         console.log(chalk_1.default.green("✓ .claude/memory/context.md 생성됨"));
@@ -1952,36 +2071,36 @@ _프로젝트 분석 후 자동으로 채워집니다._
     // decisions.md
     const decisionsPath = path.join(memoryDir, "decisions.md");
     if (!fs.existsSync(decisionsPath)) {
-        const decisionsContent = `# Architecture Decisions
-
-> 프로젝트 아키텍처 결정 기록 (ADR)
-> 중요한 기술적 결정을 여기에 기록합니다.
-
----
-
-## 결정 목록
-
-_아직 기록된 결정이 없습니다._
-
----
-
-## 템플릿
-
-\`\`\`markdown
-### ADR-XXX: 결정 제목
-
-**날짜**: YYYY-MM-DD
-**상태**: Proposed | Accepted | Deprecated
-
-#### 배경
-결정이 필요한 이유
-
-#### 결정
-선택한 방안
-
-#### 근거
-선택 이유
-\`\`\`
+        const decisionsContent = `# Architecture Decisions
+
+> 프로젝트 아키텍처 결정 기록 (ADR)
+> 중요한 기술적 결정을 여기에 기록합니다.
+
+---
+
+## 결정 목록
+
+_아직 기록된 결정이 없습니다._
+
+---
+
+## 템플릿
+
+\`\`\`markdown
+### ADR-XXX: 결정 제목
+
+**날짜**: YYYY-MM-DD
+**상태**: Proposed | Accepted | Deprecated
+
+#### 배경
+결정이 필요한 이유
+
+#### 결정
+선택한 방안
+
+#### 근거
+선택 이유
+\`\`\`
 `;
         fs.writeFileSync(decisionsPath, decisionsContent);
         console.log(chalk_1.default.green("✓ .claude/memory/decisions.md 생성됨"));
@@ -1989,62 +2108,62 @@ _아직 기록된 결정이 없습니다._
     // projects.md
     const projectsPath = path.join(memoryDir, "projects.md");
     if (!fs.existsSync(projectsPath)) {
-        const projectsContent = `# 프로젝트 별칭 매핑
-
-> 외부 프로젝트 배포 및 GitHub Projects 상태 관리
-> SEMO의 deployer, project-status 스킬이 이 파일을 참조합니다.
-
----
-
-## GitHub Projects 설정
-
-> **⚠️ 프로젝트 상태 관리 시 이 설정을 참조합니다.**
-
-### 기본 프로젝트
-
-| 프로젝트 | 번호 | Project ID | 용도 |
-|---------|------|------------|------|
-| 이슈관리 | #1 | \`PVT_xxx\` | 메인 태스크 관리 (기본값) |
-
-### Status 옵션
-
-| Status | 설명 |
-|--------|------|
-| 백로그 | 초기 상태 |
-| 작업중 | 개발 진행 중 |
-| 리뷰요청 | 코드 리뷰 대기 |
-| 테스트중 | QA 테스트 단계 |
-| 완료 | 작업 완료 |
-
-### 🔴 상태값 Alias (한글 ↔ 영문)
-
-> **SEMO는 아래 키워드를 자동으로 Status 필드값으로 매핑합니다.**
-
-| 사용자 입력 | → Status 값 | 비고 |
-|------------|-------------|------|
-| 리뷰요청, 리뷰 요청, review | 리뷰요청 | 코드 리뷰 대기 |
-| 테스트중, 테스트 중, testing, qa | 테스트중 | QA 단계 |
-| 작업중, 작업 중, 진행중, in progress, wip | 작업중 | 개발 중 |
-| 완료, done, closed | 완료 | 완료 처리 |
-| 백로그, 대기, pending, backlog | 백로그 | 초기 상태 |
-
-**예시:**
-\`\`\`
-"리뷰요청 이슈들 테스트중으로 바꿔줘"
-→ Status == "리뷰요청" 인 항목들을 Status = "테스트중" 으로 변경
-\`\`\`
-
----
-
-## 프로젝트 별칭
-
-| 별칭 | 레포지토리 | 환경 | 배포 방법 |
-|------|-----------|------|----------|
-| 예시 | owner/repo | stg | Milestone close |
-
----
-
-*마지막 업데이트: ${new Date().toISOString().split("T")[0]}*
+        const projectsContent = `# 프로젝트 별칭 매핑
+
+> 외부 프로젝트 배포 및 GitHub Projects 상태 관리
+> SEMO의 deployer, project-status 스킬이 이 파일을 참조합니다.
+
+---
+
+## GitHub Projects 설정
+
+> **⚠️ 프로젝트 상태 관리 시 이 설정을 참조합니다.**
+
+### 기본 프로젝트
+
+| 프로젝트 | 번호 | Project ID | 용도 |
+|---------|------|------------|------|
+| 이슈관리 | #1 | \`PVT_xxx\` | 메인 태스크 관리 (기본값) |
+
+### Status 옵션
+
+| Status | 설명 |
+|--------|------|
+| 백로그 | 초기 상태 |
+| 작업중 | 개발 진행 중 |
+| 리뷰요청 | 코드 리뷰 대기 |
+| 테스트중 | QA 테스트 단계 |
+| 완료 | 작업 완료 |
+
+### 🔴 상태값 Alias (한글 ↔ 영문)
+
+> **SEMO는 아래 키워드를 자동으로 Status 필드값으로 매핑합니다.**
+
+| 사용자 입력 | → Status 값 | 비고 |
+|------------|-------------|------|
+| 리뷰요청, 리뷰 요청, review | 리뷰요청 | 코드 리뷰 대기 |
+| 테스트중, 테스트 중, testing, qa | 테스트중 | QA 단계 |
+| 작업중, 작업 중, 진행중, in progress, wip | 작업중 | 개발 중 |
+| 완료, done, closed | 완료 | 완료 처리 |
+| 백로그, 대기, pending, backlog | 백로그 | 초기 상태 |
+
+**예시:**
+\`\`\`
+"리뷰요청 이슈들 테스트중으로 바꿔줘"
+→ Status == "리뷰요청" 인 항목들을 Status = "테스트중" 으로 변경
+\`\`\`
+
+---
+
+## 프로젝트 별칭
+
+| 별칭 | 레포지토리 | 환경 | 배포 방법 |
+|------|-----------|------|----------|
+| 예시 | owner/repo | stg | Milestone close |
+
+---
+
+*마지막 업데이트: ${new Date().toISOString().split("T")[0]}*
 `;
         fs.writeFileSync(projectsPath, projectsContent);
         console.log(chalk_1.default.green("✓ .claude/memory/projects.md 생성됨"));
@@ -2054,21 +2173,21 @@ _아직 기록된 결정이 없습니다._
     fs.mkdirSync(rulesDir, { recursive: true });
     const rulesPath = path.join(rulesDir, "project-specific.md");
     if (!fs.existsSync(rulesPath)) {
-        const rulesContent = `# Project-Specific Rules
-
-> 이 프로젝트에만 적용되는 규칙
-
----
-
-## 코딩 규칙
-
-_프로젝트별 코딩 규칙을 여기에 추가하세요._
-
----
-
-## 예외 사항
-
-_SEMO 기본 규칙의 예외 사항을 여기에 추가하세요._
+        const rulesContent = `# Project-Specific Rules
+
+> 이 프로젝트에만 적용되는 규칙
+
+---
+
+## 코딩 규칙
+
+_프로젝트별 코딩 규칙을 여기에 추가하세요._
+
+---
+
+## 예외 사항
+
+_SEMO 기본 규칙의 예외 사항을 여기에 추가하세요._
 `;
         fs.writeFileSync(rulesPath, rulesContent);
         console.log(chalk_1.default.green("✓ .claude/memory/rules/project-specific.md 생성됨"));
@@ -2204,129 +2323,129 @@ async function setupClaudeMd(cwd, extensions, force) {
     orchestratorPaths.unshift("semo-system/semo-core/agents/orchestrator/orchestrator.md");
     // Orchestrator 참조 섹션 생성
     const orchestratorRefSection = orchestratorPaths.length > 1
-        ? `**Primary Orchestrator**: \`semo-system/${primaryOrchestratorPath}\`
-
-> Extension 패키지가 설치되어 해당 패키지의 Orchestrator를 우선 참조합니다.
-
-**모든 Orchestrator 파일** (라우팅 테이블 병합됨):
-${orchestratorPaths.map(p => `- \`${p}\``).join("\n")}
-
+        ? `**Primary Orchestrator**: \`semo-system/${primaryOrchestratorPath}\`
+
+> Extension 패키지가 설치되어 해당 패키지의 Orchestrator를 우선 참조합니다.
+
+**모든 Orchestrator 파일** (라우팅 테이블 병합됨):
+${orchestratorPaths.map(p => `- \`${p}\``).join("\n")}
+
 이 파일들에서 라우팅 테이블, 의도 분류, 메시지 포맷을 확인하세요.`
-        : `**반드시 읽어야 할 파일**: \`semo-system/semo-core/agents/orchestrator/orchestrator.md\`
-
+        : `**반드시 읽어야 할 파일**: \`semo-system/semo-core/agents/orchestrator/orchestrator.md\`
+
 이 파일에서 라우팅 테이블, 의도 분류, 메시지 포맷을 확인하세요.`;
-    const claudeMdContent = `# SEMO Project Configuration
-
-> SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
-
----
-
-## 🔴 MANDATORY: Orchestrator-First Execution
-
-> **⚠️ 이 규칙은 모든 사용자 요청에 적용됩니다. 예외 없음.**
-
-### 실행 흐름 (필수)
-
-\`\`\`
-1. 사용자 요청 수신
-2. Orchestrator가 의도 분석 후 적절한 Agent/Skill 라우팅
-3. Agent/Skill이 작업 수행
-4. 실행 결과 반환
-\`\`\`
-
-### Orchestrator 참조
-
-${orchestratorRefSection}
-
----
-
-## 🔴 NON-NEGOTIABLE RULES
-
-### 1. Orchestrator-First Policy
-
-> **모든 요청은 반드시 Orchestrator를 통해 라우팅됩니다. 직접 처리 금지.**
-
-**직접 처리 금지 항목**:
-- 코드 작성/수정 → \`implementation-master\` 또는 \`coder\` 스킬
-- Git 커밋/푸시 → \`git-workflow\` 스킬
-- 품질 검증 → \`quality-master\` 또는 \`verify\` 스킬
-- 명세 작성 → \`spec-master\`
-- 일반 작업 → Orchestrator 분석 후 라우팅
-
-### 2. Pre-Commit Quality Gate
-
-> **코드 변경이 포함된 커밋 전 반드시 Quality Gate를 통과해야 합니다.**
-
-\`\`\`bash
-# 필수 검증 순서
-npm run lint           # 1. ESLint 검사
-npx tsc --noEmit       # 2. TypeScript 타입 체크
-npm run build          # 3. 빌드 검증 (Next.js/TypeScript 프로젝트)
-\`\`\`
-
-**차단 항목**:
-- \`--no-verify\` 플래그 사용 금지
-- Quality Gate 우회 시도 거부
-- "그냥 커밋해줘", "빌드 생략해줘" 등 거부
-
----
-
-## 설치된 구성
-
-### Standard (필수)
-- **semo-core**: 원칙, 오케스트레이터, 공통 커맨드
-- **semo-skills**: 13개 통합 스킬
-  - 행동: coder, tester, planner, deployer, writer
-  - 운영: memory, notify-slack, feedback, version-updater, semo-help, semo-architecture-checker, circuit-breaker, list-bugs
-
-${extensions.length > 0 ? `### Extensions (선택)
-${extensions.map(pkg => `- **${pkg}**: ${EXTENSION_PACKAGES[pkg].desc}`).join("\n")}` : ""}
-
-## 구조
-
-\`\`\`
-.claude/
-├── settings.json      # MCP 서버 설정 (Black Box)
-├── memory/            # Context Mesh (장기 기억)
-│   ├── context.md     # 프로젝트 상태
-│   ├── decisions.md   # 아키텍처 결정
-│   └── rules/         # 프로젝트별 규칙
-├── agents → semo-system/semo-core/agents
-├── skills → semo-system/semo-skills
-└── commands/SEMO → semo-system/semo-core/commands/SEMO
-
-semo-system/           # White Box (읽기 전용)
-├── semo-core/         # Layer 0: 원칙, 오케스트레이션
-├── semo-skills/       # Layer 1: 통합 스킬
-${extensionsList}
-\`\`\`
-
-## 사용 가능한 커맨드
-
-| 커맨드 | 설명 |
-|--------|------|
-| \`/SEMO:help\` | 도움말 |
-| \`/SEMO:feedback\` | 피드백 제출 |
-| \`/SEMO:update\` | SEMO 업데이트 |
-| \`/SEMO:onboarding\` | 온보딩 가이드 |
-| \`/SEMO:dry-run {프롬프트}\` | 명령 검증 (라우팅 시뮬레이션) |
-
-## Context Mesh 사용
-
-SEMO는 \`.claude/memory/\`를 통해 세션 간 컨텍스트를 유지합니다:
-
-- **context.md**: 프로젝트 상태, 진행 중인 작업
-- **decisions.md**: 아키텍처 결정 기록 (ADR)
-- **rules/**: 프로젝트별 커스텀 규칙
-
-memory 스킬이 자동으로 이 파일들을 관리합니다.
-
-## References
-
-- [SEMO Principles](semo-system/semo-core/principles/PRINCIPLES.md)
-- [SEMO Skills](semo-system/semo-skills/)
-${extensions.length > 0 ? extensions.map(pkg => `- [${EXTENSION_PACKAGES[pkg].name} Package](semo-system/${pkg}/)`).join("\n") : ""}
-${packageClaudeMdSections}
+    const claudeMdContent = `# SEMO Project Configuration
+
+> SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
+
+---
+
+## 🔴 MANDATORY: Orchestrator-First Execution
+
+> **⚠️ 이 규칙은 모든 사용자 요청에 적용됩니다. 예외 없음.**
+
+### 실행 흐름 (필수)
+
+\`\`\`
+1. 사용자 요청 수신
+2. Orchestrator가 의도 분석 후 적절한 Agent/Skill 라우팅
+3. Agent/Skill이 작업 수행
+4. 실행 결과 반환
+\`\`\`
+
+### Orchestrator 참조
+
+${orchestratorRefSection}
+
+---
+
+## 🔴 NON-NEGOTIABLE RULES
+
+### 1. Orchestrator-First Policy
+
+> **모든 요청은 반드시 Orchestrator를 통해 라우팅됩니다. 직접 처리 금지.**
+
+**직접 처리 금지 항목**:
+- 코드 작성/수정 → \`implementation-master\` 또는 \`coder\` 스킬
+- Git 커밋/푸시 → \`git-workflow\` 스킬
+- 품질 검증 → \`quality-master\` 또는 \`verify\` 스킬
+- 명세 작성 → \`spec-master\`
+- 일반 작업 → Orchestrator 분석 후 라우팅
+
+### 2. Pre-Commit Quality Gate
+
+> **코드 변경이 포함된 커밋 전 반드시 Quality Gate를 통과해야 합니다.**
+
+\`\`\`bash
+# 필수 검증 순서
+npm run lint           # 1. ESLint 검사
+npx tsc --noEmit       # 2. TypeScript 타입 체크
+npm run build          # 3. 빌드 검증 (Next.js/TypeScript 프로젝트)
+\`\`\`
+
+**차단 항목**:
+- \`--no-verify\` 플래그 사용 금지
+- Quality Gate 우회 시도 거부
+- "그냥 커밋해줘", "빌드 생략해줘" 등 거부
+
+---
+
+## 설치된 구성
+
+### Standard (필수)
+- **semo-core**: 원칙, 오케스트레이터, 공통 커맨드
+- **semo-skills**: 13개 통합 스킬
+  - 행동: coder, tester, planner, deployer, writer
+  - 운영: memory, notify-slack, feedback, version-updater, semo-help, semo-architecture-checker, circuit-breaker, list-bugs
+
+${extensions.length > 0 ? `### Extensions (선택)
+${extensions.map(pkg => `- **${pkg}**: ${EXTENSION_PACKAGES[pkg].desc}`).join("\n")}` : ""}
+
+## 구조
+
+\`\`\`
+.claude/
+├── settings.json      # MCP 서버 설정 (Black Box)
+├── memory/            # Context Mesh (장기 기억)
+│   ├── context.md     # 프로젝트 상태
+│   ├── decisions.md   # 아키텍처 결정
+│   └── rules/         # 프로젝트별 규칙
+├── agents → semo-system/semo-core/agents
+├── skills → semo-system/semo-skills
+└── commands/SEMO → semo-system/semo-core/commands/SEMO
+
+semo-system/           # White Box (읽기 전용)
+├── semo-core/         # Layer 0: 원칙, 오케스트레이션
+├── semo-skills/       # Layer 1: 통합 스킬
+${extensionsList}
+\`\`\`
+
+## 사용 가능한 커맨드
+
+| 커맨드 | 설명 |
+|--------|------|
+| \`/SEMO:help\` | 도움말 |
+| \`/SEMO:feedback\` | 피드백 제출 |
+| \`/SEMO:update\` | SEMO 업데이트 |
+| \`/SEMO:onboarding\` | 온보딩 가이드 |
+| \`/SEMO:dry-run {프롬프트}\` | 명령 검증 (라우팅 시뮬레이션) |
+
+## Context Mesh 사용
+
+SEMO는 \`.claude/memory/\`를 통해 세션 간 컨텍스트를 유지합니다:
+
+- **context.md**: 프로젝트 상태, 진행 중인 작업
+- **decisions.md**: 아키텍처 결정 기록 (ADR)
+- **rules/**: 프로젝트별 커스텀 규칙
+
+memory 스킬이 자동으로 이 파일들을 관리합니다.
+
+## References
+
+- [SEMO Principles](semo-system/semo-core/principles/PRINCIPLES.md)
+- [SEMO Skills](semo-system/semo-skills/)
+${extensions.length > 0 ? extensions.map(pkg => `- [${EXTENSION_PACKAGES[pkg].name} Package](semo-system/${pkg}/)`).join("\n") : ""}
+${packageClaudeMdSections}
 `;
     fs.writeFileSync(claudeMdPath, claudeMdContent);
     console.log(chalk_1.default.green("✓ .claude/CLAUDE.md 생성됨"));
@@ -2337,7 +2456,7 @@ ${packageClaudeMdSections}
 // === add 명령어 ===
 program
     .command("add <packages>")
-    .description("Extension 패키지를 추가로 설치합니다 (그룹: biz, eng, ops / 개별: biz/discovery, eng/nextjs)")
+    .description("Extension 패키지를 추가로 설치합니다 (그룹: biz, eng, ops, system / 개별: biz/discovery, eng/nextjs, semo-hooks)")
     .option("-f, --force", "기존 설정 덮어쓰기")
     .action(async (packagesInput, options) => {
     const cwd = process.cwd();
@@ -2444,6 +2563,7 @@ program
         eng: { title: "Engineering Layer", emoji: "⚙️" },
         ops: { title: "Operations Layer", emoji: "📊" },
         meta: { title: "Meta", emoji: "🔧" },
+        system: { title: "System", emoji: "🔩" },
     };
     for (const [layerKey, layerInfo] of Object.entries(layers)) {
         const layerPackages = Object.entries(EXTENSION_PACKAGES).filter(([, pkg]) => pkg.layer === layerKey);
@@ -2465,6 +2585,7 @@ program
     console.log(chalk_1.default.gray("  semo add biz      → Business 전체 (discovery, design, management, poc)"));
     console.log(chalk_1.default.gray("  semo add eng      → Engineering 전체 (nextjs, spring, ms, infra)"));
     console.log(chalk_1.default.gray("  semo add ops      → Operations 전체 (qa, monitor, improve)"));
+    console.log(chalk_1.default.gray("  semo add system   → System 전체 (hooks, remote)"));
     console.log();
     // 단축명 안내
     console.log(chalk_1.default.gray("─".repeat(50)));
@@ -2731,7 +2852,9 @@ program
             }
         }
     }
-    // === 설치 검증 ===
+    // === 6. Hooks 업데이트 ===
+    await setupHooks(cwd, true);
+    // === 7. 설치 검증 ===
     const verificationResult = verifyInstallation(cwd, installedExtensions);
     printVerificationResult(verificationResult);
     if (verificationResult.success) {