braintrust-tracing

Braintrust tracing for Claude Code - hook architecture, sub-agent correlation, debugging

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.