conductor-kit 0.0.0 → 0.1.68

package/README.ko.md

@@ -6,21 +6,34 @@
 
 ## 이게 뭔가요?
 
-conductor-kit은 다음을 도와줍니다:
-- 일관된 오케스트레이션 워크플로우 사용 (검색 → 계획 → 실행 → 검증)
-- 여러 AI CLI 간의 작업 위임 (Codex, Claude, Gemini)
-- 원하는 CLI에 전문 스킬과 커맨드 로드
+conductor-kit은 AI CLI 도구들이 함께 원활하게 작동하도록 합니다:
 
-## 빠른 시작
+- **Cross-CLI 위임**: Claude가 Codex에게 추론을, Gemini에게 웹 검색을 위임
+- **통합 스킬 시스템**: 하나의 스킬이 모든 지원 CLI에서 작동
+- **역할 기반 라우팅**: 작업을 최적의 CLI/모델 조합으로 자동 라우팅
+- **MCP 통합**: 도구 상호운용성을 위한 완전한 Model Context Protocol 지원
 
-### 설치 (macOS)
+## 설치
+
+### 옵션 1: npx (가장 쉬움)
+```bash
+npx conductor-kit install
+```
+
+### 옵션 2: Homebrew (macOS)
 ```bash
 brew tap Skyline-23/conductor-kit
 brew install --cask conductor-kit
 conductor install
 ```
 
-### 수동 설치
+### 옵션 3: npm 글로벌
+```bash
+npm install -g conductor-kit
+conductor install
+```
+
+### 옵션 4: 소스에서 빌드
 ```bash
 git clone https://github.com/Skyline-23/conductor-kit ~/.conductor-kit
 cd ~/.conductor-kit
@@ -30,30 +43,64 @@ conductor install
 
 ### 설치 확인
 ```bash
-conductor status   # CLI 가용성 및 인증 상태 확인
 conductor doctor   # 전체 진단
