Problem: jeden AI, wszystko sekwencyjnie

Pracujesz z Claude Code. Piszesz "dodaj feature X" i czekasz. Claude czyta 5 plików, edytuje 3, pisze testy, aktualizuje dokumentację — wszystko jedno po drugim. Po 15 minutach kontekst jest tak duży, że Claude zapomina co robił na początku. Commit? Jeden wielki "zmieniono 20 plików". Kto co zrobił? Nie wiadomo.

Brzmi znajomo? Tak pracuje 99% ludzi z AI. Ale jest lepszy sposób.

Rozwiązanie: zespół agentów AI

Wyobraź sobie, że zamiast jednego Claude'a masz 10 wyspecjalizowanych agentów. Jeden pisze backend, drugi frontend, trzeci pilnuje bezpieczeństwa, czwarty pisze testy. Pracują równolegle — każdy w swojej kopii repozytorium. Commitują pod swoim imieniem (🤖 Backer, 🤖 Frontik...). Otwierają Pull Requesty. A Ty zatwierdzasz merge.

Zadanie które zajmowało 30 minut? 5 minut. Git log w którym nie wiadomo co się stało? Teraz widać: Backer zrobił endpoint, Frontik dodał UI, Securitor sprawdził bezpieczeństwo.

W tym poradniku zbudujesz to od zera. Otworzysz VSCode, skonfigurujesz Claude Code, utworzysz agentów i przetestujesz na prawdziwym zadaniu.

Co to zmienia?

Przygotowanie — co zainstalować

Zanim zaczniemy, potrzebujesz kilku narzędzi. Wszystkie są darmowe (oprócz subskrypcji Claude). Jeśli coś już masz — pomiń ten krok.

1. VSCode — Twój edytor kodu

Jeśli jeszcze nie masz — pobierz Visual Studio Code (darmowy). To edytor w którym będziesz pracować z Claude Code i przeglądać zmiany.

2. GitLens — rozszerzenie do VSCode

Otwórz VSCode → kliknij ikonę rozszerzeń (po lewej, kwadraciki) → wyszukaj "GitLens" → zainstaluj. GitLens pokaże Ci kto napisał każdą linię kodu — i to właśnie tutaj zobaczysz, że 🤖 Backer zmienił backend, a 🤖 Frontik frontend.

3. Claude Code — AI w terminalu

Claude Code to narzędzie od Anthropic (twórcy Claude). Instalujesz je w terminalu i od tego momentu rozmawiasz z AI który czyta, edytuje i commituje kod za Ciebie.

# Instalacja Claude Code
npm install -g @anthropic-ai/claude-code

# Sprawdź czy działa
claude --version

4. GitHub — gdzie trzymasz kod

Jeśli nie masz konta — załóż na github.com (darmowe). Utwórz nowe repozytorium (prywatne lub publiczne). Agenci będą tam otwierać Pull Requesty — czyli propozycje zmian, które Ty zatwierdzasz.

5. GitHub CLI — terminal do GitHuba

# macOS
brew install gh

# Zaloguj się (otworzy przeglądarkę)
gh auth login
# Wybierz: GitHub.com → HTTPS → Login with browser

Plan implementacji

Faza 1: Fundamenty (30 min)
├── Branch "develop"
├── CI/CD (GitHub Actions)
└── Uprawnienia (settings.json)

