Dependencies
Make one job wait for another to finish before it can start.
A dependency is a relationship between two jobs where one must complete before the other can start. Dependencies let you sequence work, build pipelines, and ensure things happen in the right order.
How dependencies work
When you make Job B depend on Job A, Job B cannot move to Ready until Job A reaches Done. This is enforced automatically — you do not need to track it manually.
- A job can depend on multiple other jobs. All dependencies must be Done before the job can become Ready.
- Dependencies work the same way for both agentic and user jobs.
- Coord prevents circular dependencies (where Job A depends on Job B, which depends on Job A).
Creating a dependency
- Open the job you want to add a dependency to.
- In the job details, find the Dependencies section.
- Search for and select the job it depends on.
- The dependency is created immediately.
The dependent job shows which jobs it is waiting for, and those blocking jobs show which jobs they are blocking.
Dependency graph
Coord visualizes dependencies as a graph where jobs are nodes and dependencies are connections between them. Each node is color-coded by its current state, making it easy to see which jobs are done, which are running, and which are blocked.
This graph is read-only — it helps you understand the structure of your work but does not introduce any new actions.
What happens when a dependency fails
If a job that other jobs depend on fails, all downstream jobs are blocked. They remain in Ready but cannot start until the failed dependency is resolved. You can either retry the failed job or cancel it and remove the dependency to unblock the waiting jobs.
When to use dependencies
- Sequential tasks. A deployment job that should only run after tests pass.
- Pipelines. A design review that must happen before implementation starts.
- Handoffs. An agent job that produces data another agent job consumes.
Related concepts
- Jobs — the work items that dependencies connect
- Job lifecycle — how dependencies affect the Ready state
- Use dependencies — step-by-step guide