crewx 0.3.0 → 0.4.0-dev.0

package/docs/branding-decision-crewx.md

@@ -1,395 +0,0 @@
-# 브랜딩 전략 결정: crewx vs crewx
-
-**의사결정 요청일**: 2025-10-10
-**작성자**: Dev Lead
-**검토 대상**: 전략 책임자
-
----
-
-## 📋 요약 (Executive Summary)
-
-현재 메인 제품 브랜드인 "crewx"를 "crewx"로 전환할지 결정이 필요합니다.
-
-**핵심 질문**:
-- crewx를 instant execution 서브 제품으로 유지할 것인가?
-- 아니면 crewx를 메인 브랜드로 전환할 것인가?
-
-**배경**:
-- npm 패키지명 "crewx" 선점 완료 (2025-10-10)
-- 원래 계획: crewx = npx처럼 즉시 실행 도구
-- 고민: 브랜드명 자체를 crewx로 통일하는 것이 더 강력할 수 있음
-
----
-
-## 🎯 현재 상황
-
-### 제품 구조 (계획)
-```
-crewx (메인 CLI)
-  ├─ crewx query
-  ├─ crewx execute
-  ├─ crewx crew install
-  └─ ...
-
-crewx (서브 - 즉시 실행)
-  └─ crewx @scope/crew "task"
-```
-
-### 선점 완료
-- ✅ NPM: `crewx@0.1.1` 배포 완료
-- ✅ GitHub: github.com/sowonlabs/crewx
-- ✅ 라이센스: UNLICENSED (독점)
-
----
-
-## 💡 제안: 브랜딩 3가지 옵션
-
-### Option A: 완전 전환 (crewx → crewx)
-
-**브랜드 구조**:
-```
-crewx (메인 플랫폼)
-  ├─ crewx CLI
-  ├─ crewx Registry
-  └─ crewx Cloud
-```
-
-**CLI 명령어**:
-```bash
-crewx query "@agent task"
-crewx execute "@agent task"
-crewx crew install @scope/name
-```
-
-**장점**:
-- ✅ 짧고 강력함 (5자 vs 8자, -37% 타이핑)
-- ✅ 현대적이고 기억하기 쉬움
-- ✅ "X" = eXecute, eXtend, eXperience (다의적 해석 가능)
-- ✅ npm/npx 레퍼런스 효과 극대화
-- ✅ 브랜드 단순화 (하나의 이름)
-
-**단점**:
-- ❌ "code" 키워드 SEO 손실
-- ❌ 개발자 타겟팅 덜 명확
-- ❌ 리브랜딩 비용 (하지만 v0.1.0이라 최소)
-
-**투자자 피치**:
-> "crewx - The npm for AI agents. Execute, extend, and experience AI crews instantly."
-
----
-
-### Option B: 듀얼 브랜딩
-
-**브랜드 구조**:
-```
-CrewX (공식 브랜드명)
-  └─ powered by CrewX technology
-
-또는
-
-crewx (기술 플랫폼)
-  └─ crewx (소비자 브랜드)
-```
-
-**CLI 명령어**:
-```bash
-crewx query "@agent task"        # 소비자용
-crewx-cli (내부/엔터프라이즈용)
-```
-
-**장점**:
-- ✅ 짧은 브랜드 + 설명적 기술명 모두 활용
-- ✅ 다양한 타겟 세그먼트
-- ✅ "code" 키워드 유지
-
-**단점**:
-- ❌ 혼란 가능성
-- ❌ 마케팅 메시지 복잡
-- ❌ 브랜드 인지도 분산
-
----
-
-### Option C: 현상 유지 (crewx + crewx 서브)
-
-**브랜드 구조**:
-```
-crewx (메인)
-  ├─ crewx CLI
-  └─ crewx (instant execution only)
-```
-
-**CLI 명령어**:
-```bash
-crewx query "@agent task"     # 로컬/프로젝트
-crewx @scope/crew "task"          # 즉시 실행
-```
-
-**장점**:
-- ✅ 원래 계획대로
-- ✅ npm/npx 구조 그대로 모방
-- ✅ 각 도구의 역할 명확
-
-**단점**:
-- ❌ crewx가 길다 (하루 수십 번 타이핑)
-- ❌ 두 브랜드 관리 필요
-- ❌ 사용자가 어느 걸 써야 할지 혼란
-
----
-
-## 📊 경쟁사 비교
-
-### 짧고 강력한 브랜드 (성공 사례)
-| 브랜드 | 원래 의미 | 타이핑 | 성공도 |
-|--------|-----------|--------|--------|
-| **npm** | Node Package Manager | 3자 | ⭐⭐⭐⭐⭐ |
-| **npx** | npm eXecute | 3자 | ⭐⭐⭐⭐⭐ |
-| **yarn** | Yet Another Resource Negotiator | 4자 | ⭐⭐⭐⭐ |
-| **pnpm** | Performant npm | 4자 | ⭐⭐⭐⭐ |
-| **htmx** | HyperText Markup eXtension | 4자 | ⭐⭐⭐⭐ |
-
-### 긴 설명적 브랜드
-| 브랜드 | 타이핑 | 문제점 |
-|--------|--------|--------|
-| **kubernetes** | 10자 | k8s로 축약 필요 |
-| **terraform** | 9자 | tf로 축약 |
-| **crewx** | 8자 | ? |
-
-**인사이트**: 개발자 도구는 짧을수록 좋다. 긴 브랜드는 결국 축약됨.
-
----
-
-## 💰 비즈니스 영향 분석
-
-### 타이핑 효율성 (개발자 경험)
-```bash
-# 하루 30회 사용 가정
-crewx: 8자 × 30회 = 240자/일
-crewx:    5자 × 30회 = 150자/일
-
-절감: 90자/일 (37% 감소)
-연간: 32,850자 절감
-```
-
-**개발자 만족도 예상 영향**: +15~20%
-
-### 브랜드 인지도 (마케팅)
-
-**crewx**:
-- ✅ 기억하기 쉬움 (짧고 독특)
-- ✅ 미디어 헤드라인 효과적 ("crewx raises $10M")
-- ✅ 소셜 미디어 해시태그 (#crewx)
-
-**crewx**:
-- ⚠️ "crewx"와 혼동 가능
-- ⚠️ 검색 시 "code" + "crew" 분리될 수 있음
-
-### SEO 영향
-
-**crewx**:
-- ❌ "code" 키워드 손실
-- ✅ "ai agents", "crew", "automation" 키워드로 보완
-- ✅ 독특한 브랜드명 = 검색 독점
-
-**crewx**:
-- ✅ "code" 키워드 유지
-- ❌ "code"는 너무 일반적
-
-**예상 SEO 영향**: 중립 또는 약간 긍정적 (독특한 브랜드명 이점)
-
----
-
-## 🎯 전략적 고려사항
-
-### 1. 타겟 시장
-
-**개발자 (Primary)**:
-- 짧은 CLI 선호 (npm, git, vim 등)
-- crewx 선호도: **높음** ⭐⭐⭐⭐⭐
-
-**엔터프라이즈 (Secondary)**:
-- 설명적 브랜드 선호 가능
-- crewx 선호도: **중간** ⭐⭐⭐
-
-**추천**: 개발자 우선 → **crewx**
-
-### 2. 경쟁 차별화
-
-**vs GitHub Copilot**:
-- Copilot = 긴 브랜드 (7자)
-- crewx = 짧고 강력 ✅
-
-**vs OpenAI GPT Store**:
-- GPT Store = 설명적
-- crewx = 독특하고 기억하기 쉬움 ✅
-
-**vs LangChain**:
-- LangChain = 9자
-- crewx = 압도적으로 짧음 ✅
-
-### 3. 투자자 관점
-
-**crewx 장점**:
-- 짧고 기억하기 쉬움 = 프레젠테이션 효과적
-- "X" = 미래지향적, 확장성 있는 이미지
-- SpaceX, Model X, Twitter→X 레퍼런스
-
-**crewx 장점**:
-- "code" = 시장 명확
-- 보수적 투자자에게 안정적
-
-**추천**: **crewx** (현대적 VC 선호)
-
----
-
-## ⏰ 타이밍 분석
-
-### 지금 전환하기 좋은 이유
-- ✅ **v0.1.0 단계** - 사용자 기반 최소
-- ✅ **crewx npm 선점 완료** - 인프라 준비됨
-- ✅ **공식 출시 전** - 리브랜딩 비용 최소
-- ✅ **투자 유치 전** - 브랜드 혼란 없음
-
-### 나중에 전환 시 리스크
-- ❌ 사용자 베이스 증가 후 전환 = 혼란
-- ❌ 문서/튜토리얼 모두 업데이트 필요
-- ❌ 커뮤니티 반발 가능성
-
-**결론**: **지금이 최적의 타이밍**
-
----
-
-## 🚨 리스크 및 완화 전략
-
-### Option A (완전 전환) 리스크
-
-| 리스크 | 확률 | 영향 | 완화 전략 |
-|--------|------|------|-----------|
-| 기존 사용자 혼란 | 낮음 | 낮음 | v0.1.0 단계라 사용자 최소 |
-| SEO 손실 | 중간 | 중간 | "AI agents" 키워드 강화 |
-| 브랜드 의미 모호 | 중간 | 낮음 | "X = eXecute" 스토리텔링 |
-| 리브랜딩 비용 | 낮음 | 낮음 | 아직 초기, 비용 최소 |
-
-### Option C (현상 유지) 리스크
-
-| 리스크 | 확률 | 영향 | 완화 전략 |
-|--------|------|------|-----------|
-| 사용자 혼란 (2개 CLI) | 높음 | 중간 | 명확한 문서화 |
-| 타이핑 불편 | 높음 | 중간 | Alias 제공 |
-| 브랜드 분산 | 중간 | 중간 | 통합 마케팅 |
-
----
-
-## 💡 전략 책임자 의견 요청
-
-다음 질문에 대한 의견을 부탁드립니다:
-
-### 1. 브랜딩 방향
-- [ ] **Option A**: crewx로 완전 전환 (메인 브랜드)
-- [ ] **Option B**: 듀얼 브랜딩 (CrewX by CrewX)
-- [ ] **Option C**: 현상 유지 (crewx + crewx 서브)
-- [ ] **Option D**: 기타 (의견:_____________)
-
-### 2. 주요 고려사항
-**가장 중요하게 생각하는 요소는?** (우선순위 순서)
-- [ ] 개발자 경험 (타이핑 효율)
-- [ ] SEO 및 마케팅
-- [ ] 투자자 관점
-- [ ] 브랜드 단순성
-- [ ] 기타:_____________
-
-### 3. 타이밍
-- [ ] 지금 바로 전환 (v0.1.x 단계)
-- [ ] v0.2.0 출시 시 전환
-- [ ] v1.0.0 출시 시 전환
-- [ ] 전환하지 않음
-
-### 4. 추가 분석 필요 사항
-- [ ] 경쟁사 추가 분석
-- [ ] 사용자 설문조사
-- [ ] SEO 전문가 의견
-- [ ] 법률 검토 (상표권)
-- [ ] 기타:_____________
-
----
-
-## 📝 Dev Lead 추천
-
-**추천**: **Option A - crewx 완전 전환**
-
-**이유**:
-1. **개발자 경험 우선** - 하루 수십 번 타이핑, 짧을수록 좋음
-2. **브랜드 단순화** - 하나의 강력한 브랜드
-3. **최적의 타이밍** - v0.1.0 단계, 전환 비용 최소
-4. **NPM 선점 완료** - 인프라 준비됨
-5. **경쟁 우위** - Copilot(7자), LangChain(9자)보다 짧음
-
-**실행 플랜** (승인 시):
-```
-Phase 1 (Week 1):
-  - crewx → crewx 리네임
-  - package.json, 문서 업데이트
-
-Phase 2 (Week 2):
-  - crewx.dev 도메인 설정
-  - crewx.dev → crewx.dev 리다이렉트
-
-Phase 3 (Week 3):
-  - 마케팅 자료 업데이트
-  - 공식 발표
-```
-
----
-
-## 🤔 의사결정 프레임워크
-
-### Devil's Advocate Questions
-
-1. **"X"가 모호하지 않은가?**
-   - 반박: npm, yarn도 원래 의미 무시되고 브랜드화됨
-   - "X"의 다의성 = 오히려 스토리텔링 자유도 ↑
-
-2. **"code" 키워드를 포기해도 되는가?**
-   - 반박: "AI agents" 키워드로 충분히 대체
-   - 독특한 브랜드명 = 검색 독점 가능
-
-3. **개발자들이 crewx를 어떻게 발음할까?**
-   - "crew-ex" 또는 "crews"
-   - 짧아서 발음도 쉬움
-
-4. **나중에 후회하지 않을까?**
-   - 지금 전환 = 비용 최소
-   - 나중 전환 = 비용 10배
-
-### Reverse Scenario (반대로 생각)
-
-**만약 처음부터 crewx였다면?**
-- crewx → crewx로 바꾸자고 제안했을까?
-- 아마도 아님 (더 길고 복잡해짐)
-
-**결론**: crewx가 더 자연스러움
-
----
-
-## 📅 다음 단계
-
-전략 책임자 검토 후:
-
-1. **승인 시**:
-   - Dev Lead가 실행 플랜 착수
-   - 주간 진행 상황 보고
-
-2. **보류 시**:
-   - 추가 분석 수행
-   - 다음 회의 일정 조율
-
-3. **거부 시**:
-   - 현상 유지 (Option C)
-   - crewx = 서브 제품으로 개발 진행
-
----
-
-**검토 요청**: 이 문서를 전략 책임자에게 전달하여 의견을 구합니다.
-
-**긴급도**: 중간 (v0.2.0 출시 전 결정 필요)
-
-**예상 소요 시간**: 의사결정 1일, 실행 2-3주

package/docs/claude-code-docker-guide.md

@@ -1,264 +0,0 @@
-# Claude Code Docker 실행 가이드
-
-## 개요
-Claude Code를 Docker 컨테이너에서 실행하여 격리된 개발 환경을 구축하는 방법
-
-## 커뮤니티 프로젝트
-이미 여러 개발자들이 Docker 통합을 시도했습니다:
-
-| 프로젝트 | 특징 | GitHub |
-|---------|------|--------|
-| claude-docker | 풀 권한 + Twilio 알림 | VishalJ99/claude-docker |
-| claude-code-container | --dangerously-skip-permissions 모드 | tintinweb/claude-code-container |
-| claude-code-sandbox | 안전한 로컬 실행 | textcortex/claude-code-sandbox |
-| claudebox | macOS Keychain 통합 | koogle/claudebox |
-| claude-container | 호스트 격리 + 영속 인증 | nezhar/claude-container |
-| claude-code-yolo | 컨테이너 격리 권한 관리 | thevibeworks/claude-code-yolo |
-
-## 인증 구조
-
-### ⚠️ 중요: Claude 실행 방식별 차이
-
-**VSCode Extension** (현재 사용 중):
-- 경로: `~/.vscode/extensions/anthropic.claude-code-*/`
-- 설정: `~/.claude.json` (계정 정보, MCP 서버 설정)
-- 작업: `~/.claude/` (projects, todos, debug)
-- 인증: VSCode 내부 관리 (토큰 파일 없음)
-
-**Claude Desktop App**:
-- 독립 GUI 애플리케이션
-- 설정: `~/.claude.json`
-- 인증: 앱 내부 관리
-
-**Claude Code CLI** (커뮤니티 보고 기준):
-- 인증: `~/.claude/.credentials.json` (OAuth 토큰)
-- 구조:
-```json
-{
-  "accessToken": "sk-ant-oat01-...",   // 단기 액세스 토큰
-  "refreshToken": "sk-ant-ort01-...",  // 리프레시 토큰
-  "expiresAt": 1234567890,            // 만료 시간
-  "scopes": ["user:inference", "user:profile"]
-}
-```
-
-### 실제 디렉토리 구조 (Claude Desktop)
-```
-~/
-├── .claude.json           # Claude Desktop 설정
-└── .claude/
-    ├── projects/          # 프로젝트 히스토리
-    ├── todos/            # 작업 관리
-    ├── shell-snapshots/  # 쉘 스냅샷
-    ├── debug/            # 디버그 로그
-    ├── ide/              # IDE 통합 설정
-    └── statsig/          # 분석 및 기능 플래그
-```
-
-**참고**: Claude Desktop은 `.credentials.json` 파일을 사용하지 않을 수 있음
-
-## Docker 설정
-
-### 1. Dockerfile
-```dockerfile
-FROM node:20-slim
-
-# 시스템 패키지 설치
-RUN apt-get update && apt-get install -y \
-    git \
-    curl \
-    && rm -rf /var/lib/apt/lists/*
-
-# Claude Code CLI 설치
-RUN npm install -g @anthropic-ai/claude-code
-
-# 비-root 사용자 생성
-RUN useradd -m -s /bin/bash claude
-USER claude
-WORKDIR /home/claude
-
-# 기본 명령
-CMD ["claude"]
-```
-
-### 2. Docker Compose
-```yaml
-version: '3.8'
-
-services:
-  claude-code:
-    build: .
-    image: claude-code:latest
-    container_name: claude-code-dev
-
-    volumes:
-      # 인증 디렉토리 (필수)
-      - ~/.claude:/home/claude/.claude
-
-      # 프로젝트 디렉토리
-      - ./:/workspace
-
-      # Git 설정 (읽기 전용)
-      - ~/.gitconfig:/home/claude/.gitconfig:ro
-      - ~/.ssh:/home/claude/.ssh:ro
-
-      # MCP 서버 설정 (있는 경우)
-      - ~/.config/claude-desktop:/home/claude/.config/claude-desktop:ro
-
-    environment:
-      # 추가 환경 변수 (선택)
-      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
-      - NODE_ENV=development
-
-    working_dir: /workspace
-    stdin_open: true
-    tty: true
-
-    # 네트워크 설정 (MCP 서버 연결용)
-    network_mode: host
-```
-
-## 실행 방법
-
-### 사전 준비
-```bash
-# 1. Claude CLI 설치 확인
-which claude
-claude --version
-
-# 2. 호스트에서 먼저 인증
-claude login
-# 브라우저가 열리고 로그인 완료 후 인증 저장
-
-# 3. 인증 파일 위치 확인 (CLI 버전에 따라 다를 수 있음)
-# 가능한 위치들:
-# - ~/.claude/.credentials.json
-# - ~/.config/claude-code/credentials.json
-# - 환경변수 CLAUDE_CODE_OAUTH_TOKEN
-```
-
-### Docker 실행
-```bash
-# 이미지 빌드
-docker build -t claude-code .
-
-# 단독 실행
-docker run -it \
-  -v ~/.claude:/home/claude/.claude \
-  -v $(pwd):/workspace \
-  --name claude-code \
-  claude-code
-
-# Docker Compose 사용
-docker-compose up -d
-docker-compose exec claude-code claude
-```
-
-### 백그라운드 실행
-```bash
-# 데몬 모드 시작
-docker-compose up -d
-
-# 접속
-docker exec -it claude-code-dev claude
-
-# 종료
-docker-compose down
-```
-
-## 보안 고려사항
-
-### DO ✅
-- 호스트에서 인증 후 볼륨 마운트
-- 민감한 파일은 읽기 전용(`:ro`) 마운트
-- 비-root 사용자(claude)로 실행
-- `.aiexclude` 파일로 민감한 파일 보호
-- 신뢰할 수 있는 프로젝트에서만 사용
-
-### DON'T ❌
-- 도커 이미지에 credentials 포함
-- root 권한으로 실행
-- `--dangerously-skip-permissions` 무분별 사용
-- 공개 레지스트리에 인증 정보 포함된 이미지 푸시
-
-## 문제 해결
-
-### 인증 유지 문제
-컨테이너 재시작 시 인증이 유지되지 않는 경우:
-```bash
-# 볼륨 마운트 확인
-docker inspect claude-code-dev | grep Mounts -A 20
-
-# 권한 확인
-docker exec claude-code-dev ls -la /home/claude/.claude/
-```
-
-### 토큰 만료
-```bash
-# 호스트에서 재인증
-claude logout
-claude login
-
-# 컨테이너 재시작
-docker-compose restart
-```
-
-### MCP 서버 연결
-MCP 서버(crewx 등) 연결이 필요한 경우:
-```yaml
-# docker-compose.yml에 추가
-network_mode: host  # 또는 bridge with port mapping
-```
-
-## 활용 사례
-
-### 1. 프로젝트별 격리
-```bash
-# 프로젝트 A
-cd ~/projects/project-a
-docker-compose up -d
-
-# 프로젝트 B (다른 터미널)
-cd ~/projects/project-b
-docker-compose up -d
-```
-
-### 2. CI/CD 통합
-```yaml
-# .gitlab-ci.yml 예시
-claude-review:
-  image: claude-code:latest
-  script:
-    - claude review --project /workspace
-  volumes:
-    - ~/.claude:/home/claude/.claude:ro
-```
-
-### 3. 팀 환경 공유
-```bash
-# 팀 공통 이미지
-docker build -t company/claude-code:v1 .
-docker push company/claude-code:v1
-
-# 팀원 사용
-docker pull company/claude-code:v1
-docker run -it -v ~/.claude:/home/claude/.claude company/claude-code:v1
-```
-
-## 장점
-- **환경 격리**: 프로젝트별 독립된 환경
-- **버전 관리**: 특정 Claude Code 버전 고정
-- **팀 협업**: 동일한 개발 환경 공유
-- **자동화**: CI/CD 파이프라인 통합
-- **보안**: 호스트 시스템 보호
-
-## 한계
-- 토큰 만료 시 재인증 필요
-- GUI 애플리케이션 실행 제한
-- 일부 네이티브 기능 제한 가능
-- 컨테이너 오버헤드
-
-## 참고 자료
-- [Anthropic Claude Code 공식 문서](https://docs.claude.com/en/docs/claude-code)
-- [Docker MCP 통합 가이드](https://www.docker.com/blog/the-model-context-protocol)
-- [Claude Code GitHub Issues](https://github.com/anthropics/claude-code/issues)