Content
80%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is executable and well-structured, with a genuinely instructive rubric and concrete gh commands. The main weakness is the batch backfill pass, which applies labels across many issues with no validation or error handling, capping workflow clarity.
Suggestions
Add a verification step to Mode B: after the pass, re-run the jq-filtered 'gh issue list' and report any issues still unrated, and confirm the six labels exist (e.g. 'gh label list') before batch-applying.
Specify error handling for the batch pass — what to do when a label is missing from the repo or a 'gh issue edit' call fails mid-listing.
Fix the duplicated repository in 'The labels' section — 'englishstreetventures/englishstreetventures.com' is named twice where two distinct repos appear to be intended.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient: the body avoids explaining concepts Claude already knows, and the timing rationale carries genuinely non-obvious domain rules. A few rhetorical passages ('the number gets talked into agreeing with the spend, and the metric quietly starts confirming whatever already happened') could be trimmed, holding it at 4 rather than 5; it stays above 3 because padding is minor and localized. | 4 / 5 |
Actionability | Copy-paste-ready commands for both modes ('gh issue edit … --add-label "complexity:3"'), a concrete jq-filtered listing for the backfill pass, an explicit Fibonacci rubric table, and exact label names. Specific examples cover the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | Mode A is clearly sequenced with an owner-confirmation checkpoint and an unattended-run fallback, but Mode B is a batch operation — one pass applying labels to up to 200 issues — with no verification step (no check that the six labels exist, no post-apply confirmation, no error handling). Per the batch-operation cap, workflow clarity cannot exceed 3; it is above 2 because both modes' sequences are otherwise well defined. | 3 / 5 |
Progressive Disclosure | A single self-contained file with clear sections, a small inline rubric table and label table that belong inline at this size, and well-signaled one-level-deep external pointers ('wiki/conventions/session-metrics.md', '@tools/pr-metrics'). No bundle files are needed and navigation is easy, matching the 5 anchor. | 5 / 5 |
Total | 17 / 20 Passed |