Fan-out i Map-Reduce w kodowaniu z użyciem subagentów

1. Przegląd koncepcji i problem systemowy

Gdy przed programistą staje duże, powtarzalne zadanie (np. przepisanie 30 ikon ze SVG na komponenty React lub utworzenie 15 nowych stron dokumentacji), uruchomienie jednego agenta napotyka prawo malejących przychodów:

• Agent pracuje sekwencyjnie: 2 minuty na stronę = 30 minut oczekiwania.
• Przy 10. stronie kontekst agenta zostaje zaśmiecony wcześniej wygenerowanymi plikami, model zaczyna halucynować, mylić style lub zwracać skrócone placeholdery.

Subagent Fan-out (Map-Reduce) przenosi klasyczną koncepcję obliczeń rozproszonych do świata vibe codingu: zadanie jest natychmiast rozdzielane na N niezależnych workerów (Map), którzy działają równolegle, po czym pojedynczy reducer zbiera finalny artefakt (Reduce).

2. Taksonomia architektoniczna i model mentalny

                       ┌─────────────────────────┐
                       │    ROOT TASK DISPATCH   │
                       │ "Create 4 Landing Pages"│
                       └────────────┬────────────┘
                                    │
           ┌────────────────┬───────┴────────┬────────────────┐
           ▼ (Fan-out)      ▼ (Fan-out)      ▼ (Fan-out)      ▼ (Fan-out)
     ┌───────────┐    ┌───────────┐    ┌───────────┐    ┌───────────┐
     │ Subagent 1│    │ Subagent 2│    │ Subagent 3│    │ Subagent 4│
     │ Page: /vps│    │ Page: /ai │    │ Page: /mcp│    │ Page: /rag│
     └─────┬─────┘    └─────┬─────┘    └─────┬─────┘    └─────┬─────┘
           │                │                │                │
           └────────────────┼────────────────┼────────────────┘
                            ▼ (Reduce & Validate)
                       ┌─────────────────────────┐
                       │   AGGREGATION & MERGE   │
                       │ • Index exports update  │
                       │ • Global typecheck gate │
                       └────────────┬────────────┘
                                    │
                                    ▼
                       ┌─────────────────────────┐
                       │    SINGLE CLEAN PR      │
                       └─────────────────────────┘

3. Praktyczne scenariusze inżynierskie w środowisku produkcyjnym

01. Wielojęzyczna lokalizacja projektu na 4 języki

Główny agent czyta nowy plik messages/uk.json (50 nowych kluczy) i uruchamia 3 równoległe subagenty: dla en.json, es.json oraz de.json. Każdy subagent posiada własne reguły językowe, kontekst nie ulega zmieszaniu, a tłumaczenie realizowane jest jednocześnie w ciągu 40 sekund.

02. Masowe pokrycie testami (Test Fleet)

Supervisor skanuje repozytorium, wykrywa 12 endpointów API bez testów jednostkowych i uruchamia 12 lekkich subagentów na modelu Gemini 2.0 Flash. Każdy subagent pisze jeden izolowany plik testowy, uruchamia vitest dla swojego pliku i przekazuje wynik supervisorowi.

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

• API Rate Limiting (Wyczerpanie limitu zapytań): Jednoczesne uruchomienie 20 subagentów może natychmiast napotkać limit RPM (Requests Per Minute) Twojego klucza OpenAI lub Anthropic. Stosuj kolejkę z throttlingiem (Concurrency Limiter: maks. 5 równoległych agentów).
• Konflikty stanu współdzielonego (Shared State Conflicts): Jeśli dwa subagenty spróbują jednocześnie edytować ten sam plik konfiguracyjny (np. package.json), dojdzie do konfliktu. Współdzielone pliki powinien modyfikować wyłącznie główny reducer.

5. Strategiczny wniosek dla inżyniera roku 2026

Subagent Fan-out zamienia pracę inżyniera w dyrygowanie orkiestrą. Zamiast czekać godzinami na wykonanie zadań, zyskujesz możliwość skalowania swojej wydajności inżynierskiej poziomo w ciągu kilku sekund.