claude-plugin-viban 1.2.1 → 1.2.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "viban",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
   "author": {
     "name": "happy-nut"

package/bin/viban

@@ -1047,8 +1047,7 @@ delete_issue() {
     local repo_root=$(git rev-parse --show-toplevel 2>/dev/null)
     local wt_dir="$VIBAN_DATA_DIR/worktrees/$id"
 
-    # Determine branch name: prefer issue-{num} when external_id present
-    local branch="viban-$id"
+    local branch="issue-$id"
     local _ext_id=$(get_ext_id "$id")
     if [[ -n "$_ext_id" && "$_ext_id" != "null" ]]; then
         local _issue_num="${_ext_id##*:}"
@@ -1519,8 +1518,7 @@ cmd_done() {
     local repo_root=$(git rev-parse --show-toplevel 2>/dev/null)
     local wt_dir="$VIBAN_DATA_DIR/worktrees/$1"
 
-    # Determine branch name: prefer issue-{num} when external_id present
-    local branch="viban-$1"
+    local branch="issue-$1"
     local _ext_id=$(get_ext_id "$1")
     if [[ -n "$_ext_id" && "$_ext_id" != "null" ]]; then
         local _issue_num="${_ext_id##*:}"

package/commands/parallel-assign.md

@@ -1,15 +1,21 @@
 ---
-description: "Assign and resolve multiple independent backlog issues in parallel using git worktrees and coordinated agents"
+description: "Assign and resolve multiple independent backlog issues in parallel — each agent works in its own isolated git worktree"
 ---
 
 Run `/viban:parallel-assign` to process multiple backlog issues simultaneously.
 
+Each issue is resolved in a **separate git worktree**, so agents never interfere with each other's work. Worktrees are automatically cleaned up after PRs are created.
+
 Usage: `/viban:parallel-assign [count]`
 
 - `count`: Number of issues to process in parallel (default: 3, max: 5)
 
 Examples:
-- `/viban:parallel-assign` — resolve up to 3 backlog issues in parallel
+- `/viban:parallel-assign` — resolve up to 3 backlog issues in parallel (each in its own worktree)
 - `/viban:parallel-assign 5` — resolve up to 5 backlog issues in parallel
 
-Each issue gets its own opus agent working in an isolated git worktree. After all agents finish, PRs are created, local branches are preserved, and worktrees are cleaned up.
+How it works:
+1. Assigns N backlog issues and creates isolated git worktrees (`.viban/worktrees/{id}`)
+2. Spawns one opus agent per issue — each agent works exclusively in its own worktree
+3. Agents analyze, implement, commit, push, and create PRs independently
+4. Coordinator collects results, runs tests, and cleans up worktrees

package/commands/setup.md

@@ -370,7 +370,7 @@ If build/test fails: fix errors, return to Phase 3.
 {AUTO_DETECTED from git history — infer format from existing commits. If Q3 overrides, use that instead.}
 
 ### Branch Convention
-{AUTO_DETECTED from existing patterns, or `viban-{id}` as default}
+{AUTO_DETECTED from existing patterns, or `issue-{id}` as default}
 
 ### Pull Request
 {FROM Q1:}

package/docs/CLAUDE.md

@@ -60,16 +60,16 @@ EOF
 ### 🔴 Worktree 사용 금지
 - **main repo에서 feature branch로 직접 작업**
 - worktree 생성/사용 금지 (사용자 명시적 요청)
-- 브랜치 네이밍: `viban-{ISSUE_ID}` (예: `viban-78`)
+- 브랜치 네이밍: `issue-{ISSUE_ID}` (예: `issue-78`)
 
 ### Branch-Based Workflow
 ```bash
 # 1. main에서 분기
 git checkout main && git pull
-git checkout -b viban-{ISSUE_ID}
+git checkout -b issue-{ISSUE_ID}
 
 # 2. 작업 후 push
-git push -u origin viban-{ISSUE_ID}
+git push -u origin issue-{ISSUE_ID}
 
 # 3. PR 생성
 gh pr create --title "..." --body "..."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin-viban",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
   "main": "bin/viban",
   "bin": {

package/skills/assign/SKILL.md

@@ -49,8 +49,7 @@ SYNC_ACTIVE=false; EXTERNAL_NUM=""
 if [ -n "$EXT_ID" ] && [ "$EXT_ID" != "null" ]; then
     SYNC_ACTIVE=true
     EXTERNAL_NUM="${EXT_ID##*:}"  # "github:42" -> "42"
-    TITLE=$(echo "$ISSUE_JSON" | jq -r '.title' | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | head -c 40)
-    git checkout -b "issue-${EXTERNAL_NUM}-${TITLE}"
+    git checkout -b "issue-${EXTERNAL_NUM}"
 else
     git checkout -b issue-$ISSUE_ID
 fi

package/skills/parallel-assign/SKILL.md

@@ -55,16 +55,7 @@ for i in $(seq 1 $N); do
     ID=$(viban assign "$SESSION" 2>&1 | tail -1)
     [[ -z "$ID" || "$ID" == "No backlog" ]] && break
 
-    # Determine branch name (same logic as /viban:assign Phase 0.3)
-    ISSUE_JSON=$(viban get "$ID")
-    EXT_ID=$(echo "$ISSUE_JSON" | jq -r '.external_id // ""')
-    if [ -n "$EXT_ID" ] && [ "$EXT_ID" != "null" ]; then
-        EXTERNAL_NUM="${EXT_ID##*:}"
-        TITLE=$(echo "$ISSUE_JSON" | jq -r '.title' | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | head -c 40)
-        BRANCH="issue-${EXTERNAL_NUM}-${TITLE}"
-    else
-        BRANCH="issue-${ID}"
-    fi
+    BRANCH="issue-${ID}"
 
     ISSUES+=("${ID}|${BRANCH}")
 done
@@ -83,7 +74,8 @@ mkdir -p "$REPO_ROOT/.viban/worktrees"
 for entry in "${ISSUES[@]}"; do
     ID="${entry%%|*}"
     BRANCH="${entry##*|}"
-    WT_DIR="$REPO_ROOT/.viban/worktrees/$BRANCH"
+    # Use issue ID as worktree dir name (matches cmd_done cleanup at .viban/worktrees/{ID})
+    WT_DIR="$REPO_ROOT/.viban/worktrees/$ID"
 
     git worktree add -b "$BRANCH" "$WT_DIR" origin/main
 done
@@ -107,7 +99,7 @@ Spawn one **opus** agent per issue using `Task` tool. All agents launch in a sin
 You are resolving viban issue #{ID} in an isolated git worktree.
 
 ## Environment
-- Worktree path: {REPO_ROOT}/.viban/worktrees/{BRANCH}
+- Worktree path: {REPO_ROOT}/.viban/worktrees/{ID}
 - Branch: {BRANCH}
 - Main repo: {REPO_ROOT}
 - ALL file operations must happen inside the worktree path
@@ -125,7 +117,7 @@ You are resolving viban issue #{ID} in an isolated git worktree.
 
 You are one of {N} parallel agents working in isolated git worktrees.
 
-1. Work ONLY inside your worktree: {REPO_ROOT}/.viban/worktrees/{BRANCH}
+1. Work ONLY inside your worktree: {REPO_ROOT}/.viban/worktrees/{ID}
    - cd to the worktree before any work
    - All reads, edits, and writes must target files under this path
 
@@ -136,7 +128,7 @@ You are one of {N} parallel agents working in isolated git worktrees.
 
 3. After implementation, commit on your branch:
    ```bash
-   cd {REPO_ROOT}/.viban/worktrees/{BRANCH}
+   cd {REPO_ROOT}/.viban/worktrees/{ID}
    git add <specific files>
    git commit -m "type: description
 
@@ -214,8 +206,8 @@ PRs have been created — worktrees are no longer needed:
 
 ```bash
 for entry in "${ISSUES[@]}"; do
-    BRANCH="${entry##*|}"
-    WT_DIR="$REPO_ROOT/.viban/worktrees/$BRANCH"
+    ID="${entry%%|*}"
+    WT_DIR="$REPO_ROOT/.viban/worktrees/$ID"
     git worktree remove "$WT_DIR" --force
 done
 ```

package/skills/setup/SKILL.md

@@ -393,7 +393,7 @@ If build/test fails: fix errors, return to Phase 3.
 {AUTO_DETECTED from git history — infer format from existing commits. If Q3 overrides, use that instead.}
 
 ### Branch Convention
-{AUTO_DETECTED from existing patterns, or `viban-{id}` as default}
+{AUTO_DETECTED from existing patterns, or `issue-{id}` as default}
 
 ### Pull Request
 {FROM Q1:}