Faza 2: Agenci (30 min)
├── 10 plików agentów (.claude/agents/*.md)
├── Skrypt agent-commit.sh
└── Skill /orchestrate

Faza 3: Batch (15 min)
└── Skill /batch

Faza 4: Dashboard (15 min)
└── Skrypt agent-dashboard.sh

Test: Prawdziwe zadanie (30 min)
├── Uruchomienie 2-3 agentów
├── PR-y na GitHub
└── Merge + weryfikacja

Łącznie: 2-3 godziny (z testowaniem i nauką po drodze)

Krok po kroku — implementacja

Krok 1: Utwórz branch "develop"

Master to Twoja produkcja — nikt nie powinien pushować tam bezpośrednio. Develop to miejsce gdzie agenci łączą swoją pracę.

# Przejdź do katalogu projektu
cd /ścieżka/do/twojego/projektu

# Utwórz branch develop z master
git checkout -b develop

# Wyślij na GitHub
git push -u origin develop

Krok 2: Zainstaluj GitHub CLI

# macOS
brew install gh

# Zaloguj się
gh auth login
# Wybierz: GitHub.com → HTTPS → Login with browser

Krok 3: CI/CD — automatyczne testy

Każdy PR od agenta jest automatycznie testowany. Jeśli testy nie przechodzą — wiesz że coś jest nie tak ZANIM zmergeujesz.

name: "Quality Gate"

on:
  pull_request:
    branches: [master, develop]

jobs:
  quality-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Sprawdź składnię
        run: |
          # Dostosuj do swojego języka/frameworka
          find . -name "*.php" -not -path "./vendor/*" \
            | xargs -n1 php -l

Krok 4: Uprawnienia

{
  "permissions": {
    "defaultMode": "bypassPermissions",
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(git push --force:*)",
      "Bash(git reset --hard:*)"
    ],
    "ask": [
      "Bash(lftp:*)"
    ]
  }
}

Krok 5: Zdefiniuj agentów

Każdy agent to plik Markdown w .claude/agents/:

---
name: 🤖 Backer
description: Backend — endpointy, klasy, API
model: opus
---

# 🤖 Backer — Agent Backend

Jesteś Backerem, agentem AI odpowiedzialnym za backend.

## Twoja rola
- Edycja plików backend (PHP/Python/Node)
- Nowe endpointy API, logika biznesowa

## Git identity
- Author: `🤖 Backer (AI Agent) <backer@twoja-firma.ai>`
- Branch: `feature/backer-[temat]`

Krok 6: Skrypt do commitowania jako agent

#!/bin/bash
# Użycie: ./scripts/agent-commit.sh backer "feat: nowy endpoint"

get_agent_info() {
    case "${1,,}" in
        lider)   AUTHOR_NAME="🤖 Claude Lider (AI Lead)"
                 AUTHOR_EMAIL="claude@twoja-firma.ai" ;;
        backer)  AUTHOR_NAME="🤖 Backer (AI Agent)"
                 AUTHOR_EMAIL="backer@twoja-firma.ai" ;;
        frontik) AUTHOR_NAME="🤖 Frontik (AI Agent)"
                 AUTHOR_EMAIL="frontik@twoja-firma.ai" ;;
        # ... dodaj swoich agentów
        *)       return 1 ;;
    esac
}

AGENT_ID="$1"; shift; COMMIT_MSG="$*"
get_agent_info "$AGENT_ID" || { echo "Nieznany agent: $AGENT_ID"; exit 1; }
git commit --author="${AUTHOR_NAME} <${AUTHOR_EMAIL}>" -m "${COMMIT_MSG}"

Krok 7: Skill /orchestrate

Pattern: PLAN → SPAWN → COLLECT → MERGE

1. PLAN — Claude analizuje zadanie i dzieli na niezależne części
2. SPAWN — Uruchamia agentów równolegle (każdy w izolowanym worktree)
3. COLLECT — Zbiera wyniki, sprawdza PR-y
4. MERGE — Łączy zmiany do develop

Testowanie

Test 1: Proof of concept (3 agentów)

Uruchom 3 agentów z prostym zadaniem — każdy dodaje komentarz w INNYM pliku:

• Doktor → plik docs
• Securitor → plik PHP
• Frontik → plik JS

Test 2: Prawdziwe zadanie

Weź małe zadanie które dotyka 2+ plików. Nasz wynik: 2 PR-y w 3 minuty (zamiast 10 minut sekwencyjnie).

Pułapki i sztuczki

Efekt końcowy

Twój projekt/
├── .claude/
│   ├── agents/           ← 10 agentów z tożsamościami
│   │   ├── backer.md
│   │   ├── frontik.md
│   │   └── ...
│   ├── skills/
│   │   ├── orchestrate/  ← dzielenie zadań na agentów
│   │   └── batch/        ← masowa refaktoryzacja
│   └── settings.local.json
├── .github/
│   └── workflows/
│       └── pr-quality-gate.yml  ← automatyczne testy
├── scripts/
│   ├── agent-commit.sh   ← commit jako agent
│   └── agent-dashboard.sh

Git log wygląda tak:

*   Merge PR #5 — 🤖 Doktor (dokumentacja)
|\
| * docs(chat): aktualizacja dokumentacji
* |   Merge PR #4 — 🤖 Frontik (localStorage)
|\ \
| * feat(chat): historia rozmów w localStorage
|/
* feat(devops): infrastruktura orkiestracji — 🤖 Claude Lider

Każdy widzi: kto co zrobił, kiedy, w jakim PR-ze. Jak prawdziwy zespół — tylko że AI.