sequenceDiagram
  autonumber
  actor Dev as Push/PR
  participant Build as Job: build
  participant Test as Job: test (matrix)
  participant AddTests as Job: additional-tests
  participant Clean as Job: clean
  participant Art as Artifacts

  Dev->>Build: Trigger workflow
  rect rgba(230,240,255,0.5)
    Build-->>Art: Upload build artifacts
  end

  Build-->>Test: needs: build
  par Matrix runs
    Test->>Test: setup per-matrix env (sdk/framework)
    alt matrix.coverage == true
      Test->>Test: dotnet test --collect:"XPlat Code Coverage" (with flags)
    else
      Test->>Test: dotnet test (with --no-build if set)
    end
  end

  Build-->>AddTests: needs: build
  rect rgba(240,255,230,0.5)
    AddTests->>AddTests: actions/setup-dotnet (matrix.sdk)
    AddTests-->>Art: download artifacts
    AddTests->>AddTests: run additional test steps
  end

  AddTests-->>Clean: needs: additional-tests
  rect rgba(255,240,230,0.5)
    Clean-->>Art: delete artifacts
  end