MosoFin-diagram › Recipes › Async roundtrip

Systems and engineering recipe · Sequence diagram

What happens after the initial request returns?

Draw it as a sequence diagram with the MosoFin-diagram "Async roundtrip" recipe. A sequence view of enqueue, acknowledgement, background work, callbacks, retries, timeout, and final consistency. Your coding agent returns one validated, self-contained HTML file.

When to use this diagram

Webhooks, jobs, queues, payment callbacks, eventual consistency, or async API contracts.

Pick another recipe when the primary question is topic topology and consumer ownership rather than time order.

What the diagram must include

Copy-ready prompt

Paste this into your coding agent with MosoFin-diagram installed. Recipe ID: async-roundtrip.

Use Mosofin sequence mode to explain this asynchronous roundtrip. Show the initial acknowledgement, enqueue or scheduling step, background processing, callback or polling, retry and timeout behavior, and the point where the caller can observe final consistency.

How to make it

  1. Install the skill. Add MosoFin-diagram to your coding agent. For Claude Code: npx -y skills add MosoFin/mosofin-diagram --skill mosofin --agent claude-code --global --copy --yes
  2. Describe the business once. Answer a short interview: what the business does, which entities are in scope, and which system of record owns each domain.
  3. Ask this question. Paste the Async roundtrip prompt from this page. The agent writes the diagram spec, validates it, and repairs anything the validator names.
  4. Open and share the diagram. Open the self-contained HTML file in any browser, walk the guided views, and forward it or export an image.

Verified example

Northline Coffee — One DTC Order to the Books (2026-07) is a real sequence diagram delivered by the skill and checked by its validator.

Northline Coffee — One DTC Order to the Books (2026-07): a sequence diagram made with MosoFin-diagram
Northline Coffee — One DTC Order to the Books (2026-07) · open the interactive diagram

Questions about this recipe

Which diagram type answers “What happens after the initial request returns?”

A sequence diagram. One order, invoice or payout traced in time across every system it touches. The Async roundtrip recipe sets it up for this question.

When should I use a different recipe?

Pick another recipe when the primary question is topic topology and consumer ownership rather than time order.

Does MosoFin-diagram connect to my systems or invent numbers?

No. It draws only what you state in the business brief or the conversation. It never calls QuickBooks, Stripe, Shopify, an ERP or a bank, and an amount you did not supply never appears.

Related recipes

Markdown version for AI agents: /recipes/async-roundtrip.md · Full agent guide: /llms-full.txt