| name | triage-scoreboard |
| description | Compute and render the living, ranked triage board of open work — mechanical + judgment dimensions into a composite rank, with evidence-readiness tags. Run on a schedule so the board is always current. |
triage-scoreboard
When to load: generating or refreshing the triage scoreboard.
Band A (read-only, deterministic where possible). Ideal as a scheduled job.
Steps
- Pull live metadata for every open item (PRs/issues): CI status, mergeable/behind, size, age,
author. Read repos from
config.yaml.
- Recompute mechanical dimensions fresh each run (disposable): CI, conflict state, behind-count,
size bucket, contributor trust score (computed by
contributor-trust
from the trust ledger).
- Merge in persisted judgment dimensions (scope_fit, criticality, risk, severity) from the
prior board — these survive regeneration so human/agent assessments aren't lost.
- Compute the composite = weighted sum of dimensions (weights from config; tune to match "what
I'd pick up next"). Promote genuinely-breaking items to a severity spotlight at the top.
- Tag evidence-readiness per item: which review streams have landed (automated review present?
visual preview? deep-review dossier?). Compact ✓/· marker. Presence ≠ clean.
- Render the living board sorted by composite + a curated "review these first" short-list.
Persist the computed data as a machine-readable artifact for other jobs.
- Commit following scheduled-job rules
(idempotent, silent-on-no-op).
Pitfalls
- Keep mechanical and judgment dims in separate storage — mechanical is re-derived and
disposable; judgment is precious and persisted. Don't let a refresh wipe a human's assessment.
- Evidence presence is not a verdict —
✓ means the evidence exists to review, not that it's
clean. The authoritative gate still runs at merge.
- Re-run cheaply — this should be incremental and idempotent; it's a read-only ranking, not an
action.
Verification
- Board re-renders with current data; judgment dims preserved across runs.
- Composite ordering matches intuition for the top handful.
- Evidence tags reflect actual review-stream presence.