+conductor status   # CLI 가용성 확인
+```
+
+---
+
+## 튜토리얼: 시작하기
+
+### 1단계: AI CLI 최소 하나 설치
+
+conductor-kit은 다음 CLI들과 작동합니다:
+
+| CLI | 설치 | 인증 |
+|-----|------|------|
+| **Claude Code** | `npm install -g @anthropic-ai/claude-code` | `claude` (프롬프트 따라하기) |
+| **Codex CLI** | `npm install -g @openai/codex` | `codex --login` |
+| **Gemini CLI** | `npm install -g @anthropic-ai/gemini-cli` | `gemini auth` |
+
+### 2단계: 설치 프로그램 실행
+
+```bash
+conductor install
+```
+
+이 명령은:
+- 설치된 CLI 감지
+- `~/.claude/skills/` 및/또는 `~/.codex/skills/`에 스킬 복사
+- `~/.claude/commands/` 및/또는 `~/.codex/prompts/`에 슬래시 커맨드 복사
+- `~/.conductor-kit/conductor.json`에 설정 파일 생성
+
+### 3단계: 스킬 로드
+
+선호하는 CLI를 시작하고 conductor 스킬을 트리거하세요:
+
+```bash
+# Claude Code에서
+claude
+> conductor 스킬 로드해줘
+> sym  # 단축 트리거
 ```
 
-## 사용법
+```bash
+# Codex CLI에서
+codex
+> conductor 로드
+```
+
+스킬은 오케스트레이션 가이드와 역할 기반 위임 패턴을 제공합니다.
 
-### 1. 스킬 사용
-Claude Code 또는 Codex CLI에서 다음으로 트리거:
-- `conductor` 또는 `symphony` 또는 `sym`
+---
 
-### 2. 슬래시 커맨드
-| Claude Code | Codex CLI |
-|-------------|-----------|
-| `/conductor-plan` | `/prompts:conductor-plan` |
-| `/conductor-search` | `/prompts:conductor-search` |
-| `/conductor-implement` | `/prompts:conductor-implement` |
-| `/conductor-release` | `/prompts:conductor-release` |
-| `/conductor-symphony` | `/prompts:conductor-symphony` |
+## 튜토리얼: MCP로 Cross-CLI 위임
 
-### 3. MCP 도구 사용 (CLI 간 위임)
+conductor-kit의 진정한 힘은 한 CLI가 MCP 도구를 통해 다른 CLI를 호출하는 것입니다.
 
-통합 MCP 서버 등록:
+### 1단계: MCP 서버 등록
 
-**Claude Code** (`~/.claude/mcp.json`):
+**Claude Code용** - `~/.claude/mcp.json`에 추가:
 ```json
 {
   "mcpServers": {
@@ -65,58 +112,120 @@ Claude Code 또는 Codex CLI에서 다음으로 트리거:
 }
 ```
 
-**Codex CLI**:
+**Codex CLI용**:
 ```bash
 codex mcp add conductor -- conductor mcp
 ```
 
-사용 가능한 MCP 도구:
-| 도구 | 설명 |
-|------|------|
-| `codex` | Codex CLI 세션 실행 |
-| `codex-reply` | Codex 세션 계속 |
-| `claude` | Claude Code 세션 실행 |
-| `claude-reply` | Claude 세션 계속 |
-| `gemini` | Gemini CLI 세션 실행 |
-| `gemini-reply` | Gemini 세션 계속 |
-| `conductor` | 역할 기반 라우팅 (config 사용) |
-| `conductor-reply` | conductor 세션 계속 |
-| `status` | CLI 가용성 및 인증 확인 |
+### 2단계: 프롬프트에서 cross-CLI 도구 사용
+
+이제 Claude에게 다른 CLI에 위임하도록 요청할 수 있습니다:
 
-프롬프트에서 사용 예시:
 ```
-gemini 도구를 사용해서 인증 로직을 코드베이스에서 검색해줘
+codex 도구를 사용해서 이 알고리즘을 깊은 추론으로 분석해줘
 ```
 
+```
+gemini 도구를 사용해서 React 19 모범 사례를 웹에서 검색해줘
+```
+
+```
+conductor 도구를 "sage" 역할로 사용해서 이 복잡한 문제를 해결해줘
+```
+
+### 사용 가능한 MCP 도구
+
+| 도구 | 설명 | 예시 |
+|------|------|------|
+| `codex` | Codex CLI 세션 실행 | 깊은 추론, 복잡한 분석 |
+| `claude` | Claude Code 세션 실행 | 코드 생성, 리팩토링 |
+| `gemini` | Gemini CLI 세션 실행 | 웹 검색, 리서치 |
+| `conductor` | 역할 기반 라우팅 | 작업에 최적의 CLI 자동 선택 |
+| `*-reply` | 세션 계속 | 멀티턴 대화 |
+| `status` | CLI 가용성 확인 | 진단 |
+
+### 예시: 멀티-CLI 워크플로우
+
+```
+새로운 인증 시스템을 구현해야 해.
+
+1. gemini 도구로 2025년 OAuth 2.0 모범 사례 리서치
+2. codex 도구로 추론과 함께 아키텍처 설계
+3. 그 다음 여기 Claude에서 구현
+```
+
+---
+
+## 튜토리얼: 슬래시 커맨드 사용
+
+슬래시 커맨드는 일반적인 워크플로우에 빠르게 접근할 수 있게 합니다.
+
+### Claude Code에서
+
+| 커맨드 | 설명 |
+|--------|------|
+| `/conductor-plan` | 구현 계획 생성 |
+| `/conductor-search` | 위임으로 코드베이스 검색 |
+| `/conductor-implement` | 검증과 함께 구현 |
+| `/conductor-debug` | 멀티-CLI 분석으로 디버그 |
+| `/conductor-review` | 코드 리뷰 워크플로우 |
+| `/conductor-release` | 릴리즈 준비 |
+| `/conductor-symphony` | 풀 오케스트레이션 모드 |
+
+### Codex CLI에서
+
+커맨드 앞에 `/prompts:` 붙이기:
+```
+/prompts:conductor-plan
+/prompts:conductor-symphony
+```
+
+---
+
 ## 설정
 
 설정 파일: `~/.conductor-kit/conductor.json`
 
-### 역할 기반 라우팅 (기본값)
+### 역할 기반 라우팅
+
+역할은 작업 유형을 CLI/모델 조합에 매핑합니다:
+
 ```json
 {
   "roles": {
-    "sage": { "cli": "codex", "model": "gpt-5.2-codex", "reasoning": "medium", "description": "Deep reasoning for complex problems" },
-    "scout": { "cli": "gemini", "model": "gemini-3-flash", "description": "Web search and research" },
-    "pathfinder": { "cli": "gemini", "model": "gemini-3-flash", "description": "Codebase exploration and navigation" },
-    "pixelator": { "cli": "gemini", "model": "gemini-3-pro", "description": "Web UI/UX design and frontend" }
+    "sage": {
+      "cli": "codex",
+      "model": "gpt-5.2-codex",
+      "reasoning": "medium",
+      "description": "복잡한 문제를 위한 깊은 추론"
+    },
+    "scout": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "웹 검색과 리서치"
+    },
+    "pathfinder": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "코드베이스 탐색과 네비게이션"
+    },
+    "pixelator": {
+      "cli": "gemini",
+      "model": "gemini-3-pro",
+      "description": "웹 UI/UX 디자인과 프론트엔드"
+    }
   }
 }
 ```
 
-### 설정 마법사
+### 대화형 설정
+
 ```bash
