Konfiguracja Herdr z Claude Code i Google Antigravity (AGY) - Hooki i SKILL.md (Część 2)

Aby agenci AI uruchomieni w Herdrze nie byli tylko odizolowanymi oknami terminala, potrzebują dwóch elementów: natywnych hooków cyklu życia (raportujących stany working, idle i blocked) oraz wspólnego skilla `SKILL.md` (uczącego agentów, jak sterować multiplekserem). W drugiej części serii spinamy Claude Code oraz Google Antigravity CLI (`agy`) w jeden organizm.

Wszystkie części poradnika (Orkiestracja Claude Code + AGY w Herdr):

• Część 1: Herdr zamiast tmux - instalacja i pierwsze kroki z terminalem dla agentów AI
• Część 2 (czytany wpis): Konfiguracja Herdr z Claude Code i Google Antigravity (AGY) - Hooki i SKILL.md
• Część 3: Orkiestracja w praktyce: Gemini 4 Argon i Claude Opus dyrygują flotą Flash, Sonnet i Haiku w Herdr

Dwa filary integracji: raportowanie stanu (Hooks) oraz sterowanie (Skill)

W pierwszej części serii zainstalowaliśmy Herdr v0.9.5. Sam multiplekser potrafi rozpoznawać agentów na podstawie tego, co wyświetlają na ekranie terminala, ale pełną moc zyskujemy dopiero wtedy, gdy:

1. Zainstalujemy natywne hooki (`herdr integration install`): Agenci claude oraz agy zaczynają sami wysyłać sygnały do gniazda Herdr w ułamku sekundy, gdy zaczynają myśleć (working), czekają na zgodę użytkownika (blocked) lub kończą turę (idle).
2. Wygenerujemy i podepniemy `SKILL.md` (`herdr --skill`): Zarówno Claude Code, jak i Google Antigravity dowiadują się, jak używać CLI Herdra do dzielenia ekranu, spawnowania workerów i odczytywania ich odpowiedzi.

Krok 1: Instalacja natywnych hooków dla Claude Code i Antigravity CLI

Najnowszy Herdr posiada wbudowany menedżer integracji dla najpopularniejszych agentów. Sprawdzamy listę wspieranych integracji i od razu instalujemy wtyczki dla Claude Code oraz Antigravity CLI:

# Instalacja hooka statusu dla Claude Code
herdr integration install claude

# Instalacja hooka statusu dla Google Antigravity CLI (agy)
herdr integration install antigravity-cli

# Weryfikacja zainstalowanych wtyczek
herdr integration status | grep -E 'claude|antigravity'

Powiększ

Co dokładnie zrobił Herdr pod maską?

• Dla Claude Code utworzył skrypt /Users/kub/.claude/hooks/herdr-agent-state.sh i zarejestrował go w ~/.claude/settings.json.
• Dla Google Antigravity (`agy`) utworzył skrypt /Users/kub/.gemini/config/hooks/herdr-agent-state.sh i dopisał konfigurację do ~/.gemini/config/hooks.json.

Krok 2: Instalacja wspólnego skilla dla obu środowisk

Aby nasz główny agent (Orchestrator) potrafił samodzielnie wydawać polecenia multiplekserowi Herdr, eksportujemy wbudowany skill prosto z binarki herdr --skill do globalnych katalogów skilli AGY oraz Claude:

mkdir -p ~/.gemini/config/skills/herdr ~/.claude/skills/herdr
herdr --skill | tee ~/.gemini/config/skills/herdr/SKILL.md > ~/.claude/skills/herdr/SKILL.md

Dlaczego generujemy plik bezpośrednio przez herdr --skill? Ponieważ definicja skilla jest zawsze w 100% zgodna z wersją protokołu Twojej zainstalowanej binarki Herdr.

Krok 3: Podgląd wygenerowanych hooków oraz dobór modeli w AGY i Claude

Zajrzyjmy do pliku ~/.gemini/config/hooks.json oraz sprawdźmy listę modeli dostępnych w naszym środowisku (agy models):

cat ~/.gemini/config/hooks.json
agy models

Powiększ

Dzięki temu, że w agy oraz claude mamy dostęp do pełnego przekroju modeli, możemy zaprojektować optymalną architekturę kosztowo-wydajnościową:

• Orchestrator (Kapitan): Gemini 4 Argon (High) (agy --model gemini-4-argon-high) lub Claude Opus 5.5 (High) (agy --model claude-opus-5-5-high / claude --model opus) - odpowiada za architekturę, podział zadań, weryfikację diffów i syntezę wyników.
• Worker 1 (Szybkie R&D i eksploracja): Gemini 3.8 Flash (High) (agy --model gemini-3.8-flash-high) - błyskawicznie przeszukuje repozytorium i analizuje schematy.
• Worker 2 (Implementacja UI / Fullstack): Claude Sonnet 5.5 (claude --model sonnet) - pisze i refaktoryzuje komponenty React/Next.js.
• Worker 3 (Audyt, testy, szybkie sprawdzenia): Claude Haiku 5.5 (claude --model haiku) - wykonuje tanie, kilkusekundowe zadania (koszt rzędu $0.01 za sesję).

W trzeciej części serii uruchomimy tę flotę w praktyce na żywym projekcie Next.js + Sanity i zobaczymy, jak Orchestrator rozdziela pracę pomiędzy 4 panele.