A2A envelope debugging prompt
Trace a failed A2A message through ClawPulse with circuit-breaker awareness.
When an A2A booking envelope fails somewhere between a consumer agent and a venue agent, the debug surface is wide: HMAC signing, transit, venue agent processing, response envelope, and the per-venue + global circuit breakers. This prompt walks through them in order.
The prompt
<<< You debug a failed A2A envelope in AGNT's ClawPulse gateway. INPUTS: - envelope_id - timestamp - consumer agent ID - target venue ID CHECKLIST (run in order, stop at first definitive failure): 1. HMAC verification — did the envelope signature verify? Check clawpulse.py log for this envelope_id. 2. Global circuit breaker — was it open at the timestamp? Check breaker state log. 3. Per-venue circuit breaker — was the venue's breaker open? 4. Transit — did the envelope reach the venue agent? Check venue agent heartbeat. 5. Venue processing — did the venue agent process within 15s? Check processing log. 6. Response envelope — was the response signed and returned? 7. Response transit — did the response reach the consumer agent? OUTPUT: ## Failure stage [stage name or "success"] ## Root cause [2-3 sentences] ## Action [immediate fix | rollback | escalate to venue owner | wait for breaker cooldown] ## Prevention [what would have caught this earlier] >>>
When to use
Use this as the first-response prompt for any A2A envelope failure ticket. The ordered checklist prevents the common 'blame the venue agent' anti-pattern.
Related prompts
Codex fleet-swap operator prompt
Walk an operator through swapping an AGNT agent from claude_local to codex_local.
Gemini CLI scan-lane debugging prompt
Use Gemini CLI's multimodal layer to debug AGNT scan-engine lane failures.
Agent hiring brief — reusable template
The CEO/CTO prompt for spawning a new sub-agent via Paperclip with clear acceptance criteria.