worktree-setup
/worktree-setup
Tworzy izolowany worktree z gałęzią funkcji dla workflow PACT, gdy zaczyna się nowa funkcja albo podzakres.
- Autor
- Synaptic-Labs-AI ↗
- Repozytorium
- PACT-Plugin ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Tworzy izolowany worktree z gałęzią funkcji dla workflow PACT, gdy zaczyna się nowa funkcja albo podzakres.
Oryginalny opis (EN)
Create an isolated git worktree with a feature branch for PACT workflows. Use when: starting a new feature, beginning orchestrate or comPACT, creating sub-scope isolation for ATOMIZE, or manually isolating work. Triggers on: worktree setup, feature isolation, parallel workflow, new worktree.
Jak działa
- When to Use
- Process
- Edge Cases
Podgląd SKILL.md
---
name: worktree-setup
description: |
Create an isolated git worktree with a feature branch for PACT workflows.
Use when: starting a new feature, beginning orchestrate or comPACT,
creating sub-scope isolation for ATOMIZE, or manually isolating work.
Triggers on: worktree setup, feature isolation, parallel workflow, new worktree.
user_invokable: true
---
# Worktree Setup
Create an isolated git worktree with a feature branch for PACT workflows. This provides filesystem isolation so multiple features or sub-scopes can run in parallel without interference.
## When to Use
- Starting a new feature workflow (`/PACT:orchestrate`, `/PACT:comPACT`)
- ATOMIZE phase creating sub-scope isolation
- Manually isolating work for a feature branch
## Process
Follow these steps in order. Stop and report any errors to the user.
### Step 1: Check for Existing Worktree
Before creating anything, check if a worktree already exists for this branch.
```bash
git worktree list
```
- If a worktree for the target branch already exists, **reuse it**. Report: "Reusing existing worktree at {path}" and skip to Step 4.
- If the worktree appears in the list but is marked **prunable**, run `git worktree prune` first and proceed to create a new one.
- If the branch exists but has no worktree, ask the user: "Branch `{branch}` already exists. Check out existing branch, or create a new branch name?"
### Step 2: Ensure `.worktrees/` Directory
All worktrees live in `.worktrees/` relative to the repo root.
```bash
# Get main repo root (from a worktree, returns absolute path; from main repo, returns relative .git — the cd && pwd wrapper normalizes both to absolute)
MAIN_GIT_DIR=$(git rev-parse --git-common-dir)
REPO_ROOT=$(cd "$(dirname "$MAIN_GIT_DIR")" && pwd)
# Create directory and ensure gitignored
mkdir -p "$REPO_ROOT/.worktrees"
grep -q '\.worktrees' "$REPO_ROOT/.gitignore" 2>/dev/null || echo '.worktrees/' >> "$REPO_ROOT/.gitignore"
```
### Step 3: Create the Worktree
```bash
git worktree add "$REPO_ROOT/.worktrees/{branch}" -b {branch}
```
Where `{branch}` is the feature branch name (e.g., `feature-auth` or `feature-auth--backend` for sub-scopes).
**If creation fails**:
- Branch already exists: Ask user whether to check out the existing branch (`git worktree add "$REPO_ROOT/.worktrees/{branch}" {branch}` without `-b`)
- Disk/permissions error: Surface git's error message and offer fallback to working in the main repo directory
### Step 4: Report
Output the result:
```
Worktree ready at {REPO_ROOT}/.worktrees/{branch}
Branch: {branch}
```
**Return the worktree path** so it can be passed to subsequent phases and agents.
## Edge Cases
| Case | Handling |
|------|---------|
| Already in a worktree for this feature | Detect via `git worktree list`, reuse existing |
| Worktree directory exists but is stale | Run `git worktree prune` first, then retry |
| Branch name already exists | Ask user: check out existing or create new name |
| Creation fails (disk/permissions) | Surface error, offer fallback to main repo |
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · Synaptic-Labs-AI/PACT-Plugin | 100 | MIT |
| LeeJuOh/claude-code-zero | 100 | MIT |
| zcaceres/skills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki c19cf74ed318 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100worktree-cleanup
Usuwa worktree i jego gałąź po zakończeniu workflow PACT, gdy PR jest scalony albo trzeba posprzątać ręcznie. - 100worktree
Tworzy worktree gita dla nowej gałęzi funkcji i przygotowuje w nim pliki oraz zależności. - 100worktree
Tworzy worktree gita do izolowanej pracy, gdy trzeba zrobić poprawkę lub nową funkcję równolegle do bieżącej. - 95dev_manage_git-worktrees
Tworzy izolowane git worktrees z mądrym wyborem katalogu i weryfikacją bezpieczeństwa, do pracy nad funkcjami niezależnie od bieżącego workspace'u. - 100ce-worktree
Przygotowuje izolowane worktrees gita: tworzy nową gałąź do świeżej pracy albo podpina worktree do istniejącej gałęzi, PR lub commita. - 100new-worktree
Tworzy izolowany worktree gita w katalogu .claude/worktrees dla subagenta, aby równoległa praca nie powodowała kolizji.