Public-safe

Trace Debugging Playbooks

Operational playbooks for explaining failed, incomplete, late, orphaned, and integration-specific workflows without fabricating root cause or evidence.

Playbooksok
18
Source: deterministic playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
Incomplete Traces
Trace completion

Use when a trace has started work but required child spans or async jobs have not reached a terminal state.

First command: platphormctl trace incomplete
Open playbook
Failed Spans
MCP

Use when one or more spans failed, timed out, or were cancelled and the workflow needs a deterministic handoff.

First command: platphormctl trace failed
Open playbook
Late Spans
Sandbox

Use when a span arrives after deadline or after a trace already moved to a terminal state.

First command: platphormctl trace spans <traceId>
Open playbook
Orphan Spans
Trace

Use when a span references a parent that Trace has not received.

First command: platphormctl trace spans <traceId>
Open playbook
Missing Evidence
Docs

Use when a span claims work happened but has no public-safe artifact, result reference, or redacted summary.

First command: platphormctl trace get <traceId>
Open playbook
Missing Traceparent Propagation
Trace

Use when services appear as separate traces or child spans are missing because trace context was not forwarded.

First command: platphormctl trace propagate --service agentui
Open playbook
Broken MCP Tool Call
MCP

Use when an MCP initialize, tools/list, tools/call, resources/read, or prompts/get workflow fails.

First command: platphormctl mcp validate trace
Open playbook
BrowserOps Failed Journey
BrowserOps

Use when a browser journey span fails or screenshot/accessibility evidence is missing.

First command: platphormctl harness run trace-propagation-check --dry-run
Open playbook
Evals Failed Scorecard
Evals

Use when an Evals suite, rubric, assertion, or release gate emits a failed scorecard span.

First command: platphormctl trace report <traceId>
Open playbook
Sandbox Timeout
Sandbox

Use when a sandbox command, replay, or dry-run span times out.

First command: platphormctl trace spans <traceId>
Open playbook
Webhook Delivery Failure
WebhookLab

Use when a webhook event, attempt, replay, or delivery span fails.

First command: platphormctl trace get <traceId>
Open playbook
Spec Contract Mismatch
Spec

Use when Spec validation, conformance, diff, generation, or release-gate spans fail.

First command: platphormctl site inspect trace
Open playbook
AgentUI Workflow Stall
AgentUI

Use when an AgentUI workflow node, save/export/share/delegate, or dry-run/run span stalls.

First command: platphormctl trace propagate --service agentui
Open playbook
Claws Toolchain Degraded
Claws

Use when Claws planning, dry-run, delegation, or toolchain evidence enters degraded state.

First command: platphormctl trace report <traceId>
Open playbook
Monitor Stale Health
Monitor

Use when Monitor health or provider sync spans are stale or unavailable.

First command: platphormctl site inspect trace --best-effort
Open playbook
Docs Ingestion Failure
Docs

Use when Docs source fetch, parse, scoring, publishing, or report spans fail.

First command: platphormctl trace report <traceId>
Open playbook
Sheets Import Failure
Sheets

Use when Sheets import, schema, quality, report, or matrix spans fail.

First command: platphormctl trace report <traceId>
Open playbook
JA4 Digest Correlation Issue
Fingerprint

Use when Vercel JA4 digest correlation is expected but missing or unsafe.

First command: platphormctl policy inspect trace
Open playbook