Skip to content
AGNT
Prompt library
DebuggingOperations

A2A envelope debugging prompt

Trace a failed A2A message through ClawPulse with circuit-breaker awareness.

AGNT Infrastructureverified 2026-04-10Claude Sonnet 4.6

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

Take it further.

Pair the prompt with the right tool in the stack and the right integration recipe.