npm - @team-semicolon/semo-cli - Versions diffs - 1.2.0 → 2.0.0 - Mend

@team-semicolon/semo-cli 1.2.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
 /**
- * SEMO CLI
+ * SEMO CLI v2.0
  *
- * Gemini 하이브리드 전략에 따른 SEMO 설치 자동화 도구
+ * Gemini 하이브리드 전략 기반 AI Agent Orchestration Framework
  *
  * 사용법:
- *   npx @team-semicolon/semo-cli init
+ *   npx @team-semicolon/semo-cli init          # 기본 설치
+ *   npx @team-semicolon/semo-cli add next      # 패키지 추가
+ *   npx @team-semicolon/semo-cli list          # 패키지 목록
  *
- * 동작:
- *   1. White Box (semo-core, semo-skills) → Git Subtree로 주입
- *   2. Black Box (semo-integrations) → MCP 설정 파일 생성
- *   3. Context Mesh (.claude/memory/) 초기화
+ * 구조:
+ *   - Standard: semo-core + semo-skills (필수)
+ *   - Extensions: packages/next, packages/backend 등 (선택)
  */
 export {};

package/dist/index.js CHANGED Viewed

@@ -1,17 +1,18 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * SEMO CLI
+ * SEMO CLI v2.0
  *
- * Gemini 하이브리드 전략에 따른 SEMO 설치 자동화 도구
+ * Gemini 하이브리드 전략 기반 AI Agent Orchestration Framework
  *
  * 사용법:
- *   npx @team-semicolon/semo-cli init
+ *   npx @team-semicolon/semo-cli init          # 기본 설치
+ *   npx @team-semicolon/semo-cli add next      # 패키지 추가
+ *   npx @team-semicolon/semo-cli list          # 패키지 목록
  *
