Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced review-loop workflow with strong validation checkpoints, weakened only by verbose justifications that pad the body and a monolithic single-file structure that keeps detail inline rather than offloaded to references.
Suggestions
Tighten the prose justifications in steps 1, 6, and 7 to one line each — keep the gotcha, drop the elaboration — to lift conciseness toward 3.
Consider moving the detailed command pitfalls (paging logic, `--reverse`, `--force-with-lease` rules) into a references/GOTCHAS.md and signaling it from the body to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with copy-paste commands, but the multi-paragraph justifications in steps 1, 6, and 7 (e.g. the `[.comments[]] | last | .body` vs `tail -1` aside and the `--reverse` rationale) could be tightened without losing the gotcha; not level 1 because it avoids generic concept explanations Claude already knows, and not level 3 because several passages are padded. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready `gh` CLI and GraphQL snippets for every operation (state check, replies, resolve, re-trigger), matching the anchor for executable code and specific examples. | 3 / 3 |
Workflow Clarity | A clearly sequenced 10-step loop with explicit validation checkpoints (mergeable check before action, full /ship sync check before every push, post-push commit-list verify) and feedback loops (fix → reply → resolve → re-review), matching the clear-sequence-with-validation anchor for risky force-push/rebase operations. | 3 / 3 |
Progressive Disclosure | Well organized into named sections but monolithic — all content (including long gotcha explanations) is inline in one file with no bundle references to split detail into, so it stops at 'some structure, content that should be separate is inline' rather than the one-level-deep reference pattern of level 3. | 2 / 3 |
Total | 10 / 12 Passed |