worktree

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]

# worktree 생성
git worktree add ../vatty-[slug]-wt -b experiment/[slug]

생성 후:

• 실험 변경은 ../vatty-[slug]-wt/ 디렉토리에서 진행
• 현재 디렉토리(main)는 영향 없이 계속 사용
• git worktree list로 활성 worktree 목록 확인

---

/worktree:clean [slug]

채택 (main에 병합)

# worktree에서 커밋 완료 후
git merge experiment/[slug]   # 또는 cherry-pick
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 제거