git:20260917.3d83f4c to git:20261005.042befb

---

name: messenger-retry-failures

description: Handle message failures with retry strategies, failure transport, and recovery in Symfony Messenger (Recoverable/Unrecoverable exceptions)

capabilities: [read, search, edit, shell]

tags: [messenger]

# projected by `bun run build` — do not edit by hand

allowed-tools:

- Read

- Glob

- Grep

- Write

- Edit

- Bash

---

# Messenger Retry Failures (Symfony)

## Use when

- Implementing asynchronous workflows with Messenger/Scheduler/Cache.

- Stabilizing retries and failure transports.

## Default workflow

1. Define async contract and delivery semantics.

2. Implement idempotent handlers and routing strategy.

3. Configure retries, failure transport, and observability.

4. Validate success/failure replay scenarios.

## Guardrails

- Assume at-least-once delivery, not exactly-once.

- Keep handlers deterministic and side-effect aware.

- Surface poison-message handling strategy.

## Progressive disclosure

- Use this file for execution posture and risk controls.

- Open references when deep implementation details are needed.

## Output contract

- Async config/handlers updated.

- Retry/failure policy decisions.

- Operational validation evidence.

## References

- `reference.md`