Tracing сессий и под-агентов в Braintrust

engineering

braintrust-tracing — это скилл для Claude Code, который описывает архитектуру трейсинга сессий в Braintrust: иерархию spans, хук-события и корреляцию под-агентов. Скилл охватывает семь типов хуков (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SubagentStop, SessionEnd), каждый из которых создаёт или дополняет spans в иерархии Session → Turn → LLM/Tool. Отдельно разобрана проблема «осиротевших» трейсов под-агентов: контекст, внедрённый через PreToolUse, не достигает SessionStart суб-агента, поэтому корреляция строится через SubagentStop и совпадение session_id с root_span_id дочернего трейса. Для отладки предусмотрены команды tail на braintrust_hook.log, чтение JSON-файлов состояния из ~/.claude/state/braintrust_sessions/ и скрипты braintrust_analyze.py для анализа и воспроизведения сессий.