Content
100%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 a dense, fully executable review procedure: exact git/gh/python commands, a concrete argument-to-diff table, explicit per-pass briefs, a mandatory verification step with decision rules, and a fixed report format. Structure and validation are exemplary; there is nothing material to improve.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean procedural instruction with no conceptual padding: 'Run `git fetch origin` first so the base is current. Stop here if the ref does not resolve or the diff is empty.' Every sentence instructs and assumes Claude's competence, matching the anchor where every token earns its place; there is no over-explanation to trim for a 4. | 5 / 5 |
Actionability | Fully executable guidance throughout: exact commands ('git diff origin/main...HEAD', 'git worktree add', 'gh pr checkout <n>', 'python3 scripts/ai-context.py pull-requests', 'gh issue view <n>'), an argument-to-diff mapping table, and a copy-paste report template. Specific instructions cover the common cases (empty args, ref, PR number, path), matching the top anchor. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with explicit validation: a dedicated verification step with decision rules (CONFIRMED / PLAUSIBLE / Dropped), an early stop condition for unresolvable refs or empty diffs, and a fix feedback loop ('add a failing test first for each correctness fix, rerun the narrowest check that proves it'). This matches the anchor with explicit validation steps, feedback loops, and a checklist-style report format. | 5 / 5 |
Progressive Disclosure | A single self-contained file with clear section headers, no nested references, and nothing that belongs in a separate file — the five pass briefs are one-line descriptions that correctly stay inline, and no bundle files exist to point to. Content is appropriately placed in one level with easy navigation, matching the top anchor. | 5 / 5 |
Total | 20 / 20 Passed |