braintrust-tracing

Umożliwia śledzenie sesji Claude Code w platformie Braintrust z pełnym wglądem w architekturę haków, korelację podagentów i debugowanie. Narzędzie mapuje przepływ zdarzeń od startu sesji, przez interakcje użytkownika, aż do wywołań narzędzi i spawnu podagentów. Dzięki strukturze root span i unikalnym identyfikatorom sesji możesz łatwo śledzić hierarchię agentów, identyfikować problemy w logice i optymalizować przepływ danych między komponentami. Idealne dla deweloperów pracujących z wieloagentowymi systemami opartymi na Claude Code.

1. Zainstaluj umiejętność w swoim projekcie Claude Code, umieszczając pliki z repozytorium parcadei w katalogu .claude/skills/braintrust-tracing.

2. Skonfiguruj połączenie z Braintrust – upewnij się, że masz aktywne konto i klucz API do platformy Braintrust, którą będziesz używać do zbierania śladów.

3. Zainicjuj sesję Claude Code – gdy uruchomisz sesję, hook SessionStart automatycznie utworzy root span i zarejestruje początek śledzenia w Braintrust.

4. Obserwuj przepływ zdarzeń – podczas interakcji z użytkownikiem i wywołań narzędzi hooki UserPromptSubmit, PreToolUse i PostToolUse będą automatycznie rejestrować zdarzenia, tworząc szczegółowy ślad wykonania.

5. Śledź podagentów – gdy Claude Code spawni podagenta, hook SubagentStop przechwyta jego sesję i automatycznie skoreluje ją z sesją nadrzędną za pomocą unikalnych identyfikatorów span, umożliwiając pełny wgląd w hierarchię agentów.

6. Analizuj ślady w Braintrust – przejdź do pulpitu Braintrust, aby zobaczyć kompletny graf wykonania, zidentyfikować wąskie gardła, debugować błędy i optymalizować interakcje między agentami.