-conductor settings              # 대화형 TUI 마법사
-conductor settings --list-models --cli codex  # 사용 가능한 모델 목록
+conductor settings              # TUI 마법사
+conductor settings --list-models --cli codex  # 모델 목록
 ```
 
-자세한 설정 옵션은 [CONFIGURATION.md](docs/CONFIGURATION.md)를 참조하세요.
-
-## 요구 사항
-
-- **호스트 CLI**: Codex CLI, Claude Code, Gemini CLI 중 최소 하나
-- **Go 1.24+**: 소스에서 빌드할 때만 필요
-- **macOS**: Homebrew cask 설치용 (Linux: 수동 설치 사용)
+---
 
 ## 명령어 참조
 
@@ -129,16 +238,57 @@ conductor settings --list-models --cli codex  # 사용 가능한 모델 목록
 | `conductor settings` | 역할 및 모델 설정 |
 | `conductor mcp` | 통합 MCP 서버 시작 |
 
+---
+
+## 문제 해결
+
+### "conductor: command not found"
+
+바이너리가 PATH에 있는지 확인:
+```bash
+# 설치 위치 확인
+which conductor
+
+# 필요하면 PATH에 추가 (npm 글로벌용)
+export PATH="$PATH:$(npm config get prefix)/bin"
+```
+
+### MCP 도구가 나타나지 않음
+
+1. MCP 설정 추가 후 CLI 재시작
+2. MCP 서버 작동 확인:
+   ```bash
+   conductor mcp --help
+   conductor status
+   ```
+
+### CLI가 감지되지 않음
+
+진단 실행:
+```bash
+conductor doctor
+```
+
+어떤 CLI가 설치되고 인증되었는지 표시됩니다.
+
+---
+
 ## 제거
 
 ```bash
 # Homebrew
 brew uninstall --cask conductor-kit
 
-# 수동
+# npm
+npm uninstall -g conductor-kit
+
+# 수동 정리
 conductor uninstall
+rm -rf ~/.conductor-kit
 ```
 
+---
+
 ## 라이선스
 
 MIT

package/README.md

@@ -6,21 +6,34 @@ A global skills pack for **Codex CLI**, **Claude Code**, and **Gemini CLI** with
 
 ## What is this?
 
-conductor-kit helps you:
-- Use a consistent orchestration workflow (search → plan → execute → verify)
-- Delegate tasks between different AI CLIs (Codex, Claude, Gemini)
-- Load specialized skills and commands into your preferred CLI
+conductor-kit enables AI CLI tools to work together seamlessly:
 
-## Quick Start
+- **Cross-CLI Delegation**: Let Claude delegate to Codex for reasoning, or Gemini for web search
+- **Unified Skill System**: One skill works across all supported CLIs
+- **Role-based Routing**: Automatically route tasks to the best CLI/model combination
+- **MCP Integration**: Full Model Context Protocol support for tool interoperability
 
-### Install (macOS)
+## Installation
+
+### Option 1: npx (Easiest)
+```bash
+npx conductor-kit install
+```
+
+### Option 2: Homebrew (macOS)
 ```bash
 brew tap Skyline-23/conductor-kit
 brew install --cask conductor-kit
 conductor install
 ```
 
-### Install (Manual)
+### Option 3: npm global
+```bash
+npm install -g conductor-kit
+conductor install
+```
+
+### Option 4: Build from source
 ```bash
 git clone https://github.com/Skyline-23/conductor-kit ~/.conductor-kit
 cd ~/.conductor-kit
