Subagenci zakresowi — deleguj pracę, nie odpowiedzialność

Subagent jest użyteczny, gdy zamknięte zadanie poboczne zapełniłoby główną rozmowę wynikami wyszukiwania, logami lub niezależnym review. Nie służy do dzielenia silnie powiązanej zmiany między konkurujących autorów. W Q11 najmocniejszym dowodem jest mały zestaw ocenionych ról z wąskimi możliwościami, jawnym handoffem, izolowanym zapisem i rodzicem odpowiedzialnym za końcowy wynik.

Scorecard Q11: Jak używasz zakresowych subagentów z ograniczonymi narzędziami?

Dowód na maksymalny wynik: powtarzalne role explorera, verifiera i specjalisty z testowanymi granicami oraz przeglądalnym wynikiem.

Deleguj tylko pracę, którą da się rozdzielić

Dobre zadania to mapowanie repo, research w oficjalnej dokumentacji, analiza logów testowych i review w świeżym kontekście. Zostaw pracę sekwencyjną w głównym wątku, jeśli każdy krok zależy od nierozstrzygniętego wyniku poprzedniego.

Używaj tego kontraktu dla każdej delegacji:

Objective: one concrete result
Inputs: exact files, artifact, branch, or question
Allowed actions: read-only, test-only, or an isolated write scope
Output: findings with file/line evidence or a named artifact
Stop: ambiguity, required approval, failed prerequisite, or scope expansion

Nie pozwalaj dwóm agentom zapisującym pracować w tym samym checkoutcie na nakładających się plikach. Daj im osobne worktree lub branche w chmurze, a następnie świadomie przejrzyj i zintegruj diffy.

Przełóż rolę na każde narzędzie

Narzędzie	Definicja projektu	Ważna granica
Claude Code	.claude/agents/<name>.md	Ustaw tools lub disallowedTools; użyj isolation: worktree dla izolowanego zapisu
Cursor	.cursor/agents/<name>.md	Subagenci współdzielą checkout bez izolacji; cloud subagents używają skonfigurowanego środowiska chmurowego
Codex	.codex/agents/<name>.toml	Ustaw sandbox_mode i potrzebne opcje; subagenci dziedziczą bieżące uprawnienia tury rodzica

Źródła: subagenci Claude Code, subagenci Cursora i subagenci Codexa.

Nie kopiuj pliku definicji jednego dostawcy do katalogu drugiego. Współdziel kontrakt roli w dokumentacji, ale trzymaj osobne adaptery wykonawcze i testuj każdy z nich.

Zacznij od explorera i verifiera

Explorer powinien być read-only i zwracać mapę, nie patch. Verifier powinien dostać zaakceptowany spec.md, diff i dozwolone komendy. Ma zgłaszać niespełnione kryteria bez cichego naprawiania pracy autora. Dodawaj role dopiero wtedy, gdy transkrypty pokazują powtarzalne, rozdzielne zadanie.

Prompt do skopiowania — eksploracja:

Delegate a read-only explorer to trace the real execution path for <behavior>. It may search and read files but must not edit. Return entry points, state transitions, tests, and open questions with file-and-line evidence.

Prompt do skopiowania — niezależna weryfikacja:

Give a fresh-context verifier spec.md and the current diff. It may read files and run the documented local checks, but it must not edit. Return PASS or BLOCKED for every acceptance criterion and cite the evidence.

Prompt do skopiowania — decyzja o równoległości:

Partition this plan into independent and dependent steps. Delegate only tasks that do not share mutable files or unresolved decisions. State the checkout or worktree for every writing agent and keep integration in the parent thread.

Mierz delegację

Dla kilku reprezentatywnych zadań porównaj wykonanie przez jednego agenta z wersją delegowaną. Zapisz czas, łączne tokeny lub koszt, jeśli są dostępne, powieloną pracę, findings przyjęte przez rodzica i defekty integracji. Szybszy model lub równoległe wykonanie nie staje się automatycznie tańsze ani lepsze po doliczeniu retry i review.

Pułapka: więcej agentów, mniej odpowiedzialności

Sygnały ostrzegawcze to niejasne prompty, nieograniczone narzędzia dla pracy read-only, zrzuty surowego outputu, nakładające się edycje, delegacja rekurencyjna bez limitu i rodzic zgłaszający sukces bez sprawdzenia wyniku. Zatrzymaj delegację, gdy koszt koordynacji przewyższa oszczędzony kontekst lub czas. Akceptacja człowieka pozostaje wymagana na bramkach ryzyka repo.

Dowód ukończenia

• Każda rola ma cel, wejście, granicę działania, format wyjścia i warunek stopu.
• Role read-only nie zapisują; role zapisujące używają izolowanych branchy lub worktree przy równoległości.
• Rodzic sprawdza dowody względem spec.md przed integracją.
• Zapisano co najmniej jedno porównanie single-agent i delegacji.
• Błędy aktualizują rolę, plan lub test zamiast zostać poradą tylko w czacie.

Przejdź do ograniczonego wykonania

AI-native Build Wykonaj zaakceptowany plan z ograniczoną równoległością i widocznymi checkpointami.

Q12 · Hooki agenta Dodaj deterministyczne kontrole wokół ryzykownych akcji narzędziowych.

Git worktrees Izoluj równoległych autorów i ich stan uruchomieniowy.