parallel-assign

/parallel-assign

Parallel resolution of independent backlog issues via git worktrees.

CLI only (no direct viban.json access) | Opus sub-agents in isolated worktrees

viban is a zsh CLI tool. Always invoke as viban <command>, NEVER as python -m viban or python viban.

Input: $ARGUMENTS (optional: number of issues, default 3)

---

Output Rules

• Do NOT output any preamble. No "Your Task:", "I'll now...", "Let me...", or task summaries before starting work.
• NEVER delegate work back to the user. Each agent must complete its assigned issue fully — writing code, tests, and verifying. Phrases like "Your Task:", "TODO(human)", "Waiting for your implementation", "Take your time", or any message that asks the user to write code are strictly FORBIDDEN. If you encounter a TODO comment, implement it yourself.
• Start executing Phase 0 immediately and silently.

---

Phase 0: SETUP

0.1 Read Workflow

[ -f ".viban/workflow.md" ] && cat ".viban/workflow.md"

Fallback to CLAUDE.md, then default. Same as /viban:assign Phase 0.1.

0.2 Parse Arguments

Extract count from $ARGUMENTS:

• Number provided (e.g. /viban:parallel-assign 5) → use that number
• No number → default to 3
• Maximum: 5

0.3 Check Backlog & Git State

viban list

Count available backlog issues. Adjust N down if fewer available. If backlog is empty: notify user and exit.

[ -n "$(git status --porcelain)" ] && echo "Warning: Uncommitted changes"
git checkout main && git fetch origin main && git reset --hard origin/main

0.4 Assign Issues

Assign N issues, each with a unique session ID. Determine branch names per workflow convention:

ISSUES=()  # Array of "ID|BRANCH" pairs
for i in $(seq 1 $N); do
    SESSION=$(echo "${RANDOM}${i}" | md5 | head -c 8)
    ID=$(viban assign "$SESSION" 2>&1 | tail -1)
    [[ -z "$ID" || "$ID" == "No backlog" ]] && break

    BRANCH="issue-${ID}"

    ISSUES+=("${ID}|${BRANCH}")
done