Project Flow Ops

SkillProductivity

Project Flow Ops is a skill that guides an AI agent through triaging GitHub issues and pull requests and coordinating them with Linear. It classifies each item as merge, port/rebuild, close, or park based on diffs, reviews, and CI status, then decides whether the work warrants creating or updating a Linear task. GitHub stays the public record while Linear remains the internal execution layer.

Available today. Use it from your connected AI after setup.

1. Have access to the GitHub issues and pull requests you want triaged, plus a Linear workspace for internal tracking.

Then ask your AI: use the Project Flow Ops skill

What your AI can do with it

  • Triage open PR and issue backlogs on GitHub
  • Classify PRs into merge, port/rebuild, close, or park using diffs, reviews, and CI status
  • Decide which active work warrants creating or updating a Linear task
  • Link active GitHub work to internal execution lanes in Linear
  • Audit whether review comments, CI failures, or stale issues are blocking execution
  • Return a structured report with public status, classification, Linear action, and next ope

Getting started

  1. 1. Have access to the GitHub issues and pull requests you want triaged, plus a Linear workspace for internal tracking.
  2. 2. Add the project-flow-ops skill to the agent's available skills.
  3. 3. Ask the agent to triage a backlog, triage a specific PR, or coordinate GitHub work with Linear.
  4. 4. Review the structured output covering public status, classification, Linear action, and the recommended next step.

What this skill tells your AI

The instructions your AI receives, as published by affaan-m/ecc in skills/project-flow-ops/SKILL.md and read by ahel’s review.

This skill turns disconnected GitHub issues, PRs, and Linear tasks into one execution flow.

Use it when the problem is coordination, not coding.

When to Use

  • Triage open PR or issue backlogs
  • Decide what belongs in Linear vs what should remain GitHub-only
  • Link active GitHub work to internal execution lanes
  • Classify PRs into merge, port/rebuild, close, or park
  • Audit whether review comments, CI failures, or stale issues are blocking execution

Operating Model

  • GitHub is the public and community truth
  • Linear is the internal execution truth for active scheduled work
  • Not every GitHub issue needs a Linear issue
  • Create or update Linear only when the work is:
    • active
    • delegated
    • scheduled
    • cross-functional
    • important enough to track internally

Core Workflow

1. Read the public surface first

Gather:

  • GitHub issue or PR state
  • author and branch status
  • review comments
  • CI status
  • linked issues

2. Classify the work

Every item should end up in one of these states:

StateMeaning
Mergeself-contained, policy-compliant, ready
Port/Rebuilduseful idea, but should be manually re-landed inside ECC
Closewrong direction, stale, unsafe, or duplicated
Parkpotentially useful, but not scheduled now

3. Decide whether Linear is warranted

Create or update Linear only if:

  • execution is actively planned
  • multiple repos or workstreams are involved
  • the work needs internal ownership or sequencing
  • the issue is part of a larger program lane

Do not mirror everything mechanically.

4. Keep the two systems consistent

When work is active:

  • GitHub issue/PR should say what is happening publicly
  • Linear should track owner, priority, and execution lane internally

When work ships or is rejected:

  • post the public resolution back to GitHub
  • mark the Linear task accordingly

Review Rules

  • Never merge from title, summary, or trust alone; use the full diff
  • External-source features should be rebuilt inside ECC when they are valuable but not self-contained
  • CI red means classify and fix or block; do not pretend it is merge-ready
  • If the real blocker is product direction, say so instead of hiding behind tooling

Output Format

Return:

PUBLIC STATUS
- issue / PR state
- CI / review state

CLASSIFICATION
- merge / port-rebuild / close / park
- one-paragraph rationale

LINEAR ACTION
- create / update / no Linear item needed
- project / lane if applicable

NEXT OPERATOR ACTION
- exact next move

Good Use Cases

  • "Audit the open PR backlog and tell me what to merge vs rebuild"
  • "Map GitHub issues into our ECC 1.x and ECC 2.0 program lanes"
  • "Check whether this needs a Linear issue or should stay GitHub-only"

Signals

GitHub stars
268k
Forks
40k
Last commit
Sep 2026

Others that do the same job

Questions

Does every GitHub issue need a matching Linear task?
No. Linear items are created or updated only when work is active, delegated, scheduled, cross-functional, or important enough to track internally. The skill avoids mirroring everything mechanically.
How are pull requests classified?
Each PR ends up in one of four states: merge (self-contained and ready), port/rebuild (valuable but should be re-landed internally), close (stale, unsafe, or duplicated), or park (useful but not scheduled now).
Advanced
Item type
skill
Key
project-flow-ops
Source
github.com/affaan-m/ecc