@team-semicolon/semo-cli 2.0.2 → 2.0.5

package/README.md

@@ -1,118 +1,118 @@
-# @team-semicolon/semo-cli
-
-> SEMO CLI - AI Agent Orchestration Framework Installer
-
-## 개요
-
-Gemini의 하이브리드 전략에 따라 SEMO를 자동 설치하는 CLI 도구입니다.
-
-```bash
-npx @team-semicolon/semo-cli init
-```
-
-## 동작 방식
-
-`semo init` 명령어는 다음을 자동으로 수행합니다:
-
-### 1. White Box 설정 (Git Subtree)
-
-에이전트가 **읽고 학습**해야 하는 지식 베이스:
-
-```
-semo-system/
-├── semo-core/         # Layer 0: 원칙, 오케스트레이션
-└── semo-skills/       # Layer 1: coder, tester, planner
-```
-
-### 2. Black Box 설정 (MCP Server)
-
-토큰이 격리된 **외부 연동 도구**:
-
-```json
-// .claude/settings.json
-{
-  "mcpServers": {
-    "semo-integrations": {
-      "command": "npx",
-      "args": ["-y", "@team-semicolon/semo-mcp"]
-    }
-  }
-}
-```
-
-### 3. Context Mesh 초기화
-
-세션 간 **컨텍스트 영속화**:
-
-```
-.claude/memory/
-├── context.md         # 프로젝트 상태
-├── decisions.md       # 아키텍처 결정
-└── rules/             # 프로젝트별 규칙
-```
-
-## 명령어
-
-### init
-
-현재 프로젝트에 SEMO를 설치합니다.
-
-```bash
-semo init              # 기본 설치
-semo init --force      # 기존 설정 덮어쓰기
-semo init --skip-mcp   # MCP 설정 생략
-semo init --skip-subtree  # Git Subtree 생략
-```
-
-### status
-
-SEMO 설치 상태를 확인합니다.
-
-```bash
-semo status
-```
-
-### update
-
-SEMO를 최신 버전으로 업데이트합니다.
-
-```bash
-semo update
-```
-
-## 설치 후 구조
-
-```
-your-project/
-├── .claude/
-│   ├── CLAUDE.md          # 프로젝트 설정
-│   ├── settings.json      # MCP 서버 설정
-│   ├── memory/            # Context Mesh
-│   ├── agents → semo-system/semo-core/agents
-│   └── skills → semo-system/semo-skills
-│
-└── semo-system/           # White Box (읽기 전용)
-    ├── semo-core/
-    └── semo-skills/
-```
-
-## 환경변수
-
-MCP 연동을 위해 다음 환경변수를 설정하세요:
-
-| 변수 | 설명 |
-|------|------|
-| `GITHUB_TOKEN` | GitHub API 토큰 |
-| `SLACK_BOT_TOKEN` | Slack Bot 토큰 |
-| `SUPABASE_URL` | Supabase 프로젝트 URL |
-| `SUPABASE_KEY` | Supabase 서비스 키 |
-
-## 참조
-
-- [SEMO 레포지토리](https://github.com/semicolon-devteam/semo)
-- [SEMO MCP Server](../mcp-server/README.md)
-- [Gemini 하이브리드 전략](../../docs/SEMO_ARCHITECTURE_REVIEW.md)
-
-## 라이선스
-
-MIT
+# @team-semicolon/semo-cli
+
+> SEMO CLI - AI Agent Orchestration Framework Installer
+
+## 개요
+
+Gemini의 하이브리드 전략에 따라 SEMO를 자동 설치하는 CLI 도구입니다.
+
+```bash
+npx @team-semicolon/semo-cli init
+```
+
+## 동작 방식
+
+`semo init` 명령어는 다음을 자동으로 수행합니다:
+
+### 1. White Box 설정 (Git Subtree)
+
+에이전트가 **읽고 학습**해야 하는 지식 베이스:
+
+```
+semo-system/
+├── semo-core/         # Layer 0: 원칙, 오케스트레이션
+└── semo-skills/       # Layer 1: coder, tester, planner
+```
+
+### 2. Black Box 설정 (MCP Server)
+
+토큰이 격리된 **외부 연동 도구**:
+
+```json
+// .claude/settings.json
+{
+  "mcpServers": {
+    "semo-integrations": {
+      "command": "npx",
+      "args": ["-y", "@team-semicolon/semo-mcp"]
+    }
+  }
+}
+```
+
+### 3. Context Mesh 초기화
+
+세션 간 **컨텍스트 영속화**:
+
+```
+.claude/memory/
+├── context.md         # 프로젝트 상태
+├── decisions.md       # 아키텍처 결정
+└── rules/             # 프로젝트별 규칙
+```
+
+## 명령어
+
+### init
+
+현재 프로젝트에 SEMO를 설치합니다.
+
+```bash
+semo init              # 기본 설치
+semo init --force      # 기존 설정 덮어쓰기
+semo init --skip-mcp   # MCP 설정 생략
+semo init --skip-subtree  # Git Subtree 생략
+```
+
+### status
+
+SEMO 설치 상태를 확인합니다.
+
+```bash
+semo status
+```
+
+### update
+
+SEMO를 최신 버전으로 업데이트합니다.
+
+```bash
+semo update
+```
+
+## 설치 후 구조
+
+```
+your-project/
+├── .claude/
+│   ├── CLAUDE.md          # 프로젝트 설정
+│   ├── settings.json      # MCP 서버 설정
+│   ├── memory/            # Context Mesh
+│   ├── agents → semo-system/semo-core/agents
+│   └── skills → semo-system/semo-skills
+│
+└── semo-system/           # White Box (읽기 전용)
+    ├── semo-core/
+    └── semo-skills/
+```
+
+## 환경변수
+
+MCP 연동을 위해 다음 환경변수를 설정하세요:
+
+| 변수 | 설명 |
+|------|------|
+| `GITHUB_TOKEN` | GitHub API 토큰 |
+| `SLACK_BOT_TOKEN` | Slack Bot 토큰 |
+| `SUPABASE_URL` | Supabase 프로젝트 URL |
+| `SUPABASE_KEY` | Supabase 서비스 키 |
+
+## 참조
+
+- [SEMO 레포지토리](https://github.com/semicolon-devteam/semo)
+- [SEMO MCP Server](../mcp-server/README.md)
+- [Gemini 하이브리드 전략](../../docs/SEMO_ARCHITECTURE_REVIEW.md)
+
+## 라이선스
+
+MIT

package/dist/index.js

@@ -59,7 +59,7 @@ const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const VERSION = "2.0.2";
+const VERSION = "3.0.0-alpha";
 // === Windows 지원 유틸리티 ===
 const isWindows = os.platform() === "win32";
 /**
@@ -122,18 +122,36 @@ function copyRecursive(src, dest) {
     }
 }
 const SEMO_REPO = "https://github.com/semicolon-devteam/semo.git";
-// 확장 패키지 정의
+// 확장 패키지 정의 (v3.0 구조)
 const EXTENSION_PACKAGES = {
-    next: { name: "Next.js", desc: "Next.js 프론트엔드 개발 (13 agents, 33 skills)", detect: ["next.config.js", "next.config.mjs", "next.config.ts"] },
-    backend: { name: "Backend", desc: "Spring/Node.js 백엔드 개발 (8 agents, 15 skills)", detect: ["pom.xml", "build.gradle"] },
-    po: { name: "PO", desc: "Product Owner - 태스크/에픽 관리 (5 agents, 19 skills)", detect: [] },
-    qa: { name: "QA", desc: "QA 테스트 관리 (4 agents, 13 skills)", detect: [] },
-    pm: { name: "PM", desc: "프로젝트/스프린트 관리 (5 agents, 16 skills)", detect: [] },
-    infra: { name: "Infra", desc: "인프라/배포 관리 (6 agents, 10 skills)", detect: ["docker-compose.yml", "Dockerfile"] },
-    design: { name: "Design", desc: "디자인 핸드오프 (3 agents, 4 skills)", detect: [] },
-    ms: { name: "Microservice", desc: "마이크로서비스 아키텍처 (5 agents, 5 skills)", detect: [] },
-    mvp: { name: "MVP", desc: "MVP 빠른 개발 (4 agents, 6 skills)", detect: [] },
-    meta: { name: "Meta", desc: "SEMO 프레임워크 자체 개발/관리 (6 agents, 7 skills)", detect: ["semo-core", "semo-skills", "packages/meta"] },
+    // Business Layer
+    "biz/discovery": { name: "Discovery", desc: "아이템 발굴, 시장 조사, Epic/Task", layer: "biz", detect: [] },
+    "biz/design": { name: "Design", desc: "컨셉 설계, 목업, UX", layer: "biz", detect: [] },
+    "biz/management": { name: "Management", desc: "일정/인력/스프린트 관리", layer: "biz", detect: [] },
+    "biz/poc": { name: "PoC", desc: "빠른 PoC, 패스트트랙", layer: "biz", detect: [] },
+    // Engineering Layer
+    "eng/nextjs": { name: "Next.js", desc: "Next.js 프론트엔드 개발", layer: "eng", detect: ["next.config.js", "next.config.mjs", "next.config.ts"] },
+    "eng/spring": { name: "Spring", desc: "Spring Boot 백엔드 개발", layer: "eng", detect: ["pom.xml", "build.gradle"] },
+    "eng/ms": { name: "Microservice", desc: "마이크로서비스 아키텍처", layer: "eng", detect: [] },
+    "eng/infra": { name: "Infra", desc: "인프라/배포 관리", layer: "eng", detect: ["docker-compose.yml", "Dockerfile"] },
+    // Operations Layer
+    "ops/qa": { name: "QA", desc: "테스트/품질 관리", layer: "ops", detect: [] },
+    "ops/monitor": { name: "Monitor", desc: "서비스 현황 모니터링", layer: "ops", detect: [] },
+    "ops/improve": { name: "Improve", desc: "개선 제안", layer: "ops", detect: [] },
+    // Meta
+    meta: { name: "Meta", desc: "SEMO 프레임워크 자체 개발/관리", layer: "meta", detect: ["semo-core", "semo-skills"] },
+};
+// 레거시 패키지 → 새 패키지 매핑 (하위호환성)
+const LEGACY_MAPPING = {
+    next: "eng/nextjs",
+    backend: "eng/spring",
+    ms: "eng/ms",
+    infra: "eng/infra",
+    qa: "ops/qa",
+    po: "biz/discovery",
+    pm: "biz/management",
+    design: "biz/design",
+    mvp: "biz/poc",
 };
 const program = new commander_1.Command();
 program
@@ -394,13 +412,9 @@ async function setupExtensionSymlinks(cwd, packages) {
         const pkgPath = path.join(semoSystemDir, pkg);
         if (!fs.existsSync(pkgPath))
             continue;
-        // 1. semo-{pkg} 링크
-        const semoPkgLink = path.join(claudeDir, `semo-${pkg}`);
-        if (!fs.existsSync(semoPkgLink)) {
-            createSymlinkOrJunction(pkgPath, semoPkgLink);
-            console.log(chalk_1.default.green(`  ✓ .claude/semo-${pkg} → semo-system/${pkg}`));
-        }
-        // 2. Extension의 agents를 .claude/agents/에 개별 링크
+        // Note: .claude/semo-{pkg} 링크는 생성하지 않음 (불필요)
+        // Extension의 agents/skills만 개별 링크하여 병합
+        // 1. Extension의 agents를 .claude/agents/에 개별 링크
         const extAgentsDir = path.join(pkgPath, "agents");
         const claudeAgentsDir = path.join(claudeDir, "agents");
         if (fs.existsSync(extAgentsDir)) {
@@ -430,6 +444,58 @@ async function setupExtensionSymlinks(cwd, packages) {
         }
     }
 }
+const BASE_MCP_SERVERS = [
+    {
+        name: "semo-integrations",
+        command: "npx",
+        args: ["-y", "@team-semicolon/semo-mcp"],
+        env: {
+            GITHUB_TOKEN: "${GITHUB_TOKEN}",
+            SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}",
+            SUPABASE_URL: "${SUPABASE_URL}",
+            SUPABASE_KEY: "${SUPABASE_KEY}",
+        },
+    },
+    {
+        name: "context7",
+        command: "npx",
+        args: ["-y", "@upstash/context7-mcp"],
+    },
+    {
+        name: "sequential-thinking",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-sequential-thinking"],
+    },
+];
+// === Claude MCP 등록 함수 ===
+function registerMCPServer(server) {
+    try {
+        // 환경변수가 있는 경우 --env 옵션 추가
+        const envArgs = [];
+        if (server.env) {
+            for (const [key, value] of Object.entries(server.env)) {
+                envArgs.push("-e", `${key}=${value}`);
+            }
+        }
+        // claude mcp add 명령어 실행
+        const args = [
+            "mcp", "add",
+            server.name,
+            "--",
+            server.command,
+            ...server.args,
+        ];
+        // 환경변수가 있으면 명령어 앞에 추가
+        if (envArgs.length > 0) {
+            args.splice(2, 0, ...envArgs);
+        }
+        (0, child_process_1.execSync)(`claude ${args.join(" ")}`, { stdio: "pipe" });
+        return { success: true };
+    }
+    catch (error) {
+        return { success: false, error: String(error) };
+    }
+}
 // === MCP 설정 ===
 async function setupMCP(cwd, extensions, force) {
     console.log(chalk_1.default.cyan("\n🔧 Black Box 설정 (MCP Server)"));
@@ -444,19 +510,10 @@ async function setupMCP(cwd, extensions, force) {
     }
     // Base settings (Standard)
     const settings = {
-        mcpServers: {
-            "semo-integrations": {
-                command: "npx",
-                args: ["-y", "@team-semicolon/semo-mcp"],
-                env: {
-                    GITHUB_TOKEN: "${GITHUB_TOKEN}",
-                    SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}",
-                    SUPABASE_URL: "${SUPABASE_URL}",
-                    SUPABASE_KEY: "${SUPABASE_KEY}",
-                },
-            },
-        },
+        mcpServers: {},
     };
+    // MCP 서버 목록 수집
+    const allServers = [...BASE_MCP_SERVERS];
     // Extension settings 병합
     const semoSystemDir = path.join(cwd, "semo-system");
     for (const pkg of extensions) {
@@ -466,8 +523,16 @@ async function setupMCP(cwd, extensions, force) {
                 const extSettings = JSON.parse(fs.readFileSync(extSettingsPath, "utf-8"));
                 // mcpServers 병합
                 if (extSettings.mcpServers) {
-                    Object.assign(settings.mcpServers, extSettings.mcpServers);
-                    console.log(chalk_1.default.gray(`  + ${pkg} MCP 설정 병합됨`));
+                    for (const [name, config] of Object.entries(extSettings.mcpServers)) {
+                        const serverConfig = config;
+                        allServers.push({
+                            name,
+                            command: serverConfig.command,
+                            args: serverConfig.args,
+                            env: serverConfig.env,
+                        });
+                    }
+                    console.log(chalk_1.default.gray(`  + ${pkg} MCP 설정 수집됨`));
                 }
                 // permissions 병합
                 if (extSettings.permissions) {
@@ -494,8 +559,53 @@ async function setupMCP(cwd, extensions, force) {
             }
         }
     }
+    // settings.json에 mcpServers 저장 (백업용)
+    for (const server of allServers) {
+        const serverConfig = {
+            command: server.command,
+            args: server.args,
+        };
+        if (server.env) {
+            serverConfig.env = server.env;
+        }
+        settings.mcpServers[server.name] = serverConfig;
+    }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-    console.log(chalk_1.default.green("✓ .claude/settings.json 생성됨 (MCP 설정)"));
+    console.log(chalk_1.default.green("✓ .claude/settings.json 생성됨 (MCP 설정 백업)"));
+    // Claude Code에 MCP 서버 등록 시도
+    console.log(chalk_1.default.cyan("\n🔌 Claude Code에 MCP 서버 등록 중..."));
+    const successServers = [];
+    const failedServers = [];
+    for (const server of allServers) {
+        const spinner = (0, ora_1.default)(`  ${server.name} 등록 중...`).start();
+        const result = registerMCPServer(server);
+        if (result.success) {
+            spinner.succeed(`  ${server.name} 등록 완료`);
+            successServers.push(server.name);
+        }
+        else {
+            spinner.fail(`  ${server.name} 등록 실패`);
+            failedServers.push(server);
+        }
+    }
+    // 결과 요약
+    if (successServers.length > 0) {
+        console.log(chalk_1.default.green(`\n✓ ${successServers.length}개 MCP 서버 자동 등록 완료`));
+    }
+    // 실패한 서버가 있으면 수동 등록 안내
+    if (failedServers.length > 0) {
+        console.log(chalk_1.default.yellow(`\n⚠ ${failedServers.length}개 MCP 서버 자동 등록 실패`));
+        console.log(chalk_1.default.cyan("\n📋 수동 등록 명령어:"));
+        console.log(chalk_1.default.gray("   다음 명령어를 터미널에서 실행하세요:\n"));
+        for (const server of failedServers) {
+            const envArgs = server.env
+                ? Object.entries(server.env).map(([k, v]) => `-e ${k}="${v}"`).join(" ")
+                : "";
+            const cmd = `claude mcp add ${server.name} ${envArgs} -- ${server.command} ${server.args.join(" ")}`.trim();
+            console.log(chalk_1.default.white(`   ${cmd}`));
+        }
+        console.log();
+    }
 }
 // === Extension settings 병합 (add 명령어용) ===
 async function mergeExtensionSettings(cwd, packages) {
@@ -506,6 +616,7 @@ async function mergeExtensionSettings(cwd, packages) {
         return;
     }
     const settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    const newServers = [];
     for (const pkg of packages) {
         const extSettingsPath = path.join(semoSystemDir, pkg, "settings.local.json");
         if (fs.existsSync(extSettingsPath)) {
@@ -514,7 +625,16 @@ async function mergeExtensionSettings(cwd, packages) {
                 // mcpServers 병합
                 if (extSettings.mcpServers) {
                     settings.mcpServers = settings.mcpServers || {};
-                    Object.assign(settings.mcpServers, extSettings.mcpServers);
+                    for (const [name, config] of Object.entries(extSettings.mcpServers)) {
+                        const serverConfig = config;
+                        settings.mcpServers[name] = serverConfig;
+                        newServers.push({
+                            name,
+                            command: serverConfig.command,
+                            args: serverConfig.args,
+                            env: serverConfig.env,
+                        });
+                    }
                     console.log(chalk_1.default.gray(`  + ${pkg} MCP 설정 병합됨`));
                 }
                 // permissions 병합
@@ -541,6 +661,39 @@ async function mergeExtensionSettings(cwd, packages) {
         }
     }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    // 새 MCP 서버 Claude Code에 등록
+    if (newServers.length > 0) {
+        console.log(chalk_1.default.cyan("\n🔌 Claude Code에 MCP 서버 등록 중..."));
+        const successServers = [];
+        const failedServers = [];
+        for (const server of newServers) {
+            const spinner = (0, ora_1.default)(`  ${server.name} 등록 중...`).start();
+            const result = registerMCPServer(server);
+            if (result.success) {
+                spinner.succeed(`  ${server.name} 등록 완료`);
+                successServers.push(server.name);
+            }
+            else {
+                spinner.fail(`  ${server.name} 등록 실패`);
+                failedServers.push(server);
+            }
+        }
+        if (successServers.length > 0) {
+            console.log(chalk_1.default.green(`\n✓ ${successServers.length}개 MCP 서버 자동 등록 완료`));
+        }
+        if (failedServers.length > 0) {
+            console.log(chalk_1.default.yellow(`\n⚠ ${failedServers.length}개 MCP 서버 자동 등록 실패`));
+            console.log(chalk_1.default.cyan("\n📋 수동 등록 명령어:"));
+            for (const server of failedServers) {
+                const envArgs = server.env
+                    ? Object.entries(server.env).map(([k, v]) => `-e ${k}="${v}"`).join(" ")
+                    : "";
+                const cmd = `claude mcp add ${server.name} ${envArgs} -- ${server.command} ${server.args.join(" ")}`.trim();
+                console.log(chalk_1.default.white(`   ${cmd}`));
+            }
+            console.log();
+        }
+    }
 }
 // === Context Mesh 초기화 ===
 async function setupContextMesh(cwd) {
@@ -551,36 +704,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 생성됨"));
@@ -588,36 +741,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 생성됨"));
@@ -627,27 +780,27 @@ _아직 기록된 결정이 없습니다._
     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 생성됨"));
     }
 }
-// === CLAUDE.md 생성 ===
+// === CLAUDE.md 생성 (패키지 CLAUDE.md 병합 지원) ===
 async function setupClaudeMd(cwd, extensions, force) {
     console.log(chalk_1.default.cyan("\n📄 CLAUDE.md 설정"));
     const claudeMdPath = path.join(cwd, ".claude", "CLAUDE.md");
@@ -658,71 +811,160 @@ async function setupClaudeMd(cwd, extensions, force) {
             return;
         }
     }
+    const semoSystemDir = path.join(cwd, "semo-system");
     const extensionsList = extensions.length > 0
         ? extensions.map(pkg => `├── ${pkg}/              # ${EXTENSION_PACKAGES[pkg].name}`).join("\n")
         : "";
-    const claudeMdContent = `# SEMO Project Configuration
-
-> SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
-
-## 설치된 구성
-
-### 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:slack\` | Slack 메시지 전송 |
-| \`/SEMO:feedback\` | 피드백 제출 |
-| \`/SEMO:health\` | 환경 검증 |
-| \`/SEMO:update\` | SEMO 업데이트 |
-
-## 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") : ""}
+    // 패키지별 CLAUDE.md 병합 섹션 생성
+    let packageClaudeMdSections = "";
+    for (const pkg of extensions) {
+        const pkgClaudeMdPath = path.join(semoSystemDir, pkg, "CLAUDE.md");
+        if (fs.existsSync(pkgClaudeMdPath)) {
+            const pkgContent = fs.readFileSync(pkgClaudeMdPath, "utf-8");
+            // 첫 헤더(#)를 ##로 변경하여 하위 섹션으로 만듦
+            const adjustedContent = pkgContent
+                .replace(/^# /gm, "### ")
+                .replace(/^## /gm, "#### ");
+            packageClaudeMdSections += `\n\n---\n\n## ${EXTENSION_PACKAGES[pkg].name} 패키지 컨텍스트\n\n${adjustedContent}`;
+            console.log(chalk_1.default.gray(`  + ${pkg}/CLAUDE.md 병합됨`));
+        }
+    }
+    const claudeMdContent = `# SEMO Project Configuration
+
+> SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
+
+---
+
+## 🔴 MANDATORY: Orchestrator-First Execution
+
+> **⚠️ 이 규칙은 모든 사용자 요청에 적용됩니다. 예외 없음.**
+
+### 실행 흐름 (필수)
+
+\`\`\`
+1. 사용자 요청 수신
+2. [SEMO] Orchestrator 메시지 출력 (의도 분석)
+3. Orchestrator가 적절한 Agent/Skill 라우팅
+4. [SEMO] Agent/Skill 메시지 출력
+5. 실행 결과 반환
+\`\`\`
+
+### 모든 응답은 다음으로 시작
+
+\`\`\`
+[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
+[SEMO] {Agent/Skill} 호출: {target} (사유: {reason})
+\`\`\`
+
+### Orchestrator 참조
+
+**반드시 읽어야 할 파일**: \`semo-system/semo-core/agents/orchestrator/orchestrator.md\`
+
+이 파일에서 라우팅 테이블, 의도 분류, 메시지 포맷을 확인하세요.
+
+---
+
+## 🔴 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 우회 시도 거부
+- "그냥 커밋해줘", "빌드 생략해줘" 등 거부
+
+### 3. SEMO Message Format
+
+모든 SEMO 동작은 시스템 메시지로 시작:
+
+\`\`\`
+[SEMO] {Component}: {Action} → {Result}
+\`\`\`
+
+---
+
+## 설치된 구성
+
+### 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:slack\` | Slack 메시지 전송 |
+| \`/SEMO:feedback\` | 피드백 제출 |
+| \`/SEMO:health\` | 환경 검증 |
+| \`/SEMO:update\` | SEMO 업데이트 |
+
+## 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 생성됨"));
+    if (packageClaudeMdSections) {
+        console.log(chalk_1.default.green(`  + ${extensions.length}개 패키지 CLAUDE.md 병합 완료`));
+    }
 }
 // === add 명령어 ===
 program

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "@team-semicolon/semo-cli",
-  "version": "2.0.2",
-  "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
-  "main": "dist/index.js",
-  "bin": {
-    "semo": "./dist/index.js",
-    "semo-cli": "./dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "ts-node src/index.ts"
-  },
-  "keywords": [
-    "semo",
-    "cli",
-    "ai-agent",
-    "claude",
-    "semicolon"
-  ],
-  "author": "Semicolon DevTeam",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/semicolon-devteam/semo.git",
-    "directory": "packages/cli"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "ora": "^8.0.0",
-    "inquirer": "^9.2.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/inquirer": "^9.0.0",
-    "typescript": "^5.0.0",
-    "ts-node": "^10.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ]
-}
+{
+  "name": "@team-semicolon/semo-cli",
+  "version": "2.0.5",
+  "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
+  "main": "dist/index.js",
+  "bin": {
+    "semo": "./dist/index.js",
+    "semo-cli": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "semo",
+    "cli",
+    "ai-agent",
+    "claude",
+    "semicolon"
+  ],
+  "author": "Semicolon DevTeam",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/semicolon-devteam/semo.git",
+    "directory": "packages/cli"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.0",
+    "inquirer": "^9.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/inquirer": "^9.0.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}