| name | worktree |
| description | 실험용 git worktree 생성/관리. Use when the user says "worktree", "실험 환경", "브랜치 분리", or needs an isolated experiment environment.
|
Worktree Skill
Skill Type: worktree
Version: 1.1.0
Purpose: 독립 실험 환경을 위한 git worktree 생성/관리
WHY
아키텍처 변경, A/B 설계 비교, ST별 독립 실험 등 메인 브랜치를 오염시키지 않아야 하는 검증 작업이 빈번하다. git worktree로 독립 작업 디렉토리를 생성하여, 실험 결과가 메인에 반영되지 않는 격리된 환경을 체계적으로 관리한다.
사용 시점
- 아키텍처 변경 파일럿 (CLAUDE.md 구조, index.yml 실험 등)
- A/B 설계 비교 (두 접근법 병렬 테스트)
- ST별 독립 실험 환경 — 검증 후 채택/기각
- 메인 브랜치를 오염시키지 않아야 하는 검증
컨벤션
| 항목 | 규칙 |
|---|
| 위치 | ../vatty-[slug]-wt (sibling 디렉토리) |
| 브랜치명 | experiment/[slug] |
| 수명 | 실험 완료 후 즉시 제거 (채택 또는 기각) |
| slug 형식 | [initiative]-[topic] kebab-case |
STEPS
/worktree:create [slug]
git worktree add ../vatty-[slug]-wt -b experiment/[slug]
생성 후:
- 실험 변경은
../vatty-[slug]-wt/ 디렉토리에서 진행
- 현재 디렉토리(main)는 영향 없이 계속 사용
git worktree list로 활성 worktree 목록 확인
/worktree:clean [slug]
채택 (main에 병합)
git merge experiment/[slug]
git worktree remove ../vatty-[slug]-wt
git branch -d experiment/[slug]
기각 (결과 버리고 제거)
git worktree remove ../vatty-[slug]-wt
git branch -D experiment/[slug]
주의사항
- 브랜치 독립성: worktree 변경은
experiment/[slug] 브랜치에만 존재. main에 반영하려면 명시적 merge/cherry-pick 필요
- 실험 범위 사전 정의: worktree 생성 전에 "어떤 파일을 실험할 것인가"를 명확히 함
- 동시 활성 worktree 2개 이하: context 분산 방지
- 정기 정리:
git worktree list로 완료된 worktree 확인 후 제거
JUDGMENT
| 조건 | 분기 |
|---|
| 실험 완료 + 결과 채택 | merge/cherry-pick 후 worktree 제거 |
| 실험 완료 + 결과 기각 | worktree + branch 즉시 제거 |
| 동시 활성 worktree 2개 이상 | context 분산 경고, 기존 worktree 정리 제안 |
git worktree list에 완료된 worktree 존재 | 정리 권고 |
AGENT DELEGATION
None -- main context execution. git worktree 명령은 오케스트레이터가 Bash로 직접 수행한다.
KNOWLEDGE REFS
- Initiative 실험 환경: ST 정의에
worktree: experiment/[slug] 명시 권장
- 비교 결과 기록:
research/internal/에 기록 후 worktree 제거
참조
- Initiative 실험 환경으로 사용 시: ST 정의에
worktree: experiment/[slug] 명시 권장
- 비교 결과는 research/internal/에 기록 후 worktree 제거
