PROJECT MANAGEMENT

Scope-Change Justification Gate for Linear Epics

When acceptance criteria are added to a locked Linear epic, requires a justification comment within a window; if none appears, reopens the scope question by re-labeling the epic…

CategoryProject Management
Enginesim
Difficultyadvanced
Triggerwebhook
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerLinear issue updated webhookLinearLinear
  • LogicFilter locked epics with changed description
  • ActionDiff baseline vs current criteriaPostgreSQLPostgres
  • LogicCheck comments for matching justificationLinearLinear
  • ActionApply needs-scope-review labelLinearLinear
  • OutputNotify lead in SlackSlack

What it does

This workflow enforces a lightweight governance rule: any scope added to a committed epic must be explained. When new acceptance criteria are detected, it checks whether a justification comment was left referencing the change. If the criteria grew but no rationale was recorded, it flags the epic with a needs-scope-review label and pings the lead, turning silent additions into an explicit decision.

When to use it

Use it on teams that allow mid-sprint scope changes but want every one of them to be deliberate and documented. It is ideal where unexplained requirement growth has historically wrecked commitments.

How it works

  1. 1A Linear webhook fires on an issue update.
  2. 2A filter passes locked epics whose description changed.
  3. 3The baseline from Postgres is diffed against current criteria to confirm real additions.
  4. 4A branch checks recent comments for a justification matching the added scope.
  5. 5If a justification exists, the workflow records it and exits quietly.
  6. 6If none exists, a needs-scope-review label is applied in Linear and the lead is notified in Slack.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect LinearIssues, projects, cycles, triage.
  2. 2
    Connect PostgresAny Postgres URL — query, write, migrate.
  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.