@elyun/bylane 1.28.0 → 1.30.0

package/commands/bylane-code-agent.md

@@ -30,9 +30,27 @@ npx @elyun/bylane state write code-agent '{"status":"in_progress","startedAt":"'
 | `spec.figmaSpec` | Figma 컬러토큰·컴포넌트 구조 |
 | `issueType` | `new-feature` / `bug` / `improvement` / `chore` |
 | `issueNumber` | GitHub 이슈 번호 |
+| `branchName` | issue-agent가 생성한 브랜치명 |
+| `worktreePath` | 워크트리 경로 (없으면 `null`) |
 
 없으면 GitHub 이슈 본문을 직접 로드하여 파싱한다.
 
+### 브랜치/워크트리 확인
+
+issue-agent가 이미 브랜치를 생성했는지 확인한다:
+
+1. `branchName`이 있으면 → 해당 브랜치로 checkout
+2. `worktreePath`가 있으면 → 해당 워크트리 디렉토리에서 작업
+3. 둘 다 없으면 (`issue.autoCreateBranch: false`) → code-agent가 직접 브랜치 생성
+
+```bash
+# branchName이 있는 경우
+git checkout "$BRANCH_NAME"
+
+# worktreePath가 있는 경우 — 해당 디렉토리에서 모든 작업 수행
+cd "$WORKTREE_PATH"
+```
+
 issueMemory 로드:
 ```bash
 npx @elyun/bylane memory read ISSUE_NUMBER

package/commands/bylane-issue-agent.md

@@ -211,6 +211,49 @@ curl -s -X POST \
 
 ---
 
+### Phase 5 — 브랜치/워크트리 생성 (설정에 따라)
+
+이슈 생성 직후, `issue.autoCreateBranch`가 `true`이면 브랜치를 자동 생성한다.
+브랜치명은 `branch.pattern` 설정에 따라 결정된다.
+
+```bash
+# 브랜치명 생성 (src/branch.js 활용)
+BRANCH_NAME=$(node -e "
+import('./src/branch.js').then(({buildBranchNameFromConfig}) => {
+  import('./src/config.js').then(({loadConfig}) => {
+    const config = loadConfig()
+    const name = buildBranchNameFromConfig(config, {
+      issueNumber: ISSUE_NUMBER,
+      type: 'ISSUE_TYPE',
+      title: 'ISSUE_TITLE'
+    })
+    process.stdout.write(name)
+  })
+})
+")
+
+git checkout -b "$BRANCH_NAME"
+```
+
+#### 워크트리 생성 (`issue.autoCreateWorktree: true`인 경우)
+
+브랜치 대신 워크트리를 생성하여 독립된 작업 디렉토리를 만든다:
+
+```bash
+WORKTREE_DIR=".bylane/worktrees/$BRANCH_NAME"
+git worktree add "$WORKTREE_DIR" -b "$BRANCH_NAME"
+```
+
+이후 모든 에이전트(code-agent, test-agent, commit-agent 등)는 이 워크트리 경로에서 작업한다.
+state에 `branchName`과 `worktreePath`를 기록하여 후속 에이전트가 참조할 수 있게 한다.
+
+#### 설정이 꺼져 있는 경우
+
+`issue.autoCreateBranch: false`이면 이 단계를 건너뛴다.
+code-agent가 실행 시점에 브랜치를 직접 생성한다.
+
+---
+
 ## 출력
 
 `.bylane/state/issue-agent.json`:
@@ -230,7 +273,9 @@ curl -s -X POST \
     "affectedFiles": ["src/hooks/useTheme.ts", "src/components/Header/"],
     "checklist": ["ThemeToggle 컴포넌트 생성", "useTheme hook 수정", "테스트 작성"],
     "figmaSpec": { "enabled": false, "components": [], "colorTokens": {} }
-  }
+  },
+  "branchName": "issues-123-dark-mode-toggle",
+  "worktreePath": null
 }
 ```
 

package/commands/bylane-setup.md

@@ -83,7 +83,25 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
 
 `permissions.scope`에 저장.
 
-## Step 5/9 — 리뷰 자동 Approve
+## Step 5/10 — 이슈 생성 시 브랜치/워크트리
+
+> 이슈 생성 후 자동으로 브랜치를 만들까요? (y/n, 기본: y)
+
+- `y` (기본) → `issue.autoCreateBranch = true` — 이슈 생성 직후 브랜치 네이밍 패턴에 따라 브랜치 자동 생성
+- `n` → `issue.autoCreateBranch = false` — code-agent 실행 시 수동 생성
+
+`y` 선택 시 추가 질문:
+
+> 브랜치와 함께 git worktree도 생성할까요? (y/n, 기본: n)
+> worktree를 사용하면 이슈별로 독립된 작업 디렉토리가 생성됩니다.
+> 여러 이슈를 동시에 작업할 때 유용합니다.
+
+- `y` → `issue.autoCreateWorktree = true` — `.bylane/worktrees/{branch-name}/`에 워크트리 생성
+- `n` (기본) → `issue.autoCreateWorktree = false` — 브랜치만 생성하고 checkout
+
+모든 후속 에이전트(code-agent, test-agent, commit-agent 등)는 이슈 번호 기준으로 해당 브랜치/워크트리에서 작업한다.
+
+## Step 6/10 — 리뷰 자동 Approve
 
 > AI 리뷰에서 지적사항이 없을 때 자동으로 Approve할까요? (y/n, 기본: n)
 
@@ -92,7 +110,7 @@ Linear API Key는 환경변수명(`LINEAR_API_KEY`)으로 저장. 실제 키값
 
 대부분의 팀에서는 사람이 최종 Approve하는 것을 권장한다.
 
-## Step 6/9 — Loop 실행 모드
+## Step 7/10 — Loop 실행 모드
 
 > Loop 실행 모드를 선택하세요:
 > 1. tmux  — tmux 세션에서 백그라운드 실행 (터미널 종료 후에도 유지, 권장)
@@ -117,7 +135,7 @@ bylane loop stop    # loop 종료
 bylane loop status  # 상태 확인
 ```
 
-## Step 7/9 — 고급 설정
+## Step 8/10 — 고급 설정
 
 > 고급 설정을 변경하시겠습니까? (Enter = 기본값 사용)
 
@@ -126,7 +144,7 @@ bylane loop status  # 상태 확인
 - `loopTimeoutMinutes` (기본: 30): 루프 타임아웃 (분)
 - Figma MCP 활성화? (y/n, 기본: n)
 
-## Step 8/9 — 브랜치 네이밍
+## Step 9/10 — 브랜치 네이밍
 
 > 브랜치 네이밍 패턴을 선택하세요:
 > 1. {tracker}-{issue-number}              예) issues-32
@@ -141,7 +159,7 @@ bylane loop status  # 상태 확인
 직접 입력 시 사용 가능한 토큰 목록 안내:
 `{tracker}`, `{type}`, `{issue-number}`, `{custom-id}`, `{title-slug}`, `{date}`, `{username}`
 
-## Step 9/9 — 에이전트 모델 설정
+## Step 10/10 — 에이전트 모델 설정
 
 > 각 에이전트에 사용할 AI 모델을 설정하시겠습니까? (Enter = 기본값 사용)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyun/bylane",
-  "version": "1.28.0",
+  "version": "1.30.0",
   "description": "Frontend development harness for Claude Code",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { mkdirSync, symlinkSync, existsSync, readdirSync, copyFileSync, renameSync, readFileSync, writeFileSync } from 'fs'
+import { mkdirSync, symlinkSync, existsSync, readdirSync, copyFileSync, renameSync, readFileSync, writeFileSync, rmSync } from 'fs'
 import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'
 import { homedir } from 'os'
@@ -33,10 +33,8 @@ function backupAndCopy(src, dest, file, label) {
       console.log(`  = ${label}: ${file} (변경 없음, 건너뜀)`)
       return
     }
-    const backupPath = `${destFile}.bak`
-    renameSync(destFile, backupPath)
     copyFileSync(srcFile, destFile)
-    console.log(`  ~ ${label}: ${file} (업데이트됨, 기존 파일 -> ${file}.bak)`)
+    console.log(`  ~ ${label}: ${file} (업데이트됨)`)
   } else {
     copyFileSync(srcFile, destFile)
     console.log(`  + ${label}: ${file}`)
@@ -139,8 +137,48 @@ function install() {
   }
 }
 
+function uninstall() {
+  console.log('\n  byLane 제거 중...\n')
+
+  for (const { src, dest, label } of TARGETS) {
+    if (!existsSync(dest)) continue
+    const files = readdirSync(src)
+    for (const file of files) {
+      const destFile = join(dest, file)
+      if (existsSync(destFile)) {
+        rmSync(destFile)
+        console.log(`  - ${label}: ${file}`)
+      }
+    }
+  }
+
+  // settings.json에서 bylane 훅 제거
+  const settingsPath = join(CLAUDE_DIR, 'settings.json')
+  if (existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(readFileSync(settingsPath, 'utf8'))
+      const stripBylane = (arr) =>
+        (arr ?? []).filter(h => !h.hooks?.some(hh => hh.command?.includes('bylane-agent-tracker')))
+      settings.hooks = settings.hooks ?? {}
+      settings.hooks.PreToolUse = stripBylane(settings.hooks.PreToolUse)
+      settings.hooks.PostToolUse = stripBylane(settings.hooks.PostToolUse)
+      writeFileSync(settingsPath, JSON.stringify(settings, null, 2))
+      console.log('  - Hook: bylane-agent-tracker 제거')
+    } catch {}
+  }
+
+  console.log(`
+  byLane 제거 완료.
+
+  사용자 설정(.bylane/bylane.json)은 유지됩니다.
+  Claude Code를 재시작하면 변경사항이 적용됩니다.
+`)
+}
+
 if (command === 'install') {
   install()
+} else if (command === 'uninstall') {
+  uninstall()
 } else if (command === 'preflight') {
   const { runPreflight, formatPreflight } = await import('./preflight.js')
   const result = runPreflight()
@@ -320,6 +358,6 @@ if (command === 'install') {
   child.on('exit', code => process.exit(code ?? 0))
 } else {
   console.error(`알 수 없는 명령: ${command}`)
-  console.error('사용법: npx @elyun/bylane [install|loop|monitor|preflight|state|memory|cleanup] [--symlink]')
+  console.error('사용법: npx @elyun/bylane [install|uninstall|loop|monitor|preflight|state|memory|cleanup] [--symlink]')
   process.exit(1)
 }

package/src/config.js

@@ -40,6 +40,10 @@ export const DEFAULT_CONFIG = {
     owner: '',
     repo: ''
   },
+  issue: {
+    autoCreateBranch: true,
+    autoCreateWorktree: false
+  },
   memory: {
     enabled: true,
     dir: '.bylane/memory'