workzone

Claude Code용 멀티 프로젝트 워크스페이스 관리 도구

여러 독립 프로젝트를 하나의 폴더에서 관리할 때 사용합니다. 모노레포가 아닌, 각각 독립적인 Git 저장소를 가진 프로젝트들을 한 곳에서 관리하고 싶을 때 유용합니다.

왜 workzone인가?

• 모노레포는 과하다: 프로젝트들이 코드를 공유하지 않음
• 폴더만 모아두면 관리가 안 됨: 어떤 프로젝트가 있는지, 새 폴더가 뭔지 파악 어려움
• Claude Code와 함께 사용: Hook으로 세션 시작 시 자동 검사

빠른 시작

# 새 워크스페이스 생성
mkdir my-workspace && cd my-workspace

# workzone 초기화
npx workzone init

# 생성되는 파일:
# ├── CLAUDE.md              # 워크스페이스 설명
# ├── workspace-projects.md  # 프로젝트 목록
# ├── workzone-rules.md      # 규칙 문서
# ├── .gitignore             # Git 설정
# └── .claude/
#     └── settings.local.json  # Claude Code Hook 설정

사용법

프로젝트 추가

# 프로젝트 클론
git clone <url> my-api/

# workspace-projects.md에 등록
### my-api/
- **설명**: 백엔드 API 서버
- **기술**: Node.js, Express
- **Git**: 독립 저장소

# .gitignore에 추가
my-api/

검사 실행

# 정의되지 않은 폴더 스캔
workzone scan

# 전체 검사
workzone all

Claude Code Hook

workzone init 실행 시 자동으로 Hook이 설정됩니다:

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "npx workzone scan"
      }]
    }]
  }
}

Claude Code 세션 시작 시 자동으로 workzone scan이 실행되어:

• 정의되지 않은 폴더 발견 시 알림
• Claude가 규칙을 인식하고 따름

명령어

| 명령어 | 설명 | |--------|------| | workzone init | 워크스페이스 초기화 (스캐폴딩) | | workzone scan | 정의되지 않은 폴더 스캔 | | workzone all | 전체 검사 실행 | | workzone rules | 사용 가능한 규칙 목록 | | workzone help | 도움말 |

규칙

scan-workspace (필수)

• workspace-projects.md에 정의되지 않은 폴더 감지
• 세션 시작 시 자동 실행

validate-import (선택)

• 프로젝트 간 코드 import 금지 검사
• 프로젝트 간 통신은 HTTP API만 허용

워크스페이스 구조

my-workspace/           # 루트 (workzone 관리)
├── CLAUDE.md
├── workspace-projects.md
├── workzone-rules.md
├── .gitignore
├── .claude/
│
├── project-a/          # 독립 Git 저장소
│   └── .git/
├── project-b/          # 독립 Git 저장소
│   └── .git/
└── project-c/          # 독립 Git 저장소
    └── .git/

요구 사항

• Node.js >= 18.0.0
• Claude Code (Hook 기능 사용 시)

라이선스

MIT