Content
92%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 an excellent operational reference: fully executable commands, non-interactive pitfalls, exit codes with recovery, and well-signaled progressive disclosure to real reference files. Its only weakness is minor trimmable detail (merge-queue semantics, JSON schema, repeated --remote warning) that could move to references/commands.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no padding or explanations of known concepts, but a few details could be trimmed or moved to references: the merge-queue paragraph, the JSON schema block, and the --remote caveat which is stated twice. Anchor 4 (minor instances that could be trimmed) fits; it is not noticeably verbose (3) nor perfectly lean (5). | 4 / 5 |
Actionability | Fully executable guidance throughout: copy-paste bash blocks for the core loop, branch placement, sync, and conflict recovery; an always-run/never-run table with the reason each bare command fails; and a per-exit-code recovery column. Common cases including rebase conflicts are covered. | 5 / 5 |
Workflow Clarity | Sequences are explicit (checkout owner → edit → commit → rebase upstack → top → push) with a validation step ("gh stack view --json # confirm") and full feedback loops: the exit-code table pairs every failure with a recovery command, and Exit 3 has continue/abort paths for both rebase and sync. The destructive/batch cap does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | A lean overview with three verified, one-level-deep references, each carrying an explicit read-when trigger ("read before creating a stack", "read when a command fails unexpectedly", "read on a rebase conflict") plus the guidance to open only the matching one. This trigger-based navigation matches or exceeds the anchor-5 example. | 5 / 5 |
Total | 19 / 20 Passed |