PROJECT MANAGEMENT

GitHub PR throughput vs planned velocity reconciler

Weekly job that compares merged-PR delivery throughput from GitHub against the points a team committed in Linear.

CategoryProject Management
Enginesim
Difficultyadvanced
Triggerschedule
Steps5
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerWeekly schedule
  • ActionFetch merged PRs per teamGitHubGitHub
  • ActionPull committed and completed cycle pointsLinearLinear
  • LogicCompute throughput vs plan divergence
  • OutputPost estimation-health digest to SlackSlack

What it does

This workflow cross-checks two signals that should agree: planned story points and actual code shipped. Each week it pulls merged-PR counts and sizes per team from GitHub and the points committed and completed for the matching Linear cycle. It computes the divergence between planned velocity and real throughput, surfacing teams whose estimates are systematically inflated or deflated. The findings land in a Slack digest so estimation drift gets corrected.

When to use it

Use it when you suspect story-point estimates have drifted from reality and your velocity model is being fed bad inputs. Reconciling against shipped PRs keeps the forecaster honest.

How it works

  1. 1A weekly schedule triggers the reconciliation.
  2. 2The flow fetches merged PRs per team for the period from GitHub.
  3. 3It pulls committed and completed points for the matching Linear cycle.
  4. 4A logic step computes points-per-merged-PR divergence against the team baseline.
  5. 5Teams exceeding the drift threshold are compiled into a Slack estimation-health digest.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect LinearIssues, projects, cycles, triage.
  3. 3
    Connect SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.