ci-workflow-guide

Debug CI workflow failures by analyzing test dispatch, partitioning, and gating logic across stages. The guide provides debugging utilities and fast-fail mechanisms to surface root-cause failures while skipping cascading issues.

Fast-fail logic in CI orchestration surfaces root-cause failures immediately while skipping downstream cascading issues. Cross-stage health checks identify the originating failure point to reduce pipeline toil.

Add a new CI stage by duplicating an existing stage, wiring it into check-changes and wait-for-stage logic, and validating the pipeline with a test run to ensure correct sequencing and gating.

Tests are dispatched and partitioned across CI stages according to defined stage ordering and gating policies. The orchestration logic specifies execution modes for both PR and scheduled runs.

This guide applies to both PR and scheduled CI runs. It specifies stage ordering, gating policies, partitioning, and execution modes across different pipeline triggers for SGLang projects.

CI stages failing out of order often indicates issues with wait-for-stage wiring or gating logic. Diagnose the orchestration by checking stage sequencing and cross-stage health check configurations.