- * 동작:
- *   1. White Box (semo-core, semo-skills) → Git Subtree로 주입
- *   2. Black Box (semo-integrations) → MCP 설정 파일 생성
- *   3. Context Mesh (.claude/memory/) 초기화
+ * 구조:
+ *   - Standard: semo-core + semo-skills (필수)
+ *   - Extensions: packages/next, packages/backend 등 (선택)
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -57,11 +58,29 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const VERSION = "1.2.0";
-// === 유틸리티: 덮어쓰기 확인 ===
+const VERSION = "2.0.0";
+const SEMO_REPO = "https://github.com/semicolon-devteam/semo.git";
+// 확장 패키지 정의
+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: [] },
+};
+const program = new commander_1.Command();
+program
+    .name("semo")
+    .description("SEMO CLI - AI Agent Orchestration Framework")
+    .version(VERSION);
+// === 유틸리티 함수들 ===
 async function confirmOverwrite(itemName, itemPath) {
     if (!fs.existsSync(itemPath)) {
-        return true; // 파일이 없으면 진행
+        return true;
     }
     const { shouldOverwrite } = await inquirer_1.default.prompt([
         {
@@ -73,19 +92,25 @@ async function confirmOverwrite(itemName, itemPath) {
     ]);
     return shouldOverwrite;
 }
-const SEMO_REPO = "https://github.com/semicolon-devteam/semo.git";
-const program = new commander_1.Command();
-program
-    .name("semo")
-    .description("SEMO CLI - AI Agent Orchestration Framework")
-    .version(VERSION);
+function detectProjectType(cwd) {
+    const detected = [];
+    for (const [key, pkg] of Object.entries(EXTENSION_PACKAGES)) {
+        for (const file of pkg.detect) {
+            if (fs.existsSync(path.join(cwd, file))) {
+                detected.push(key);
+                break;
+            }
+        }
+    }
+    return detected;
+}
 // === init 명령어 ===
 program
     .command("init")
-    .description("현재 프로젝트에 SEMO를 설치합니다 (Gemini 하이브리드 전략)")
+    .description("현재 프로젝트에 SEMO를 설치합니다")
     .option("-f, --force", "기존 설정 덮어쓰기")
     .option("--skip-mcp", "MCP 설정 생략")
-    .option("--skip-subtree", "Git Subtree 생략 (MCP만 설정)")
+    .option("--with <packages>", "추가 설치할 패키지 (쉼표 구분: next,backend)")
     .action(async (options) => {
     console.log(chalk_1.default.cyan.bold("\n🚀 SEMO 설치 시작\n"));
     console.log(chalk_1.default.gray("Gemini 하이브리드 전략: White Box + Black Box\n"));
@@ -100,103 +125,200 @@ program
         spinner.fail("Git 레포지토리가 아닙니다. 'git init'을 먼저 실행하세요.");
         process.exit(1);
     }
-    // 2. .claude 디렉토리 생성
+    // 2. 프로젝트 유형 감지
+    const detected = detectProjectType(cwd);
+    let extensionsToInstall = [];
+    if (options.with) {
+        extensionsToInstall = options.with.split(",").map((p) => p.trim()).filter((p) => p in EXTENSION_PACKAGES);
+    }
+    else if (detected.length > 0) {
+        console.log(chalk_1.default.cyan("\n📦 감지된 프로젝트 유형:"));
+        detected.forEach(pkg => {
+            console.log(chalk_1.default.gray(`   - ${EXTENSION_PACKAGES[pkg].name}: ${EXTENSION_PACKAGES[pkg].desc}`));
+        });
+        const { installDetected } = await inquirer_1.default.prompt([
+            {
+                type: "confirm",
+                name: "installDetected",
+                message: "감지된 패키지를 함께 설치할까요?",
+                default: true,
+            },
+        ]);
+        if (installDetected) {
+            extensionsToInstall = detected;
+        }
+    }
+    // 3. .claude 디렉토리 생성
     const claudeDir = path.join(cwd, ".claude");
     if (!fs.existsSync(claudeDir)) {
         fs.mkdirSync(claudeDir, { recursive: true });
-        console.log(chalk_1.default.green("✓ .claude/ 디렉토리 생성됨"));
+        console.log(chalk_1.default.green("\n✓ .claude/ 디렉토리 생성됨"));
     }
-    // 3. White Box: Git Subtree로 semo-core, semo-skills 주입
-    if (!options.skipSubtree) {
-        await setupWhiteBox(cwd, options.force);
+    // 4. Standard 설치 (semo-core + semo-skills)
+    await setupStandard(cwd, options.force);
+    // 5. Extensions 설치
+    if (extensionsToInstall.length > 0) {
+        await setupExtensions(cwd, extensionsToInstall, options.force);
     }
-    // 4. Black Box: MCP 설정 파일 생성
+    // 6. MCP 설정
     if (!options.skipMcp) {
-        await setupBlackBox(cwd, options.force);
+        await setupMCP(cwd, options.force);
     }
-    // 5. Context Mesh 초기화
+    // 7. Context Mesh 초기화
     await setupContextMesh(cwd);
-    // 6. CLAUDE.md 생성
-    await setupClaudeMd(cwd, options.force);
+    // 8. CLAUDE.md 생성
+    await setupClaudeMd(cwd, extensionsToInstall, options.force);
+    // 완료 메시지
     console.log(chalk_1.default.green.bold("\n✅ SEMO 설치 완료!\n"));
-    console.log(chalk_1.default.cyan("다음 단계:"));
+    console.log(chalk_1.default.cyan("설치된 구성:"));
+    console.log(chalk_1.default.gray("  [Standard]"));
+    console.log(chalk_1.default.gray("    ✓ semo-core (원칙, 오케스트레이터)"));
+    console.log(chalk_1.default.gray("    ✓ semo-skills (13개 통합 스킬)"));
+    if (extensionsToInstall.length > 0) {
+        console.log(chalk_1.default.gray("  [Extensions]"));
+        extensionsToInstall.forEach(pkg => {
+            console.log(chalk_1.default.gray(`    ✓ ${EXTENSION_PACKAGES[pkg].name}`));
+        });
+    }
+    console.log(chalk_1.default.cyan("\n다음 단계:"));
     console.log(chalk_1.default.gray("  1. Claude Code에서 프로젝트 열기"));
     console.log(chalk_1.default.gray("  2. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
-    console.log(chalk_1.default.gray("  3. /SEMO:help로 도움말 확인\n"));
+    console.log(chalk_1.default.gray("  3. /SEMO:help로 도움말 확인"));
+    if (extensionsToInstall.length === 0 && detected.length === 0) {
+        console.log(chalk_1.default.gray("\n💡 추가 패키지: semo add <package> (예: semo add next)"));
+    }
+    console.log();
 });
-// === White Box 설정 (Git Subtree) ===
-async function setupWhiteBox(cwd, force) {
+// === Standard 설치 (semo-core + semo-skills) ===
+async function setupStandard(cwd, force) {
     const semoSystemDir = path.join(cwd, "semo-system");
-    console.log(chalk_1.default.cyan("\n📚 White Box 설정 (Git Subtree)"));
-    console.log(chalk_1.default.gray("   에이전트가 읽고 학습할 지식 베이스\n"));
-    // semo-system 디렉토리 확인 - force가 아니면 사용자에게 확인
+    console.log(chalk_1.default.cyan("\n📚 Standard 설치 (White Box)"));
+    console.log(chalk_1.default.gray("   semo-core: 원칙, 오케스트레이터"));
+    console.log(chalk_1.default.gray("   semo-skills: 13개 통합 스킬\n"));
+    // 기존 디렉토리 확인
     if (fs.existsSync(semoSystemDir) && !force) {
         const shouldOverwrite = await confirmOverwrite("semo-system/", semoSystemDir);
         if (!shouldOverwrite) {
             console.log(chalk_1.default.gray("  → semo-system/ 건너뜀"));
             return;
         }
-        // 기존 디렉토리 삭제
-        (0, child_process_1.execSync)(`rm -rf ${semoSystemDir}`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`rm -rf "${semoSystemDir}"`, { stdio: "pipe" });
         console.log(chalk_1.default.green("  ✓ 기존 semo-system/ 삭제됨"));
     }
     const spinner = (0, ora_1.default)("semo-core, semo-skills 다운로드 중...").start();
     try {
-        // Git Subtree로 semo-core 추가
-        if (!fs.existsSync(path.join(semoSystemDir, "semo-core"))) {
-            (0, child_process_1.execSync)(`git subtree add --prefix=semo-system/semo-core ${SEMO_REPO} main --squash 2>/dev/null || true`, { cwd, stdio: "pipe" });
+        const tempDir = path.join(cwd, ".semo-temp");
+        (0, child_process_1.execSync)(`rm -rf "${tempDir}"`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`git clone --depth 1 ${SEMO_REPO} "${tempDir}"`, { stdio: "pipe" });
+        fs.mkdirSync(semoSystemDir, { recursive: true });
+        // semo-core 복사
+        if (fs.existsSync(path.join(tempDir, "semo-core"))) {
+            (0, child_process_1.execSync)(`cp -r "${tempDir}/semo-core" "${semoSystemDir}/"`, { stdio: "pipe" });
         }
-        // semo-skills 추가 (같은 레포에서)
-        if (!fs.existsSync(path.join(semoSystemDir, "semo-skills"))) {
-            // subtree split으로 특정 폴더만 가져오기는 복잡하므로 전체 clone 후 복사
-            const tempDir = path.join(cwd, ".semo-temp");
-            if (!fs.existsSync(tempDir)) {
-                (0, child_process_1.execSync)(`git clone --depth 1 ${SEMO_REPO} ${tempDir}`, { stdio: "pipe" });
-            }
-            // semo-core와 semo-skills 복사
-            fs.mkdirSync(semoSystemDir, { recursive: true });
-            if (fs.existsSync(path.join(tempDir, "semo-core"))) {
-                (0, child_process_1.execSync)(`cp -r ${tempDir}/semo-core ${semoSystemDir}/`, { stdio: "pipe" });
-            }
-            if (fs.existsSync(path.join(tempDir, "semo-skills"))) {
-                (0, child_process_1.execSync)(`cp -r ${tempDir}/semo-skills ${semoSystemDir}/`, { stdio: "pipe" });
-            }
-            // 임시 디렉토리 삭제
-            (0, child_process_1.execSync)(`rm -rf ${tempDir}`, { stdio: "pipe" });
+        // semo-skills 복사
+        if (fs.existsSync(path.join(tempDir, "semo-skills"))) {
+            (0, child_process_1.execSync)(`cp -r "${tempDir}/semo-skills" "${semoSystemDir}/"`, { stdio: "pipe" });
         }
-        spinner.succeed("White Box 설정 완료 (semo-core, semo-skills)");
-        // .claude 심볼릭 링크 생성
-        const claudeDir = path.join(cwd, ".claude");
-        const agentsLink = path.join(claudeDir, "agents");
-        const skillsLink = path.join(claudeDir, "skills");
-        if (!fs.existsSync(agentsLink)) {
+        (0, child_process_1.execSync)(`rm -rf "${tempDir}"`, { stdio: "pipe" });
+        spinner.succeed("Standard 설치 완료");
+        // 심볼릭 링크 생성
+        await createStandardSymlinks(cwd);
+    }
+    catch (error) {
+        spinner.fail("Standard 설치 실패");
+        console.error(chalk_1.default.red(`   ${error}`));
+    }
+}
+// === Standard 심볼릭 링크 ===
+async function createStandardSymlinks(cwd) {
+    const claudeDir = path.join(cwd, ".claude");
+    const semoSystemDir = path.join(cwd, "semo-system");
+    // agents 링크
+    const agentsLink = path.join(claudeDir, "agents");
+    if (!fs.existsSync(agentsLink)) {
+        const agentsTarget = path.join(semoSystemDir, "semo-core", "agents");
+        if (fs.existsSync(agentsTarget)) {
             fs.symlinkSync("../semo-system/semo-core/agents", agentsLink);
             console.log(chalk_1.default.green("  ✓ .claude/agents → semo-system/semo-core/agents"));
         }
-        if (!fs.existsSync(skillsLink)) {
+    }
+    // skills 링크
+    const skillsLink = path.join(claudeDir, "skills");
+    if (!fs.existsSync(skillsLink)) {
+        const skillsTarget = path.join(semoSystemDir, "semo-skills");
+        if (fs.existsSync(skillsTarget)) {
             fs.symlinkSync("../semo-system/semo-skills", skillsLink);
             console.log(chalk_1.default.green("  ✓ .claude/skills → semo-system/semo-skills"));
         }
-        // commands 심볼릭 링크 생성
-        const commandsDir = path.join(claudeDir, "commands");
-        fs.mkdirSync(commandsDir, { recursive: true });
-        const semoCommandsLink = path.join(commandsDir, "SEMO");
-        if (!fs.existsSync(semoCommandsLink)) {
+    }
+    // commands 링크
+    const commandsDir = path.join(claudeDir, "commands");
+    fs.mkdirSync(commandsDir, { recursive: true });
+    const semoCommandsLink = path.join(commandsDir, "SEMO");
+    if (!fs.existsSync(semoCommandsLink)) {
+        const commandsTarget = path.join(semoSystemDir, "semo-core", "commands", "SEMO");
+        if (fs.existsSync(commandsTarget)) {
             fs.symlinkSync("../../semo-system/semo-core/commands/SEMO", semoCommandsLink);
             console.log(chalk_1.default.green("  ✓ .claude/commands/SEMO → semo-system/semo-core/commands/SEMO"));
         }
     }
+}
+// === Extensions 설치 ===
+async function setupExtensions(cwd, packages, force) {
+    console.log(chalk_1.default.cyan("\n📦 Extensions 설치"));
+    packages.forEach(pkg => {
+        console.log(chalk_1.default.gray(`   - ${EXTENSION_PACKAGES[pkg].name}`));
+    });
+    console.log();
+    const spinner = (0, ora_1.default)("Extension 패키지 다운로드 중...").start();
+    try {
+        const tempDir = path.join(cwd, ".semo-temp");
+        // 이미 temp가 없으면 clone
+        if (!fs.existsSync(tempDir)) {
+            (0, child_process_1.execSync)(`git clone --depth 1 ${SEMO_REPO} "${tempDir}"`, { stdio: "pipe" });
+        }
+        const semoSystemDir = path.join(cwd, "semo-system");
+        for (const pkg of packages) {
+            const srcPath = path.join(tempDir, "packages", pkg);
+            const destPath = path.join(semoSystemDir, pkg);
+            if (fs.existsSync(srcPath)) {
+                if (fs.existsSync(destPath) && !force) {
+                    console.log(chalk_1.default.yellow(`  ⚠ ${pkg}/ 이미 존재 (건너뜀)`));
+                    continue;
+                }
+                (0, child_process_1.execSync)(`rm -rf "${destPath}"`, { stdio: "pipe" });
+                (0, child_process_1.execSync)(`cp -r "${srcPath}" "${destPath}"`, { stdio: "pipe" });
+            }
+        }
+        (0, child_process_1.execSync)(`rm -rf "${tempDir}"`, { stdio: "pipe" });
+        spinner.succeed(`Extensions 설치 완료 (${packages.length}개)`);
+        // Extensions 심볼릭 링크 생성
+        await createExtensionSymlinks(cwd, packages);
+    }
     catch (error) {
-        spinner.fail("White Box 설정 실패");
+        spinner.fail("Extensions 설치 실패");
         console.error(chalk_1.default.red(`   ${error}`));
     }
 }
-// === Black Box 설정 (MCP) ===
-async function setupBlackBox(cwd, force) {
+// === Extensions 심볼릭 링크 ===
+async function createExtensionSymlinks(cwd, packages) {
+    const claudeDir = path.join(cwd, ".claude");
+    const semoSystemDir = path.join(cwd, "semo-system");
+    for (const pkg of packages) {
+        // sax-{pkg} 호환 링크 (기존 SAX 사용자용)
+        const saxPkgLink = path.join(claudeDir, `sax-${pkg}`);
+        const pkgPath = path.join(semoSystemDir, pkg);
+        if (fs.existsSync(pkgPath) && !fs.existsSync(saxPkgLink)) {
+            fs.symlinkSync(`../semo-system/${pkg}`, saxPkgLink);
+            console.log(chalk_1.default.green(`  ✓ .claude/sax-${pkg} → semo-system/${pkg}`));
+        }
+    }
+}
+// === MCP 설정 ===
+async function setupMCP(cwd, force) {
     console.log(chalk_1.default.cyan("\n🔧 Black Box 설정 (MCP Server)"));
     console.log(chalk_1.default.gray("   토큰이 격리된 외부 연동 도구\n"));
     const settingsPath = path.join(cwd, ".claude", "settings.json");
-    // 기존 설정 파일 확인 - force가 아니면 사용자에게 확인
     if (fs.existsSync(settingsPath) && !force) {
         const shouldOverwrite = await confirmOverwrite(".claude/settings.json", settingsPath);
         if (!shouldOverwrite) {
@@ -220,7 +342,6 @@ async function setupBlackBox(cwd, force) {
     };
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
     console.log(chalk_1.default.green("✓ .claude/settings.json 생성됨 (MCP 설정)"));
-    console.log(chalk_1.default.gray("  → semo-integrations: github, slack, supabase"));
 }
 // === Context Mesh 초기화 ===
 async function setupContextMesh(cwd) {
@@ -234,6 +355,7 @@ async function setupContextMesh(cwd) {
         const contextContent = `# Project Context
 > 세션 간 영속화되는 프로젝트 컨텍스트
+> SEMO의 memory 스킬이 이 파일을 자동으로 업데이트합니다.
 ---
@@ -242,7 +364,7 @@ async function setupContextMesh(cwd) {
 | 항목 | 값 |
 |------|-----|
 | **이름** | ${path.basename(cwd)} |
-| **SEMO 버전** | 2.0.0 |
+| **SEMO 버전** | ${VERSION} |
 | **설치일** | ${new Date().toISOString().split("T")[0]} |
 ---
@@ -253,6 +375,12 @@ _아직 작업 기록이 없습니다._
 ---
+## 기술 스택
+_프로젝트 분석 후 자동으로 채워집니다._
+---
 *마지막 업데이트: ${new Date().toISOString().split("T")[0]}*
 `;
         fs.writeFileSync(contextPath, contextContent);
@@ -264,6 +392,7 @@ _아직 작업 기록이 없습니다._
         const decisionsContent = `# Architecture Decisions
 > 프로젝트 아키텍처 결정 기록 (ADR)
+> 중요한 기술적 결정을 여기에 기록합니다.
 ---
@@ -320,10 +449,9 @@ _SEMO 기본 규칙의 예외 사항을 여기에 추가하세요._
     }
 }
 // === CLAUDE.md 생성 ===
-async function setupClaudeMd(cwd, force) {
+async function setupClaudeMd(cwd, extensions, force) {
     console.log(chalk_1.default.cyan("\n📄 CLAUDE.md 설정"));
     const claudeMdPath = path.join(cwd, ".claude", "CLAUDE.md");
-    // 기존 CLAUDE.md 확인 - force가 아니면 사용자에게 확인
     if (fs.existsSync(claudeMdPath) && !force) {
         const shouldOverwrite = await confirmOverwrite("CLAUDE.md", claudeMdPath);
         if (!shouldOverwrite) {
@@ -331,25 +459,41 @@ async function setupClaudeMd(cwd, force) {
             return;
         }
     }
+    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
+> 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, sax-help, sax-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
+├── memory/            # Context Mesh (장기 기억)
 │   ├── context.md     # 프로젝트 상태
 │   ├── decisions.md   # 아키텍처 결정
 │   └── rules/         # 프로젝트별 규칙
 ├── agents → semo-system/semo-core/agents
-└── skills → semo-system/semo-skills
+├── 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: coder, tester, planner
+├── semo-skills/       # Layer 1: 통합 스킬
+${extensionsList}
 \`\`\`
 ## 사용 가능한 커맨드
@@ -360,26 +504,81 @@ semo-system/           # White Box (읽기 전용)
 | \`/SEMO:slack\` | Slack 메시지 전송 |
 | \`/SEMO:feedback\` | 피드백 제출 |
 | \`/SEMO:health\` | 환경 검증 |
+| \`/SEMO:update\` | SEMO 업데이트 |
+## Context Mesh 사용
-## 플랫폼 자동 감지
+SEMO는 \`.claude/memory/\`를 통해 세션 간 컨텍스트를 유지합니다:
-SEMO는 프로젝트 파일을 분석하여 플랫폼을 자동 감지합니다:
+- **context.md**: 프로젝트 상태, 진행 중인 작업
+- **decisions.md**: 아키텍처 결정 기록 (ADR)
+- **rules/**: 프로젝트별 커스텀 규칙
-| 파일 | 플랫폼 |
-|------|--------|
-| \`next.config.js\` | Next.js |
-| \`pom.xml\` | Spring |
-| \`docker-compose.yml\` | Microservice |
-| 기타 | MVP |
+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") : ""}
 `;
     fs.writeFileSync(claudeMdPath, claudeMdContent);
     console.log(chalk_1.default.green("✓ .claude/CLAUDE.md 생성됨"));
 }
+// === add 명령어 ===
+program
+    .command("add <package>")
+    .description("Extension 패키지를 추가로 설치합니다")
+    .option("-f, --force", "기존 설정 덮어쓰기")
+    .action(async (packageName, options) => {
+    const cwd = process.cwd();
+    const semoSystemDir = path.join(cwd, "semo-system");
+    if (!fs.existsSync(semoSystemDir)) {
+        console.log(chalk_1.default.red("\nSEMO가 설치되어 있지 않습니다. 'semo init'을 먼저 실행하세요.\n"));
+        process.exit(1);
+    }
+    if (!(packageName in EXTENSION_PACKAGES)) {
+        console.log(chalk_1.default.red(`\n알 수 없는 패키지: ${packageName}`));
+        console.log(chalk_1.default.gray(`사용 가능한 패키지: ${Object.keys(EXTENSION_PACKAGES).join(", ")}\n`));
+        process.exit(1);
+    }
+    const pkgPath = path.join(semoSystemDir, packageName);
+    if (fs.existsSync(pkgPath) && !options.force) {
+        console.log(chalk_1.default.yellow(`\n${EXTENSION_PACKAGES[packageName].name} 패키지가 이미 설치되어 있습니다.`));
+        console.log(chalk_1.default.gray("강제 재설치: semo add " + packageName + " --force\n"));
+        return;
+    }
+    console.log(chalk_1.default.cyan(`\n📦 ${EXTENSION_PACKAGES[packageName].name} 패키지 설치\n`));
+    console.log(chalk_1.default.gray(`   ${EXTENSION_PACKAGES[packageName].desc}\n`));
+    await setupExtensions(cwd, [packageName], options.force);
+    console.log(chalk_1.default.green.bold(`\n✅ ${EXTENSION_PACKAGES[packageName].name} 패키지 설치 완료!\n`));
+});
+// === list 명령어 ===
+program
+    .command("list")
+    .description("사용 가능한 모든 패키지를 표시합니다")
+    .action(() => {
+    const cwd = process.cwd();
+    const semoSystemDir = path.join(cwd, "semo-system");
+    console.log(chalk_1.default.cyan.bold("\n📦 SEMO 패키지 목록\n"));
+    // Standard
+    console.log(chalk_1.default.white.bold("Standard (필수)"));
+    const coreInstalled = fs.existsSync(path.join(semoSystemDir, "semo-core"));
+    const skillsInstalled = fs.existsSync(path.join(semoSystemDir, "semo-skills"));
+    console.log(`  ${coreInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○")} semo-core - 원칙, 오케스트레이터`);
+    console.log(`  ${skillsInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○")} semo-skills - 13개 통합 스킬`);
+    console.log();
+    // Extensions
+    console.log(chalk_1.default.white.bold("Extensions (선택)"));
+    for (const [key, pkg] of Object.entries(EXTENSION_PACKAGES)) {
+        const isInstalled = fs.existsSync(path.join(semoSystemDir, key));
+        const status = isInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○");
+        console.log(`  ${status} ${key} - ${pkg.desc}`);
+    }
+    console.log();
+    console.log(chalk_1.default.gray("설치: semo add <package>"));
+    console.log(chalk_1.default.gray("예시: semo add next\n"));
+});
 // === status 명령어 ===
 program
     .command("status")
@@ -387,26 +586,50 @@ program
     .action(() => {
     console.log(chalk_1.default.cyan.bold("\n📊 SEMO 설치 상태\n"));
     const cwd = process.cwd();
-    const checks = [
-        { name: ".claude/", path: path.join(cwd, ".claude"), type: "dir" },
-        { name: ".claude/settings.json", path: path.join(cwd, ".claude", "settings.json"), type: "file" },
-        { name: ".claude/memory/", path: path.join(cwd, ".claude", "memory"), type: "dir" },
-        { name: "semo-system/semo-core/", path: path.join(cwd, "semo-system", "semo-core"), type: "dir" },
-        { name: "semo-system/semo-skills/", path: path.join(cwd, "semo-system", "semo-skills"), type: "dir" },
+    const semoSystemDir = path.join(cwd, "semo-system");
+    // Standard 확인
+    console.log(chalk_1.default.white.bold("Standard:"));
+    const standardChecks = [
+        { name: "semo-core", path: path.join(semoSystemDir, "semo-core") },
+        { name: "semo-skills", path: path.join(semoSystemDir, "semo-skills") },
     ];
-    let allPassed = true;
-    for (const check of checks) {
+    let standardOk = true;
+    for (const check of standardChecks) {
         const exists = fs.existsSync(check.path);
-        if (exists) {
-            console.log(chalk_1.default.green(`✓ ${check.name}`));
+        console.log(`  ${exists ? chalk_1.default.green("✓") : chalk_1.default.red("✗")} ${check.name}`);
+        if (!exists)
+            standardOk = false;
+    }
+    // Extensions 확인
+    const installedExtensions = [];
+    for (const key of Object.keys(EXTENSION_PACKAGES)) {
+        if (fs.existsSync(path.join(semoSystemDir, key))) {
+            installedExtensions.push(key);
         }
-        else {
-            console.log(chalk_1.default.red(`✗ ${check.name}`));
-            allPassed = false;
+    }
+    if (installedExtensions.length > 0) {
+        console.log(chalk_1.default.white.bold("\nExtensions:"));
+        for (const pkg of installedExtensions) {
+            console.log(chalk_1.default.green(`  ✓ ${pkg}`));
         }
     }
+    // 구조 확인
+    console.log(chalk_1.default.white.bold("\n구조:"));
+    const structureChecks = [
+        { name: ".claude/", path: path.join(cwd, ".claude") },
+        { name: ".claude/settings.json", path: path.join(cwd, ".claude", "settings.json") },
+        { name: ".claude/memory/", path: path.join(cwd, ".claude", "memory") },
+        { name: ".claude/memory/context.md", path: path.join(cwd, ".claude", "memory", "context.md") },
+    ];
+    let structureOk = true;
+    for (const check of structureChecks) {
+        const exists = fs.existsSync(check.path);
+        console.log(`  ${exists ? chalk_1.default.green("✓") : chalk_1.default.red("✗")} ${check.name}`);
+        if (!exists)
+            structureOk = false;
+    }
     console.log();
-    if (allPassed) {
+    if (standardOk && structureOk) {
         console.log(chalk_1.default.green.bold("SEMO가 정상적으로 설치되어 있습니다."));
     }
     else {
@@ -418,7 +641,7 @@ program
 program
     .command("update")
     .description("SEMO를 최신 버전으로 업데이트합니다")
-    .action(() => {
+    .action(async () => {
     console.log(chalk_1.default.cyan.bold("\n🔄 SEMO 업데이트\n"));
     const cwd = process.cwd();
     const semoSystemDir = path.join(cwd, "semo-system");
@@ -426,18 +649,38 @@ program
         console.log(chalk_1.default.red("SEMO가 설치되어 있지 않습니다. 'semo init'을 먼저 실행하세요."));
         process.exit(1);
     }
-    const spinner = (0, ora_1.default)("최신 버전 다운로드 중...").start();
+    // 설치된 Extensions 확인
+    const installedExtensions = [];
+    for (const key of Object.keys(EXTENSION_PACKAGES)) {
+        if (fs.existsSync(path.join(semoSystemDir, key))) {
+            installedExtensions.push(key);
+        }
+    }
+    console.log(chalk_1.default.cyan("업데이트 대상:"));
+    console.log(chalk_1.default.gray("  - semo-core"));
+    console.log(chalk_1.default.gray("  - semo-skills"));
+    installedExtensions.forEach(pkg => {
+        console.log(chalk_1.default.gray(`  - ${pkg}`));
+    });
+    const spinner = (0, ora_1.default)("\n최신 버전 다운로드 중...").start();
     try {
-        // 임시 디렉토리에 최신 버전 clone
         const tempDir = path.join(cwd, ".semo-temp");
-        (0, child_process_1.execSync)(`rm -rf ${tempDir}`, { stdio: "pipe" });
-        (0, child_process_1.execSync)(`git clone --depth 1 ${SEMO_REPO} ${tempDir}`, { stdio: "pipe" });
-        // semo-core, semo-skills 업데이트
-        (0, child_process_1.execSync)(`rm -rf ${semoSystemDir}/semo-core ${semoSystemDir}/semo-skills`, { stdio: "pipe" });
-        (0, child_process_1.execSync)(`cp -r ${tempDir}/semo-core ${semoSystemDir}/`, { stdio: "pipe" });
-        (0, child_process_1.execSync)(`cp -r ${tempDir}/semo-skills ${semoSystemDir}/`, { stdio: "pipe" });
-        // 임시 디렉토리 삭제
-        (0, child_process_1.execSync)(`rm -rf ${tempDir}`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`rm -rf "${tempDir}"`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`git clone --depth 1 ${SEMO_REPO} "${tempDir}"`, { stdio: "pipe" });
+        // Standard 업데이트
+        (0, child_process_1.execSync)(`rm -rf "${semoSystemDir}/semo-core" "${semoSystemDir}/semo-skills"`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`cp -r "${tempDir}/semo-core" "${semoSystemDir}/"`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`cp -r "${tempDir}/semo-skills" "${semoSystemDir}/"`, { stdio: "pipe" });
+        // Extensions 업데이트
+        for (const pkg of installedExtensions) {
+            const srcPath = path.join(tempDir, "packages", pkg);
+            const destPath = path.join(semoSystemDir, pkg);
+            if (fs.existsSync(srcPath)) {
+                (0, child_process_1.execSync)(`rm -rf "${destPath}"`, { stdio: "pipe" });
+                (0, child_process_1.execSync)(`cp -r "${srcPath}" "${destPath}"`, { stdio: "pipe" });
+            }
+        }
+        (0, child_process_1.execSync)(`rm -rf "${tempDir}"`, { stdio: "pipe" });
         spinner.succeed("SEMO 업데이트 완료");
     }
     catch (error) {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@team-semicolon/semo-cli",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {