The most expensive webhook bug I know is boring. Your order handler receives order.paid , stores the event, creates the fulfillment, sends the confirmation email, and then takes a little too long to answer. WooCommerce times out and posts the same event again. Your handler sees a new delivery id, decides this is a new event, and ships the order twice.
A coding agent asked to "make the webhook idempotent" will often write exactly the wrong fix: store X-WC-Webhook-Delivery-ID and skip repeats. That header is a fresh log id for every attempt, so the fix does nothing for this case.
That gap, between what a capable generalist writes and what someone who has debugged a store at 2 a.m. writes, is what I tried to close with commerce-agent-skills .…