Trace Debugging Playbooks
Operational playbooks for explaining failed, incomplete, late, orphaned, and integration-specific workflows without fabricating root cause or evidence.
Use when a trace has started work but required child spans or async jobs have not reached a terminal state.
platphormctl trace incompleteUse when one or more spans failed, timed out, or were cancelled and the workflow needs a deterministic handoff.
platphormctl trace failedUse when a span arrives after deadline or after a trace already moved to a terminal state.
platphormctl trace spans <traceId>Use when a span references a parent that Trace has not received.
platphormctl trace spans <traceId>Use when a span claims work happened but has no public-safe artifact, result reference, or redacted summary.
platphormctl trace get <traceId>Use when services appear as separate traces or child spans are missing because trace context was not forwarded.
platphormctl trace propagate --service agentuiUse when an MCP initialize, tools/list, tools/call, resources/read, or prompts/get workflow fails.
platphormctl mcp validate traceUse when a browser journey span fails or screenshot/accessibility evidence is missing.
platphormctl harness run trace-propagation-check --dry-runUse when an Evals suite, rubric, assertion, or release gate emits a failed scorecard span.
platphormctl trace report <traceId>Use when a sandbox command, replay, or dry-run span times out.
platphormctl trace spans <traceId>Use when a webhook event, attempt, replay, or delivery span fails.
platphormctl trace get <traceId>Use when Spec validation, conformance, diff, generation, or release-gate spans fail.
platphormctl site inspect traceUse when an AgentUI workflow node, save/export/share/delegate, or dry-run/run span stalls.
platphormctl trace propagate --service agentuiUse when Claws planning, dry-run, delegation, or toolchain evidence enters degraded state.
platphormctl trace report <traceId>Use when Monitor health or provider sync spans are stale or unavailable.
platphormctl site inspect trace --best-effortUse when Docs source fetch, parse, scoring, publishing, or report spans fail.
platphormctl trace report <traceId>Use when Sheets import, schema, quality, report, or matrix spans fail.
platphormctl trace report <traceId>Use when Vercel JA4 digest correlation is expected but missing or unsafe.
platphormctl policy inspect trace