Izolowane zadania Codex przez Git worktrees

Worktrees izolują zmienne pliki, dzięki czemu równoległe zadania Codex mogą czytać, edytować, instalować zależności i testować bez współdzielenia jednego katalogu. Aplikacja Codex potrafi utworzyć zarządzany worktree. Codex CLI 0.146.0 nie ma flagi --worktree, więc workflow terminalowy tworzy checkout przez Git i uruchamia Codex w środku.

Wybór powierzchni

Potrzeba	Użyj	Granica
Izolowane zadanie zarządzane przez aplikację	Utwórz zadanie Codex w środowisku worktree	Zacznij z jawnego stanu repo i sprawdź wynikowy diff
Sesja CLI w izolowanym checkout	`git worktree add`, potem `codex` w tym katalogu	Git odpowiada za utworzenie, branch, listę i usunięcie
Katalog bez Gita	Bezpośrednie zadanie lokalne	Worktree jest niedostępny; kopiuj lub inicjalizuj tylko zgodnie z polityką

Workflow aplikacji opisuje dokumentacja worktrees Codex. Dostępność CLI sprawdzono przez codex --help 4 września 2026.

Workflow CLI

Sprawdź repo i bieżące zmiany.
Okno terminala
```
git status --short
git branch --show-current
git worktree list
```
Nie bazuj worktree na niezacommitowanych zmianach, chyba że świadomie je commitujesz lub przenosisz.
Utwórz branch i checkout.
Okno terminala
```
git fetch origin
git worktree add -b codex/fix-auth ../project-codex-fix-auth origin/main
```
Zastąp branch, ścieżkę i bazę zweryfikowanymi wartościami. Nie zgaduj default brancha.
Uruchom Codex w worktree.
Okno terminala
```
cd ../project-codex-fix-auth
codex
```
Załaduj projektowy setup bez kopiowania credentials produkcji. Dla równoległych dev servers przydziel osobne porty.
Zweryfikuj i zintegruj.

Uruchom bramki repo, sprawdź git diff, commituj na branchu zadania i otwórz PR. Merguj zwykłą ścieżką review; nie aplikuj kilku patchy agentów w ciemno.
Usuń dopiero po zachowaniu pracy.
Okno terminala
```
git -C ../project-codex-fix-auth status --short
git worktree remove ../project-codex-fix-auth
git worktree prune
```
Remove domyślnie odmawia usunięcia dirty worktree. Nie dodawaj --force bez dowodu, że stan jest zbędny.

Kontrakt zadania równoległego

Każde zadanie powinno mieć:

jeden outcome i non-goals;
osobny worktree oraz branch;
rozłączne ownership, gdzie to możliwe;
własne porty, caches i lokalny stan usług;
jawne zakazy dla współdzielonej chmury;
dokładne testy i raport dowodów;
kolejność integracji oraz ludzkiego ownera.

Pracuj wyłącznie w tym checkout i branchu.
Wykonaj zaakceptowany plan.md bez dotykania współdzielonej chmury.
Uruchom bramki i zgłoś komendy oraz exit codes.
Zatrzymaj się, gdy inne zadanie zmieniło ten sam interfejs
albo plan wymaga istotnej zmiany. Nie merguj, nie wdrażaj i nie usuwaj worktree.

Gdy izolacja zawodzi

Branch jest checkoutowany gdzie indziej. Sprawdź git worktree list i utwórz osobny branch; Git pozwala checkoutować branch tylko w jednym worktree.

Brakuje lokalnego env. Użyj udokumentowanego bootstrapu lub kopiuj wyłącznie jawnie dozwolone, gitignored pliki developerskie. Nie kopiuj sekretów produkcji.

Serwery zderzają się na portach. Przydziel port block per worktree i przekaż go jawnie do dev servera i testów.

Zmiany konfliktują przy integracji. Rebase lub merge wykonaj w kolejności wybranej przez człowieka, uruchom pełne bramki i zaktualizuj plan.md, jeśli zmienił się design.

Weryfikacja izolacji

Każde zadanie ma jedną ścieżkę i branch w git worktree list.
Porty developerskie i lokalne bazy są rozdzielone.
Żadne zadanie nie mutuje współdzielonej produkcji lub third-party state.
Każde zadanie raportuje komendy, exit codes i diff.
Integracja uruchamia połączony test suite.
Cleanup zachowuje wszystkie potrzebne commity i branche.

Dalsza praca z Codeksem

Adapter AI-native SDLC dla Codeksa mapuje plan, build, review i automatyzację. Przed zapisaniem flag sprawdź ponownie polecenia Codex.