ENGINEERING

Stale Flag to Linear Tech-Debt Ticket

Scans GitHub for feature-flag definitions older than a threshold whose flag-service config shows a settled state, then files one Linear ticket per stale flag with owner, age…

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerschedule
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerWeekly schedule starts run
  • ActionScan repo for flag definitions, ages, and refsGitHubGitHub
  • ActionFetch flag state and last-changed from PostgresPostgreSQLPostgres
  • LogicKeep only old, settled, still-referenced flags
  • OutputCreate tech-debt ticket per stale flagLinearLinear

What it does

Turns lingering feature flags into tracked work instead of silent debt. It pairs flag definitions found in code with their live state from your flag service and creates a Linear issue for each flag that has clearly outlived its experiment.

When to use it

Use it weekly when you want flag cleanup to show up in sprint planning rather than relying on memory. Good fit for teams that already triage tech debt in Linear.

How it works

  1. 1A weekly schedule starts the run.
  2. 2Scan the GitHub repo for flag definitions and capture each flag's creation date from git blame and its reference count.
  3. 3Fetch each flag's current state and last-changed timestamp from the flag-config Postgres store.
  4. 4A logic step keeps only flags that are old, fully settled, and still referenced in code.
  5. 5Resolve the likely owner from the file's most frequent committer.
  6. 6Create a Linear ticket per stale flag tagged tech-debt, with age, owner, and call-site count in the description.

Set it up

What you configure once, before turning it on.

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