@@ -30,30 +43,64 @@ conductor install
 
 ### Verify Installation
 ```bash
-conductor status   # Check CLI availability and auth status
 conductor doctor   # Full diagnostics
+conductor status   # Check CLI availability
+```
+
+---
+
+## Tutorial: Getting Started
+
+### Step 1: Install at least one AI CLI
+
+conductor-kit works with these CLIs:
+
+| CLI | Install | Auth |
+|-----|---------|------|
+| **Claude Code** | `npm install -g @anthropic-ai/claude-code` | `claude` (follow prompts) |
+| **Codex CLI** | `npm install -g @openai/codex` | `codex --login` |
+| **Gemini CLI** | `npm install -g @anthropic-ai/gemini-cli` | `gemini auth` |
+
+### Step 2: Run the installer
+
+```bash
+conductor install
+```
+
+This will:
+- Detect which CLIs are installed
+- Copy skills to `~/.claude/skills/` and/or `~/.codex/skills/`
+- Copy slash commands to `~/.claude/commands/` and/or `~/.codex/prompts/`
+- Create config at `~/.conductor-kit/conductor.json`
+
+### Step 3: Load the skill
+
+Start your preferred CLI and trigger the conductor skill:
+
+```bash
+# In Claude Code
+claude
+> Load the conductor skill
+> sym  # shorthand trigger
 ```
 
-## Usage
+```bash
+# In Codex CLI
+codex
+> Load conductor
+```
+
+The skill provides orchestration guidance and role-based delegation patterns.
 
-### 1. Use the Skill
-In Claude Code or Codex CLI, trigger by saying:
-- `conductor` or `symphony` or `sym`
+---
 
-### 2. Use Slash Commands
-| Claude Code | Codex CLI |
-|-------------|-----------|
-| `/conductor-plan` | `/prompts:conductor-plan` |
-| `/conductor-search` | `/prompts:conductor-search` |
-| `/conductor-implement` | `/prompts:conductor-implement` |
-| `/conductor-release` | `/prompts:conductor-release` |
-| `/conductor-symphony` | `/prompts:conductor-symphony` |
+## Tutorial: Cross-CLI Delegation with MCP
 
-### 3. Use MCP Tools (Cross-CLI Delegation)
+The real power of conductor-kit is letting one CLI call another via MCP tools.
 
-Register the unified MCP server:
+### Step 1: Register the MCP server
 
-**Claude Code** (`~/.claude/mcp.json`):
+**For Claude Code** - Add to `~/.claude/mcp.json`:
 ```json
 {
   "mcpServers": {
@@ -65,58 +112,120 @@ Register the unified MCP server:
 }
 ```
 
-**Codex CLI**:
+**For Codex CLI**:
 ```bash
 codex mcp add conductor -- conductor mcp
 ```
 
-Available MCP tools:
-| Tool | Description |
-|------|-------------|
-| `codex` | Run Codex CLI session |
-| `codex-reply` | Continue Codex session |
-| `claude` | Run Claude Code session |
-| `claude-reply` | Continue Claude session |
-| `gemini` | Run Gemini CLI session |
-| `gemini-reply` | Continue Gemini session |
-| `conductor` | Role-based routing (uses config) |
-| `conductor-reply` | Continue conductor session |
-| `status` | Check CLI availability and auth |
+### Step 2: Use cross-CLI tools in your prompts
+
+Now you can ask Claude to delegate to other CLIs:
+
+```
+Use the codex tool to analyze this algorithm with deep reasoning
+```
+
+```
+Use the gemini tool to search the web for React 19 best practices
+```
+
+```
+Use the conductor tool with role "sage" to solve this complex problem
+```
+
+### Available MCP Tools
+
+| Tool | Description | Example |
+|------|-------------|---------|
+| `codex` | Run Codex CLI session | Deep reasoning, complex analysis |
+| `claude` | Run Claude Code session | Code generation, refactoring |
+| `gemini` | Run Gemini CLI session | Web search, research |
+| `conductor` | Role-based routing | Auto-select best CLI for task |
+| `*-reply` | Continue a session | Multi-turn conversations |
+| `status` | Check CLI availability | Diagnostics |
+
+### Example: Multi-CLI Workflow
 
-Example usage in your prompt:
 ```
-Use the gemini tool to search the codebase for authentication logic
+I need to implement a new authentication system.
+
+1. Use the gemini tool to research OAuth 2.0 best practices for 2025
+2. Use the codex tool to design the architecture with reasoning
+3. Then implement it here in Claude
 ```
 
