Content
37%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 token-efficient and well-sectioned but fails on actionability and workflow clarity because its instructions are generic abstract directives with no concrete code, commands, sequence, or validation steps, and its sole resource reference points to a file that is not present in the bundle.
Suggestions
Replace the abstract instruction bullets with concrete, executable guidance: example pytest fixtures, a parameterize decorator snippet, and a mock usage pattern.
Define a real sequenced workflow (e.g., 1. write failing test -> 2. run pytest -> 3. implement -> 4. re-run until green) with an explicit validation checkpoint.
Create the referenced resources/implementation-playbook.md file (or remove the dangling reference) so progressive disclosure points to real material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient with no padding or explanations of concepts Claude already knows (no 'what is pytest' prose); every section earns its tokens assuming Claude's competence. | 5 / 5 |
Actionability | The Instructions section offers only abstract directives ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices and validate outcomes') with no concrete code, commands, or examples, matching the score-1 anchor of describing rather than instructing. | 1 / 5 |
Workflow Clarity | The four instruction bullets are parallel directives with no sequence, no validation checkpoints, and no feedback loops, matching the score-1 anchor of steps being missing or incoherent. | 1 / 5 |
Progressive Disclosure | Section structure is clear (Use when / Don't use / Instructions / Resources) with a one-level reference to resources/implementation-playbook.md, but that referenced file does not exist in the bundle and the generic instructions are content that should live in the referenced playbook, fitting the score-3 anchor. | 3 / 5 |
Total | 10 / 20 Passed |