| name | process-backlog |
| description | Internal crew primitive, dispatched by /crew:run — do not invoke directly or select it for a user request; route backlog/catch-up requests to /crew:run, which decides the full workflow. (Function: find and advance stalled issues/PRs or ledger tasks, bounded; never merges.) |
process-backlog
Internal crew primitive — dispatched by /crew:run. You are running because the
orchestrator selected this as one step of a larger workflow; carry out the work below. This
skill is not meant to be invoked on its own — user requests go to /crew:run.
You recover work that stalled (rate limits, timeouts, missed events). You find stuck items
and advance a bounded number of them, then stop. Your ceiling is a review-ready PR —
never merge.
0. Load config and mode
python3 "${CLAUDE_PLUGIN_ROOT}/lib/load_config.py"
Use labels.{bug,task,triaged,agent_pr}, ledger.dir, and orchestrator.max_items (the
per-run cap; default 5 if unset). Split the budget across the backlogs below.
Then read ${CLAUDE_PLUGIN_ROOT}/reference/work-model.md and resolve the mode before any
gh call. In github mode use steps 1–2; in local mode use step 1L.
1. (GitHub) Find triaged issues with no PR
gh issue list --state open --label "<labels.triaged>" --json number,title,labels
Keep those that also carry labels.bug or labels.task. For each, check there is no
linked PR (search PRs/branches for Fixes #N / crew/issue-N). These need implementation.
2. (GitHub) Find crew PRs with unaddressed reviews
gh pr list --state open --label "<labels.agent_pr>" --json number,reviewDecision,title
Keep those whose latest review state is CHANGES_REQUESTED (or that have unresolved review
comments). These need a review response.
1L. (Local) Scan the ledger for stalled tasks
Read every <ledger.dir>/*/task.md and group by status (skip terminal done and
needs_human):
new → needs triage (triage-bug/triage-task by kind).triaged → needs implementation (implement-issue).changes_requested → needs a review response (respond-to-review).implemented → needs review (review-pr).
3. Advance, up to the cap
Process at most orchestrator.max_items items total, one at a time, dispatching the
primitive each item's state calls for (above).
(If invoked from the orchestrator, dispatch each via Task; standalone, you may follow the
respective skill directly.)
4. Report
Summarize what you processed, what you skipped (and why), and anything you escalated with
labels.needs_human. Stop once the cap is hit even if items remain — say how many remain.
Constraints
- Bounded — never exceed
orchestrator.max_items per run.
- Never merge. Respect all
implement-issue / respond-to-review guardrails.
