accordant-async-operations Skill

Source

• Creator: microsoft
• Repository: microsoft/accordant
• Skill file: agent/skills/async-operations/SKILL.md

What it does

How to model background work, step functions, and polling - use this skill when testing async workflows, job queues, or operations that complete in the background

Skill instructions

Async Operations in Accordant Some operations don't complete when the API call returns. You call an endpoint, it returns "Pending," and background work finishes later. Accordant models this with step functions and handles testing with polling. The Pattern 1. API returns immediately (status: Pending) 2. Background work happens asynchronously 3. Later API calls observe the completed state PUT /api/jobs/job123 → { status: "Pending" } // ... background processing ... GET /api/jobs/job123 → { status: "Completed" } Modeling Background Work Use .Triggers() with AsyncOperation.Create: csharp [State] public partial class JobQueueState { public Dictionary<string, JobStatus Jobs { get; set; } = new(); } public enum JobStatus { Pending, Completed, Failed } spec.Operation<string, ApiResult<Job("CreateJob", (jobId, state) = { if (state.Jobs.ContainsKey(jobId)) return Expect.That<ApiResult<Job(r = r.IsConflict).SameState(); return Expect.That<ApiResult<Job(r = r.IsSuccess && r.Data.Status == JobStatu