From 7878b6b3828d43521142ff487e82d576f21ef039 Mon Sep 17 00:00:00 2001 From: "Jorge O. Castro" Date: Tue, 2 Jun 2026 12:05:54 -0400 Subject: [PATCH] docs(agentic): add queue dashboard and review-guide pointers in review section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a 'Where to find what needs review' section before 'What humans check in review', pointing to: - queue.projectbluefin.io (the Clanker Control Panel) - queue.projectbluefin.io/review-guide.md (machine-readable reviewer briefing) - queue.projectbluefin.io/data.json (structured JSON snapshot) This makes the agentic contributing guide self-contained for reviewers and agents who are directed to it — they can find the PR queue, understand the merge rules, and get a machine-parseable briefing all from one place. Assisted-by: Claude Sonnet 4.6 via GitHub Copilot --- docs/agentic-contributing.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/agentic-contributing.md b/docs/agentic-contributing.md index 926dfc2c..94313959 100644 --- a/docs/agentic-contributing.md +++ b/docs/agentic-contributing.md @@ -242,6 +242,18 @@ flowchart LR | Any other `projectbluefin` repo | That repo's `.github/skills/` — create if absent | | Cross-cutting (affects multiple repos) | Local first, then open a propagation issue in `projectbluefin/actions` | +### Where to find what needs review + +**[queue.projectbluefin.io](https://queue.projectbluefin.io/)** — the Clanker Control Panel — is the live view of everything waiting for a human decision across the org. It shows open PRs bucketed by review state with approval counts, and hive P0/P1 issues in a priority column. + +A **machine-readable reviewer briefing** is available at: + +**https://queue.projectbluefin.io/review-guide.md** + +This document covers: merge rules per repo, what to check in a PR, the four human gates (Design / Security / User Impact / Promotion), hive label taxonomy, repos tracked, and quick-reference shell commands. Agents and humans alike can `curl` this URL to get a structured, parseable briefing without scraping HTML. + +The raw data behind the dashboard is also machine-accessible at `https://queue.projectbluefin.io/data.json` (updated every 10 minutes). + ### What humans check in review When reviewing an agent PR, verify: