|
2 | 2 |
|
3 | 3 | --- |
4 | 4 |
|
| 5 | +## [11.8.0] - 2025-12-15 |
| 6 | + |
| 7 | +### ✨ Added |
| 8 | + |
| 9 | +**Worktree-First Safety Model for Multi-Agent Isolation** |
| 10 | + |
| 11 | +Run multiple Claude Code instances from root folder with automatic git isolation - each agent works in its own worktree with namespaced branches. |
| 12 | + |
| 13 | +- **Studio context detection**: Auto-detect when running in `worktrees/studio/agent-N/` directories |
| 14 | + - `detect_studio_context()`: Returns agent ID (e.g., `agent-1`) if in studio worktree |
| 15 | + - `is_studio_mode()`: Boolean check for studio context |
| 16 | +- **Branch namespacing**: Studio agents get isolated branch names |
| 17 | + - Studio mode: `studio/agent-N/feature/XXX-slug` |
| 18 | + - Normal mode: `feature/XXX-slug` |
| 19 | + - Prevents git conflicts during parallel development |
| 20 | +- **Root safety checks**: Block changes from root when active worktrees exist |
| 21 | + - `find_active_worktrees()`: List all in-progress features/epics in worktrees |
| 22 | + - `check_root_safety()`: Returns safe/blocked status with recommended action |
| 23 | +- **PHASE 0.5 safety check**: Added to `/feature`, `/epic`, `/quick` commands |
| 24 | + - Runs before any work begins |
| 25 | + - Blocks or prompts based on protection level |
| 26 | + |
| 27 | +**New Worktree Preferences** |
| 28 | + |
| 29 | +- **`worktrees.enforce_isolation`**: Require worktree isolation for all implementation (default: true) |
| 30 | +- **`worktrees.root_protection`**: Protection level when in root with active worktrees |
| 31 | + - `strict`: Block changes, require switch to worktree (default) |
| 32 | + - `prompt`: Ask user to confirm root changes |
| 33 | + - `none`: Allow changes without protection |
| 34 | +- **`worktrees.auto_switch_on_continue`**: Auto-prompt to switch when resuming from root (default: true) |
| 35 | +- **`worktrees.cleanup_on_finalize`**: Remove worktree after deployment (default: true) |
| 36 | + |
| 37 | +**Worktree Cleanup at Finalize** |
| 38 | + |
| 39 | +- `/finalize` now cleans up worktree when `cleanup_on_finalize` is enabled |
| 40 | +- Agent returns to root repository for next work |
| 41 | +- Safe deletion only (preserves unmerged changes) |
| 42 | + |
| 43 | +**Studio Mode Integration** |
| 44 | + |
| 45 | +- `/feature`, `/epic`, `/quick` automatically detect studio context |
| 46 | +- Branch names auto-namespaced for studio agents |
| 47 | +- PR-based shipping for studio agents (like real dev teams) |
| 48 | +- No code changes needed in existing workflows |
| 49 | + |
| 50 | +### 🔧 Changed |
| 51 | + |
| 52 | +- **User preferences schema**: Added `worktrees` section (v1.6) |
| 53 | +- **worktree-context.sh**: Central script for all worktree management |
| 54 | +- **CLAUDE.md**: Added Studio Mode and Worktree-First Safety documentation |
| 55 | + |
| 56 | +--- |
| 57 | + |
5 | 58 | ## [11.7.0] - 2025-12-15 |
6 | 59 |
|
7 | 60 | ### ✨ Added |
|
0 commit comments