Content
88%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 content is an exemplary operational runbook: every step is executable with exact commands and templates, validation and approval checkpoints guard the batch posting and state-change operations, and failure modes are handled explicitly down to note-field consistency. Its only weaknesses are mild verbosity in the worked example and no use of external reference files despite the length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, purposeful content — exact bash commands, comment templates, and an edge-case table — with almost no explanation of concepts Claude already knows. It falls short of anchor 5 because the full two-ticket worked example in Step 4 and the repeated return-to-Todo post block in Step 5 could be tightened. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: exact date/note-path bash, `linear issue view <TICKET-ID> -j --no-comments --no-pager`, `--body-file` posting with heredocs, `--state unstarted` with a note on name-vs-type, exact note-edit strings, and concrete credential/sandbox retry handling. Specific examples cover the common cases including empty logs and failure paths. | 5 / 5 |
Workflow Clarity | Steps 1–6 are clearly sequenced with explicit validation checkpoints for a batch operation: Linear state verification before any revert, an AskUserQuestion approval gate before posting, per-item error recovery (comment posts but state change fails → keep `status::` matching reality), and a keyring-error retry loop. This matches the anchor with feedback loops and error-recovery checklists; the batch-operation cap does not apply since validation is thorough. | 5 / 5 |
Progressive Disclosure | The single file is well-organized into sequenced step sections plus an Edge Cases table with no nested or buried references, and no bundle files exist to misroute. It falls short of anchor 5 because at ~235 lines everything is inline — the long worked example in Step 4 and the edge-case table are candidates for a separate reference file — and it does not meet the under-50-line simple-skill exception. | 4 / 5 |
Total | 18 / 20 Passed |