Cieniowane worktree Git i zarządzanie gałęziami

1. Przegląd koncepcji i problem systemowy

Gdy programista uruchamia ciężkiego agenta w bieżącym katalogu projektu, praca zostaje sparaliżowana:

• Pliki w VS Code lub Cursorze zaczynają migać, ekran skacze, a lokalny serwer Next.js przeładowuje się 20 razy na minutę.
• Jeśli agent zepsuje konfigurację TypeScript, programista traci autouzupełnianie kodu w otwartych kartach.
• Nie można równolegle zajmować się innym zadaniem, dopóki agent nie zakończy sesji.

Shadow Git Worktrees eliminują ten problem. Zamiast pracować w Twoim bieżącym obszarze roboczym, agent otrzymuje własne „drzewo cieniujące” (Worktree) w sąsiednim katalogu.

2. Taksonomia architektoniczna i model mentalny

┌─────────────────────────────────────────────────────────────┐
│                 SHARED .GIT REPOSITORY CORE                 │
└──────────────┬───────────────────────────────┬──────────────┘
               │                               │
               ▼                               ▼
┌──────────────────────────────┐┌──────────────────────────────┐
│ HUMAN WORKSPACE (main)       ││ AGENT WORKTREE (task/ai-fix) │
│ Path: ~/projects/app         ││ Path: ~/projects/app-agent-1 │
│ • Active Cursor IDE Session  ││ • Headless Agent Execution   │
│ • Local Dev Server on :3000  ││ • Test Runner on :3001       │
│ • Zero Flickering / Chaos    ││ • Builds, lints & verifies   │
└──────────────────────────────┘└──────────────┬───────────────┘
                                               │
                                               ▼ Verified Diff
                                ┌──────────────────────────────┐
                                │ MERGE VIA CLEAN PULL REQUEST │
                                └──────────────────────────────┘

3. Praktyczne scenariusze inżynierskie w środowisku produkcyjnym

01. Równoległe wykonywanie długich migracji

Inżynier pracuje nad UI nowej strony w gałęzi feat/checkout, podczas gdy agent działający w tle w shadow worktree przepisuje stare endpointy backendowe z Express na Fastify w gałęzi refactor/api. Po przejściu testów inżynier wykonuje jedynie szybkie git merge.

02. Spekulatywne naprawianie błędów (testowanie podejść A/B)

Programista uruchamia dwóch agentów w dwóch różnych worktrees: jeden rozwiązuje problem poprzez aktualizację biblioteki, drugi – przez napisanie własnego polifillu. Inżynier porównuje rozmiar bundla obu gałęzi i wybiera najlepsze rozwiązanie.

4. Pułapki, typowe błędy i bezpieczeństwo

• Zapomniane worktrees (bałagan na dysku): Jeśli nie zautomatyzujesz usuwania drzew roboczych po zakończeniu tasku, foldery node_modules w dziesiątkach worktrees mogą szybko zapełnić cały dysk laptopa. Używaj automatycznych skryptów czyszczących (git worktree prune).
• Konflikty portów serwera lokalnego: Jeśli shadow worktree uruchamia własny serwer testowy, może próbować zająć ten sam port (np. :3000). Należy przekazać agentowi flagę PORT=3001 w zmiennych środowiskowych.

5. Strategiczny wniosek dla inżyniera roku 2026

Shadow Worktrees czynią współpracę z AI naprawdę asynchroniczną. Programista przestaje być zakładnikiem terminala czekającego na zakończenie generowania: agent staje się niewidzialnym kolegą, który pracuje w sąsiednim pokoju i puka do drzwi tylko z gotowym, przetestowanym wynikiem.