[FEATURE] Enhance worktree workflow and autonomous agent integration

[gerchowl]

Description

Improve the worktree-based autonomous development workflow by addressing configuration management, bug fixes, and PR automation enhancements. This is a parent issue tracking multiple related improvements to the just worktree-* recipes and autonomous agent integration.

Problem Statement

The worktree workflow has evolved organically and now has several areas that need systematic improvement:

1. Configuration scattered across recipes - Agent model selections were hardcoded in justfile recipes rather than being centrally configured
2. Branch resolution bugs - gh issue develop --list now returns tab-separated output (branch\tURL), breaking the grep -oE '[^ ]+$' pattern that expects space-separated output
3. Limited PR automation - The autonomous PR creation cannot specify reviewers, requiring manual follow-up

These issues affect the reliability and maintainability of the autonomous agent workflow that powers parallel development via worktrees.

Proposed Solution

Address these issues through focused sub-issues:

1. Config as SSoT - Extract agent model assignments to .cursor/agent-models.toml with task tiers (lightweight, autonomous)
2. Fix branch resolution - Update the parsing logic to handle tab-separated gh output correctly
3. Optional PR reviewer param - Thread an optional reviewer parameter through worktree-start so autonomous PRs can assign reviewers

Each improvement maintains backward compatibility and follows the repo's Single Source of Truth principle.

Alternatives Considered

• Monolithic refactor - Rejected in favor of incremental, traceable improvements via sub-issues
• Wait for native Cursor worktree support in devcontainers - Still broken as of Feb 2026, CLI workflow remains necessary

Additional Context

The worktree workflow enables true parallel autonomous development where multiple agents can work on different issues simultaneously in isolated environments. Reliability and configuration management are critical for this workflow.

Related:

• Cursor forum issue: https://forum.cursor.com/t/cursor-parallel-agents-in-wsl-devcontainers-misresolve-worktree-paths-and-context/145711

Impact

• Improves reliability and maintainability of autonomous agent workflows
• Makes configuration explicit and centralized (SSoT)
• Backward compatible - all changes are additive or fix existing bugs
• Benefits anyone using just worktree-start for parallel development

Changelog Category

Changed

[gerchowl]

Sub-issues

• [FEATURE] Add optional reviewer parameter to worktree-start for autonomous PR creation #102 - Add optional reviewer parameter to worktree-start

[gerchowl]

Implementation Plan

Issue: #103
Branch: feature/103-worktree-workflow-enhancements

Scope: Goal 2 — Fix branch resolution for tab-separated gh issue develop --list output. (Goals 1 and 3 are already done.)

Bug: gh issue develop --list returns branch<TAB>URL. The current parsing grep -oE '[^ ]+$' treats tab as non-space, capturing the entire line instead of just the branch name.

Approach: Extract the parsing into scripts/resolve-branch.sh (SSoT). Both justfile call sites pipe through it. BATS tests exercise the actual script.

Tasks (TDD)

• Task 1 (RED): Write BATS tests for scripts/resolve-branch.sh — tests/bats/worktree.bats — verify: bats tests/bats/worktree.bats fails
• Task 2 (GREEN): Create scripts/resolve-branch.sh and update both call sites in justfile.worktree to use it — scripts/resolve-branch.sh, justfile.worktree — verify: bats tests/bats/worktree.bats passes
• Task 3: Update CHANGELOG — add entry under ## Unreleased > Fixed — CHANGELOG.md — verify: visual check

Commit sequence

1. test: add BATS tests for resolve-branch script (RED) ✓
2. fix: extract branch resolution to script and fix tab-separated parsing (GREEN) ✓
3. docs: update CHANGELOG for branch resolution fix ✓