Skip to content
Latchkey

What Is the .github/workflows directory?

the .github/workflows directory explained, including what it does and how it matters in CI/CD.

The .github/workflows directory is where GitHub Actions looks for workflow YAML files in a repository.

What it is

Each .yml file there defines a workflow with its triggers, jobs, and steps. GitHub automatically discovers and runs them on matching events.

Why it matters in CI/CD

This directory IS your CI configuration in GitHub Actions. Adding a file here is all it takes to create a pipeline; the workflows are version-controlled with your code (pipeline as code).

Key takeaways

  • .github/workflows holds GitHub Actions workflows.
  • Each YAML file is one workflow.
  • It is your pipeline-as-code config.

Related guides

Tired of flaky CI? Latchkey auto-heals failed jobs and retries them for you. Start free →