Content
28%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 well-sectioned but hollow shell: generic template instructions, no domain-specific content, no code or commands, and a dangling reference to a playbook file that does not exist in the bundle. Almost all substantive guidance is missing, and what remains is boilerplate filler.
Suggestions
Replace the generic Instructions bullets with concrete, domain-specific guidance: example pytest commands, fixture patterns, and mocking snippets that are copy-paste ready.
Fix the dangling reference: either create 'resources/implementation-playbook.md' with the promised detailed patterns and examples, or remove the reference since no resources directory exists in the bundle.
Define an actual testing workflow with sequenced steps and validation checkpoints (e.g., write failing test → run pytest → implement → re-run until green), and cut the vacuous 'Do not use' bullet and description-restating intro.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and does not explain concepts Claude already knows, but it contains padded filler: an intro that restates the description, a vacuous 'Do not use' bullet ('You need a different domain or tool outside this scope'), and generic template instructions ('Clarify goals, constraints, and required inputs') that add no domain value. Not level 2 because the total volume is small and there is no concept over-explanation; not level 4/5 because a meaningful fraction of the tokens are boilerplate that earns no place. | 3 / 5 |
Actionability | The Instructions section is entirely generic template text — 'Apply relevant best practices and validate outcomes', 'Provide actionable steps and verification' — with no code, commands, pytest specifics, or concrete steps anywhere. This matches anchor 1 ('entirely vague or abstract; only describes rather than instructs'); it is not level 2 because even high-level domain-specific hints are absent, and the one pointer to concrete material ('open resources/implementation-playbook.md') targets a file that does not exist in the bundle. | 1 / 5 |
Workflow Clarity | The three instruction bullets imply a rough sequence (clarify goals → apply practices → validate outcomes), matching anchor 2's 'rough sequence present but many gaps; steps poorly defined; validation absent'. It is not level 1 because some sequenced structure exists, and not level 3 because the steps are vacuous templates with no domain-specific checkpoints (e.g., run pytest, interpret failures, achieve green suite). | 2 / 5 |
Progressive Disclosure | Sections are well-organized (Use when / Do not use / Instructions / Resources) and the single reference is clearly signaled and one level deep, but the referenced file 'resources/implementation-playbook.md' does not exist — the bundle contains no resources directory at all — so the promised navigation dead-ends. Not level 4/5 because progressive disclosure fails against the actual (empty) bundle structure; not level 2 because the body itself is not a monolith and the reference is not buried. | 3 / 5 |
Total | 9 / 20 Passed |