Delivery governance · GitHub-native · MIT

Ship with structure.
Stay on GitHub.

The GitHub Delivery Operating System (Delivery OS) is a framework for structured sprints, QA coordination, and collaborative production gates—embedded as workflows and templates inside your repository. No external orchestration SaaS required.

npm: github-delivery-os Direct-copy workflows Dual approval Optional Telegram

Why this exists

Teams often coordinate delivery informally in GitHub—manual approvals, uneven sprint tracking, and ad hoc production sign-off. As you scale, that creates ambiguity, QA bottlenecks, and release risk.

Delivery OS gives you repeatable intake, sprint orchestration, QA governance, and release gates—without replacing your CI/CD pipelines or how developers work day to day.

  • Delivery ambiguity across teams
  • QA bottlenecks and unclear ownership
  • Informal production approvals
  • Cross-repo inconsistency

Install in one command

From your repository root, install workflows and issue templates into the current repo:

Terminal
npx github-delivery-os install --with-templates .

Add --with-labels to create labels with the gh CLI. Use --dry-run to preview. Existing files are skipped by default; use --overwrite when updating.

Also available: status, uninstall — see the repo README.

What gets installed

Workflows and templates are copied into your repo. There is no workflow_call to a private host—everything runs as native Actions in your project.

Workflow Purpose
sprint-child-creatorChild issues from sprint planning (SPRINT - title)
auto-close-sprintBurn-down, sprint health, auto-close at 100%
notify-release-approverPing approver when a production release issue opens
authorize-deploymentDual approval (release + QA) → ready-for-deploy
auto-assign-qaAssign QA on qa / qa-request
telegram-issuesOptional Telegram alerts
setup-labelsOne-time label creation via Actions

After install

  1. Run Setup Labels from the Actions tab (or use --with-labels).
  2. Set repository variables: RELEASE_APPROVER, QA_APPROVER, QA_ASSIGNEES (comma-separated).
  3. Optionally add TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID for notifications.

Use the Sprint Planning template with a title like SPRINT - Sprint 12; list one feature per line under Sprint Features. Child issues link with Parent Sprint: #N.

Documentation & links