You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Track blockers with native issue dependencies instead of the blocker-line guard #5051
The blocker-line guard (~8.4k lines, mostly Go, 24 commits in 60 days) parses **Blocker:** lines in issue bodies and cross-checks the blocked label. GitHub issue dependencies already express this, and the guides use them in places, so both systems run side by side.
What
Record blockers that are issues as native dependencies (issue dependencies), readable with gh issue view --json blockedBy. Keep a tiny check only for blockers that are not issues and for parked PRs, or file an issue for those blockers so they become dependencies too.
What is lost
Nothing, if the small residual check stays.
First step
Count open blocker lines that name an issue, convert them, and shrink the guard to the remainder.
Design for the full rewrite (maintainer chose it in an interactive session on 2026-11-14).
Census today: 40 open blocked issues. 8 name an in-org issue, 8 an external issue, and about 25 are authority, outcome or prose blockers. 22 open PRs carry blocked. 13 issues already have native blockers, including one across owners, so cross-owner links work.
New model: every blocker is an issue.
Blocked issue = the blocked label plus at least one open native blocked by issue. The issue's state is the verification. No **Blocker:** line, no last-verified dates.
Upstream issue: link it directly, in any repository.
Authority: link the open maintainer-ask issue. Closing the ask unblocks.
Outcome or event (a release, the next deploy): file a small "Wait for: …" issue in the same repository and link it. Whoever sees the event close it.
Parked PR = the blocked label plus one comment by the maintainer account whose first line is the disclosure and which carries Blocked by <owner/repo#N>, naming an issue as above. PRs cannot take native dependencies, so this one line stays. It is edited in place, never posted twice.
Residual checkblocked-check.sh --org devantler-tech: bash and GraphQL, read-only, about 150 lines. Rows:
STRANDED: labelled, but no open blocker. Work it or remove the label.
MISSING: labelled, but no blocker recorded at all.
UNLABELLED: has an open native blocker but no label.
Dropped: the UNRECORDED row for stale unstarted Security issues. It is not a blocker check. The advisory sweep and rung 2 of the ladder still cover security work.
Migration: one pass converts every open blocked issue and parked PR. It creates the "Wait for" issues and native links, rewrites each PR record to the one-line form, and removes the old **Blocker:** lines only after the link reads back. Then the guides (work selection, merge policy and its sensors, the run skill) are rewritten to the new model in the same PR.
Implementation follows in one draft PR. The maintainer approves before it is marked ready, because it changes live lane behaviour.
Activity
devantler commentedon Nov 14, 2026
Design for the full rewrite (maintainer chose it in an interactive session on 2026-11-14).
Census today: 40 open blocked issues. 8 name an in-org issue, 8 an external issue, and about 25 are
authority,outcomeor prose blockers. 22 open PRs carryblocked. 13 issues already have native blockers, including one across owners, so cross-owner links work.New model: every blocker is an issue.
Blocked issue = the
blockedlabel plus at least one open native blocked by issue. The issue's state is the verification. No**Blocker:**line, no last-verified dates.maintainer-askissue. Closing the ask unblocks.Parked PR = the
blockedlabel plus one comment by the maintainer account whose first line is the disclosure and which carriesBlocked by <owner/repo#N>, naming an issue as above. PRs cannot take native dependencies, so this one line stays. It is edited in place, never posted twice.Residual check
blocked-check.sh --org devantler-tech: bash and GraphQL, read-only, about 150 lines. Rows:STRANDED: labelled, but no open blocker. Work it or remove the label.MISSING: labelled, but no blocker recorded at all.UNLABELLED: has an open native blocker but no label.PARKED: settled.Exit codes are 0, 1 and 2 as usual.
Removed: the Go guard (park, unpark, compose, parked digest, stale and ask checks) and its CI job. The ETag-conditional reader that
lane-draft-count.shborrows moves to a smallforge-read-gomodule unchanged, so the request budget saving from Agent runs exhaust the shared GitHub request budget and make product release steps fail #4055 stays.Dropped: the
UNRECORDEDrow for stale unstarted Security issues. It is not a blocker check. The advisory sweep and rung 2 of the ladder still cover security work.Migration: one pass converts every open blocked issue and parked PR. It creates the "Wait for" issues and native links, rewrites each PR record to the one-line form, and removes the old
**Blocker:**lines only after the link reads back. Then the guides (work selection, merge policy and its sensors, the run skill) are rewritten to the new model in the same PR.Implementation follows in one draft PR. The maintainer approves before it is marked ready, because it changes live lane behaviour.
🤖 Generated with Claude Code