+---
+
+## Tutorial: Using Slash Commands
+
+Slash commands provide quick access to common workflows.
+
+### In Claude Code
+
+| Command | Description |
+|---------|-------------|
+| `/conductor-plan` | Create an implementation plan |
+| `/conductor-search` | Search codebase with delegation |
+| `/conductor-implement` | Implement with verification |
+| `/conductor-debug` | Debug with multi-CLI analysis |
+| `/conductor-review` | Code review workflow |
+| `/conductor-release` | Release preparation |
+| `/conductor-symphony` | Full orchestration mode |
+
+### In Codex CLI
+
+Prefix commands with `/prompts:`:
+```
+/prompts:conductor-plan
+/prompts:conductor-symphony
+```
+
+---
+
 ## Configuration
 
 Config file: `~/.conductor-kit/conductor.json`
 
-### Role-based Routing (Default)
+### Role-based Routing
+
+Roles map task types to CLI/model combinations:
+
 ```json
 {
   "roles": {
-    "sage": { "cli": "codex", "model": "gpt-5.2-codex", "reasoning": "medium", "description": "Deep reasoning for complex problems" },
-    "scout": { "cli": "gemini", "model": "gemini-3-flash", "description": "Web search and research" },
-    "pathfinder": { "cli": "gemini", "model": "gemini-3-flash", "description": "Codebase exploration and navigation" },
-    "pixelator": { "cli": "gemini", "model": "gemini-3-pro", "description": "Web UI/UX design and frontend" }
+    "sage": {
+      "cli": "codex",
+      "model": "gpt-5.2-codex",
+      "reasoning": "medium",
+      "description": "Deep reasoning for complex problems"
+    },
+    "scout": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "Web search and research"
+    },
+    "pathfinder": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "Codebase exploration and navigation"
+    },
+    "pixelator": {
+      "cli": "gemini",
+      "model": "gemini-3-pro",
+      "description": "Web UI/UX design and frontend"
+    }
   }
 }
 ```
 
-### Setup Wizard
+### Interactive Setup
+
 ```bash
-conductor settings              # Interactive TUI wizard
-conductor settings --list-models --cli codex  # List available models
+conductor settings              # TUI wizard
+conductor settings --list-models --cli codex  # List models
 ```
 
-For detailed configuration options, see [CONFIGURATION.md](docs/CONFIGURATION.md).
-
-## Requirements
-
-- **Host CLI**: At least one of Codex CLI, Claude Code, or Gemini CLI
-- **Go 1.24+**: Only if building from source
-- **macOS**: For Homebrew cask install (Linux: use manual install)
+---
 
 ## Commands Reference
 
@@ -129,16 +238,57 @@ For detailed configuration options, see [CONFIGURATION.md](docs/CONFIGURATION.md
 | `conductor settings` | Configure roles and models |
 | `conductor mcp` | Start unified MCP server |
 
+---
+
+## Troubleshooting
+
+### "conductor: command not found"
+
+Ensure the binary is in your PATH:
+```bash
+# Check install location
+which conductor
+
+# Add to PATH if needed (for npm global)
+export PATH="$PATH:$(npm config get prefix)/bin"
+```
+
+### MCP tools not appearing
+
+1. Restart your CLI after adding MCP config
+2. Check MCP server is working:
+   ```bash
+   conductor mcp --help
+   conductor status
+   ```
+
+### CLI not detected
+
+Run diagnostics:
+```bash
+conductor doctor
+```
+
+This shows which CLIs are installed and authenticated.
+
+---
+
 ## Uninstall
 
 ```bash
 # Homebrew
 brew uninstall --cask conductor-kit
 
-# Manual
+# npm
+npm uninstall -g conductor-kit
+
+# Manual cleanup
 conductor uninstall
+rm -rf ~/.conductor-kit
 ```
 
+---
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-kit",
-  "version": "0.0.0",
+  "version": "0.1.68",
   "description": "Global skills pack and Go helper for Codex CLI and Claude Code",
   "keywords": [
     "claude",

package/scripts/postinstall.js

@@ -109,8 +109,9 @@ async function main() {
     console.log(`Binary: ${binaryPath}`);
     
     // Run install command to set up skills/commands
+    // Use packageDir (npm package root) which contains skills/commands, not nativeDir (binary only)
     console.log('\nSetting up skills and commands...');
-    const installProcess = spawn(binaryPath, ['install', '--mode', 'link', '--repo', nativeDir], {
+    const installProcess = spawn(binaryPath, ['install', '--mode', 'copy', '--repo', packageDir], {
       stdio: 'inherit',
     });