/init — Initialize Worktree Configuration

Create .dev/config.yml with project-specific worktree settings by scanning the project and letting the user choose which files to copy to new worktrees.

Step 1: Check Existing Config

Check if .dev/config.yml already exists.

If it exists:

code

AskUserQuestion(
  question: ".dev/config.yml이 이미 존재합니다. 어떻게 할까요?",
  header: "Config 존재",
  options: [
    { label: "Merge", description: "기존 설정에 새로 발견된 파일 추가" },
    { label: "Overwrite", description: "기존 설정을 새로 덮어쓰기" },
    { label: "Skip", description: "아무것도 하지 않고 종료" }
  ]
)

•Skip → 결과 출력 후 종료
•Merge → 기존 copy_files를 읽어서 중복 제거 후 새 파일만 추가 후보로 표시
•Overwrite → 기존 무시하고 새로 생성

If it doesn't exist: → Step 2로 진행

Step 2: Scan Project

Glob으로 아래 패턴을 탐지. 실제 존재하는 파일만 후보 목록에 포함.

Scan Patterns

공통 (모든 프로젝트):

Category	Glob Pattern	Description
Environment	`.env`	Base environment variables
Environment	`.env.*`	Environment variants (local, development, test, staging)
Editor	`.vscode/settings.json`	VS Code settings
Editor	`.idea/workspace.xml`	IntelliJ/WebStorm workspace
Editor	`.editorconfig`	Editor standards
Docker	`docker-compose.override.yml`	Local docker overrides

Node.js:

Category	Glob Pattern	Description
Package	`.npmrc`	NPM registry config
Package	`.yarnrc.yml`	Yarn config
Formatting	`.prettierrc*`	Prettier config
Linting	`.eslintrc*`	ESLint config

Python:

Category	Glob Pattern	Description
Config	`.python-version`	pyenv version
Config	`pyrightconfig.json`	Pyright config
Config	`.flake8`	Flake8 config
Config	`mypy.ini`	Mypy config

Ruby:

Category	Glob Pattern	Description
Config	`.ruby-version`	Ruby version
Config	`.rubocop.yml`	Rubocop config

Go/Rust/Other:

Category	Glob Pattern	Description
Config	`.golangci.yml`	Go linter config
Config	`rustfmt.toml`	Rust formatter config
Config	`.tool-versions`	asdf version manager

Scan execution:

code

# Run Glob for each pattern, collect existing files
found_files = []
for each pattern in scan_patterns:
    results = Glob(pattern)
    found_files.append(results)

If no files found: 출력 "스캔 결과 복사할 파일이 없습니다. 기본 config만 생성합니다." → Step 4로 (빈 copy_files)

If merge mode: 기존 copy_files에 이미 있는 파일은 후보에서 제외

Step 3: Interactive File Selection

발견된 파일을 AskUserQuestion multiSelect로 표시.

code

AskUserQuestion(
  question: "새 worktree에 복사할 파일을 선택하세요.",
  header: "Copy files",
  options: [
    { label: ".env.local", description: "로컬 환경 변수" },
    { label: ".vscode/settings.json", description: "에디터 설정" },
    ...found files with descriptions
  ],
  multiSelect: true
)

If user selects nothing: 빈 copy_files로 진행 (기본값)

Step 3.5: Configure post_command

worktree 이동 후 실행할 명령어를 설정.

Dependency Manager Detection

프로젝트의 의존성 관리자를 자동 감지 (lock file 기반):

Lock File	Manager	Install Command
`pnpm-lock.yaml`	pnpm	`pnpm install`
`yarn.lock`	yarn	`yarn install`
`bun.lockb`	bun	`bun install`
`package-lock.json`	npm	`npm install`
`poetry.lock`	poetry	`poetry install`
`Pipfile.lock`	pipenv	`pipenv install`
`uv.lock`	uv	`uv sync`
`Gemfile.lock`	bundler	`bundle install`
`go.sum`	go	`go mod download`
`Cargo.lock`	cargo	`cargo fetch`
`composer.lock`	composer	`composer install`

