Content
65%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-structured, token-efficient overview that correctly pushes implementation detail into a real one-level reference file. Its weaknesses are thin in-body actionability — no executable measurement commands despite a Check section — and an only-implicit workflow with no post-fix verification step.
Suggestions
Add one executable measurement command to the 'Check' section, e.g. a DevTools console snippet like document.querySelectorAll('*').length or the Lighthouse 'DOM size' audit name, so the check can be run without opening the reference file.
Make the Check → Fix → Verify sequence explicit (e.g. numbered steps) and add a post-fix re-measurement step to confirm the node count and depth are back under thresholds.
Trim the duplicated performance-impact explanation: the intro sentence and the 'Explain' section restate the same memory/rendering rationale; keep one.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with concrete thresholds ('Keep total DOM nodes below 1,500', 'maximum depth < 32'), but the intro sentence ('An excessive DOM size increases memory usage, slows down style calculations...') explains a concept Claude already knows and the 'Explain' section restates it ('Explain the performance impact of a large DOM tree on memory and rendering speed') — minor trimmable padding per anchor 4 rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Provides concrete thresholds, named tools ('Lighthouse or Chrome DevTools'), and specific fix directions ('Simplify the HTML structure, remove unnecessary wrapper elements, and implement virtualization'), but includes no executable commands in the body — no DevTools snippet or script for measuring node count/depth — and defers the actual how-to entirely to references/rule.md, matching anchor 3 (missing key details) rather than anchor 4 (concrete code or commands present). | 3 / 5 |
Workflow Clarity | An implicit Check → Fix → Explain sequence exists with a pre-fix measurement checkpoint, but there is no post-fix re-measurement to confirm improvement and the sequence is conveyed by section order rather than explicit steps, fitting anchor 3 ('checkpoints missing or implicit'). | 3 / 5 |
Progressive Disclosure | The body is a concise overview that cleanly splits deep content (code examples, framework-specific guidance) into a single real, one-level-deep, clearly signaled reference ('see references/rule.md', verified to exist), matching anchor 5's clear overview with well-signaled references. | 5 / 5 |
Total | 15 / 20 Passed |