From 38ee104a875e0e816bf1fe45e247a15d3a81b142 Mon Sep 17 00:00:00 2001 From: Zachary Vorhies <[EMAIL]> Date: Tue, 27 Oct 2026 02:27:12 -0700 Subject: [PATCH] docs(coordinator): link a blocked issue's blockers as dependencies Triage re-listed obs-studio#1865 on every tick because its blockers were named in prose (#1864, #1092) and nothing read them: five triage comments in four days, each repeating the same verdict. The work list already hides an issue with an open blocker (issueDependenciesSummary.blockedBy), so the fix is the link, not another comment. Records the command, the id-vs-number trap, and the churn it prevents. --- .claude/skills/obs-org-coordinator/SKILL.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/.claude/skills/obs-org-coordinator/SKILL.md b/.claude/skills/obs-org-coordinator/SKILL.md index b96a8dc..9367892 100644 --- a/.claude/skills/obs-org-coordinator/SKILL.md +++ b/.claude/skills/obs-org-coordinator/SKILL.md @@ -161,6 +161,15 @@ Check the issue against the [definition of Ready](../../../WORKFLOW.md#definitio the issue out of triage; where the bot runs, the extra add is harmless. Split an XL into sub-issues. - **Underdefined:** comment what is missing and `/investigate`. +- **Blocked by other issues, named in prose:** link them as GitHub issue + dependencies in the same tick, before the verdict comment: + `gh api -X POST repos/obs-rust//issues//dependencies/blocked_by -F issue_id=` + (the numeric `id` from `gh api repos/obs-rust//issues/ --jq .id`, + not the issue number). `issueDependenciesSummary.blockedBy` is what the + work list reads: with one open blocker the issue leaves `triage` and comes + back by itself when the last blocker closes. Without the link a blocked + issue re-lists every tick and each tick re-posts the same triage comment — + obs-studio#1865 carried five of them in four days. - **Not a task** (an idea, a question): move it to Discussions and close it. - **Already fixed or a duplicate:** close it with the link. - **A tracker:** add its children as sub-issues; it leaves triage. A tracker