감지 우선순위: 첫 번째 발견된 lock file 사용

AskUserQuestion

code

AskUserQuestion(
  question: "worktree 이동 시 실행할 명령어를 선택하세요.",
  header: "Post command",
  options: [
    { label: "claude (Recommended)", description: "Claude만 실행 (의존성 수동 설치)" },
    { label: "{install_cmd} && claude", description: "의존성 설치 후 Claude 실행" },
    { label: "Custom", description: "직접 입력" }
  ]
)

•{install_cmd}: 감지된 의존성 설치 명령어 (예: pnpm install, poetry install)
•의존성 관리자가 없으면 두 번째 옵션 제외

If Custom selected: 사용자 입력값 사용

Step 4: Validate

생성할 config를 검증:

•copy_files: 모든 경로가 상대경로 (leading / 없음, .. 없음)
•base_dir: {name} 변수 포함 확인
•post_command: 비어있지 않은 문자열
•YAML 구조: worktree.copy_files (array), worktree.base_dir (string), worktree.post_command (string)

검증 실패 시 사용자에게 알리고 재선택 유도.

Step 5: Write Config

bash

mkdir -p .dev

.dev/config.yml 생성:

yaml

worktree:
  copy_files:
    - {selected_file_1}
    - {selected_file_2}
  base_dir: ".worktrees/{name}"
  post_command: "{selected_post_command}"

Merge mode: 기존 copy_files + 새로 선택한 파일 (중복 제거) 합쳐서 작성. 기존 base_dir, post_command 유지 (사용자가 변경 원하면 Overwrite 선택).

Step 6: Update .gitignore

워크트리 관련 ephemeral 파일들을 .gitignore에 추가.

bash

# Entries to add
gitignore_entries=(
  ".worktrees/"
  ".dev/local.json"
  ".dev/state.local.json"
)

# Check and append if missing
for entry in "${gitignore_entries[@]}"; do
  grep -qxF "$entry" .gitignore 2>/dev/null || echo "$entry" >> .gitignore
done

Entry	용도
`.worktrees/`	워크트리 디렉토리들
`.dev/local.json`	워크트리 identity (name, branch, plan)
`.dev/state.local.json`	세션 추적, 파이프라인 상태

•.gitignore 파일이 없으면 생성
•이미 있는 항목은 skip (idempotent)

Step 6.5: Install hy CLI

hy CLI가 설치되어 있지 않으면 설치 제안.

bash

# Check if hy is available
if ! command -v hy &> /dev/null; then
  # hy not installed
fi

If hy not installed:

code

AskUserQuestion(
  question: "hy CLI를 설치하시겠습니까? 터미널에서 직접 worktree 관리가 가능합니다.",
  header: "hy CLI",
  options: [
    { label: "Install", description: "~/.local/bin/hy에 설치" },
    { label: "Skip", description: "나중에 수동으로 설치" }
  ]
)

If Install:

bash

# Get plugin root (where this skill is located)
PLUGIN_ROOT="${baseDir}/../.."

# Run install script
bash "$PLUGIN_ROOT/scripts/install-hy.sh"

If Skip: 설치 방법만 안내하고 진행

code

hy CLI를 나중에 설치하려면:
  ~/.claude/plugins/.../hoyeon/scripts/install-hy.sh

Step 7: Summary

생성 결과 출력:

code

Config created: .dev/config.yml

  copy_files ({N}):
    - .env.local
    - .vscode/settings.json

  base_dir: .worktrees/{name}
  post_command: {selected_post_command}

  .gitignore:
    - .worktrees/
    - .dev/local.json
    - .dev/state.local.json

  hy CLI: {installed | not installed}

To edit: open .dev/config.yml
To use: /worktree create <name>
Terminal: hy status

References

•Config schema: skills/worktree/references/config-schema.md
•Worktree skill: skills/worktree/SKILL.md